Enable the plugin
- Open Edit > Plugins.
- Search for Ultimate AI Mesh Generator.
- Enable the plugin and restart the editor if prompted.
- Open Window > AI Tools > AI Mesh Generator, or click AI Mesh in the editor toolbar.
Add provider credentials
- Open Edit > Project Settings.
- Find Ultimate AI Mesh Generator.
- Fill in only the providers you plan to use.
- Save settings, then return to the AI Mesh Generator panel.
- Select the provider and press Test beside the provider dropdown to validate the credentials without starting a generation.
| Provider | Required fields |
|---|---|
| Meshy | API Key |
| Tripo3D | API Key |
| Rodin | API Key |
| Offline (Trellis 2) | No generation-provider API key; local WSL2 environment and authorized cached model files required. Gated auxiliary model downloads can require a Hugging Face account and acceptance of their terms. |
Project settings and import defaults
| Setting | What it does |
|---|---|
| WSL Distro Name | Text; default Ubuntu-24.04. Choose the installed WSL2 distribution that holds the offline environment. |
| Models Root (inside WSL) | Text; default /opt/athian3d/models. The local model is installed in its trellis2 subfolder. |
| Imported asset root | /Game/AI_Meshes is the internal default, not an editable Project Settings field. |
Credentials are stored per project user, so they are not meant to be shared through source control.
Local image-to-3D setup
Prepare Windows with WSL2, an Ubuntu distribution, and an NVIDIA driver with CUDA support inside WSL. Upstream TRELLIS.2 lists at least 24 GB GPU memory. The plugin has memory-saving paths, but a lower-memory configuration is not a verified minimum. The initial installation downloads model weights of approximately 16 GB plus the environment and compiled dependencies. Internet access and additional disk space are required for setup; the installed generation worker is designed to use local model files afterward.
The revised local worker accepts a prepared foreground PNG with transparent RGBA background. It uses an original NumPy UV bake for textured export and does not load an automatic background-removal model. Opaque images receive an input error before model loading. Before creating a virtual environment or installing Python packages, the installer checks any existing TRELLIS.2 checkout against the reviewed revision and source hashes. A mismatch stops setup and leaves that installation unchanged; choose a separate compatible installation root.
Dependency terms: legacy installations can contain nvdiffrast and BRIA RMBG-2.0 weights with non-commercial restrictions. The revised foreground/export path avoids using these components; it does not change their licenses or remove them from a shared installation. The image encoder still uses Meta DINOv3 terms, and its authorized model files must be cached for offline use. TRELLIS.2's MIT license does not replace other component terms.
The revised worker remains a release candidate awaiting end-to-end GPU generation and textured-import validation. Component tests and successful setup-file detection do not certify that workflow or establish blanket commercial-use clearance.
- In Edit > Project Settings > Plugins > Ultimate AI Mesh Generator, set WSL Distro Name and Models Root (inside WSL) for your environment.
- Open the AI Mesh Generator panel and select Offline (Trellis 2).
- Click Check Setup. A missing distribution must be set up before continuing.
- After reviewing the dependency terms, use Install (one-time download) if the panel reports that the model is missing. Watch the progress and log panel; installation can take time.
- Click Check Setup again. This detects the installation files; it does not test dependencies, auxiliary model caches or GPU generation. Confirm the dependency terms and cached DINOv3 model before attempting local generation.