Troubleshooting

Most issues fall into one of the categories below. If none of these solve it, see Contact & support.

My file was rejected

Cause	Fix
No base-colour texture	Add an image-based base-colour texture before uploading
Coloured with vertex data only	Vertex colours aren't textures — bake to a texture map
Textures referenced externally (URI/file path)	Embed textures in the file, or bundle them (see below)
FBX zip not following the naming convention	Name the base-colour map game.color.png, color.png, albedo.png, basecolor.png or base_color.png
A material with no texture	Make sure every material has a base-colour texture

Full rules: 3D file support.

My results don't look right

• Check the input first. Marso Studio enhances materials but can't fix bad geometry, overlapping UVs, or a poor scan.
• Remove any existing PBR. Bring a clean, base-colour asset — assets that already carry PBR work against the prediction.
• Flat-shaded AI assets predict poorly. Generative meshes work best when shading and lighting cues are baked into the base colour.
• Complex geometry can produce coverage artefacts on some surfaces — try a cleaner or simpler asset to compare.

See Sourcing & preparing assets.

It looks wrong in the viewer

The web viewer is still being refined during early access. If a result looks off in the viewer, download and check the exported maps before assuming the generation failed.

Generation failed or timed out

• Keep files under 100 MB.
• Run one generation at a time during early access.
• Retry once — if it fails again, grab a screenshot of any error and contact us.

---

Still stuck? → Contact & support