Checks before regenerating
| Problem | What to check |
|---|---|
| Generate button disabled | For cloud generation, check credentials. For local generation, check setup. In either case, confirm the mode and required prompt/image input. |
| Offline provider has no text or multi-image mode | This backend supports one-image-to-3D only. Choose Meshy, Tripo3D, or Rodin for text or multiple views. |
| Offline setup or generation fails | Check the panel log, selected WSL distribution, NVIDIA CUDA availability, free disk space, and installed model files. Try preview quality for GPU-memory errors; avoid submitting the same job repeatedly while setup is still working. |
| Offline input needs a transparent foreground | Prepare a foreground cutout as an RGBA PNG with actual transparent background and a clearly visible subject. The revised local path does not load an automatic background-removal model. |
| Unsupported TRELLIS.2 source revision | The installer checks an existing checkout before environment/package changes; the adapter checks the reviewed source files again before generation. Select a separate compatible installation root; do not overwrite a shared installation or remove the revision check. |
| Installation detected but an auxiliary model is missing | Check Setup tests installation files only. Review the DINOv3 terms and obtain its authorized model files before using offline mode; the worker does not download them during generation. |
| Task fails quickly | Check API key, account balance, provider service status, and whether the image meets the provider's input rules. |
| Import finishes but mesh looks untextured | Confirm texture generation was enabled and the provider returned separate texture maps or embedded texture data. |
| History item will not import | Refresh the task first so the tool can request a fresh download URL from the provider. |
| Mesh is not placed in the level | Select or place an AI Mesh Spawn Target before importing if you want automatic placement. |