Reference › Troubleshooting
Troubleshooting
Common problems and how to fix them. (Expand with real cases as they come up.)
Import
- Mesh imports with holes or fails — check the file isn't corrupt and that faces aren't extreme n-gons; re-export triangulated if needed.
- Nothing to paint on / black model — the mesh likely has no UVs. Unwrap it first.
Baking
- Bake looks noisy / has artifacts — adjust the Cage offset (too small misses detail; too large pulls through nearby geometry). See Baking.
- Bake is slow — supersampling AO/Thickness is expensive. Use per-map anti-aliasing (Normal 2×, the rest Off). See Baking.
- Normals look low-quality — raise the Normal map's anti-aliasing.
Documentation
- Help ▸ Documentation says “not found” — the
docsfolder must sit next to the application executable.
TODO: add real issues + fixes as users report them.