# Unity Add-on
## Version
Release 0.6.0 — Dec 05 2025
## About
With this package, users can:
* Enter Text or Image Prompts to generate **3D Gaussian Splats (3DGS)** and **Mesh FBX Models**.
* Display **3D Gaussian Splat** assets inside Unity.
* Apply **cutouts**, **colliders** and **shadows** to **3D Gaussian Splats**.
* Import and Export **.ply** files.
* Convert **3DGS** to **Mesh**.
## Installation
### Software requirements
Unity 2022.3+
### Instructions
{% hint style="danger" %}
Previous Release must be removed before Installing Latest Release.
{% endhint %}
#### 1. From the [Unity Asset Store](https://assetstore.unity.com/packages/slug/311107) click "Add to My Assets"
#### 2. Download the Package
* In Unity, create a new 3D Project or open and existing one.
* Go to **My Assets**.
* Select **404—GEN** from the list.
* Click **Download**.
#### 3. Install the Package
* After the package has been downloaded click **Import**. When the import Window Appears, keep all files selected and click **Import**.
#### 4. Restart Unity
* **Please restart Unity before using the Plugin.**
Make sure the rendering backend is now set to
* Directx 12 on Windows.
* Metal on Mac OS.
* Vulkan on Linux.
## Usage
### Generating
1. Go to **Window > 404-GEN 3D Generator** to open the generation window.
2. Type your **Text Prompt** or Import your **3D Image Prompt** and click **Generate**. Each generation should take **1 to 2 minutes**.
The 404-GEN 3D Generator window tracks the progress of generating the models for prompts. Once the prompt has been enqueued, it waits on the backend to complete the generation.#
Generation process changes states from [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/pending.png) Started to [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/complete.png) Completed or [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/failed.png) Failed.
Use available action icons to:
* [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/close.png)cancel active prompt entry
* [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/hidden.png) or [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/visible.png) show or hide created Gaussian splat model
* [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/target.png) select generated model in Scene view and Inspector window
* [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/retry.png) resend failed or canceled prompt
* [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/logs.png)**LOGS** show log messages in a tooltip
* [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/delete.png) delete prompt entry
* [](https://github.com/404-Repo/404-gen-unity-plugin/blob/asset-store/Editor/Images/settings.png) open Project settings for this package
### Prompts
For help structuring prompts, visit the Prompts section of this guide:
{% content-ref url="../prompts" %}
[prompts](https://guide.404.xyz/user-guide/prompts)
{% endcontent-ref %}
### Transformations
In addition to the Position, Rotation, and Scale values in the Inspector, there are two easily adjustable values.
* **Splat Scale:** Controls the size of the points, represented by ellipsoids, in the Gaussian Splat
* **Opacity Scale:** Points within Gaussian Splats have varying degrees of opacity. This increases or decreases the opacity of all points.
### Cutouts
The cutouts feature can be used to hide a selection of points within the Gaussian Splat, defined by either a box or ellipsoid.
Create a cutout for a selected Gaussian Splat by clicking **Add Cutout** under the Cutouts heading of the Inspector.
Add cutouts
Select a shape and move/scale/rotate as needed.
By default, only the points **inside** the cutout will be rendered. Select **invert** to render the points **outside** the cutout.
Inverted Ellipsoid cutout applied to a Gaussian Splat
### Mesh Collider
The **Add Mesh Collider** button in the Inspector will add a convex hull mesh collider.
Model with mesh collider
### Shadows
Like the mesh collider, the **Add Shadow** button in the inspector adds an invisible convex hull mesh to the Gaussian Splat. The shadow it casts lacks any fine details, however the convex hull's low poly count makes it very lightweight.
Gaussian Splat with shadow applied
### Convert to Mesh
The **Convert to Mesh** button will open a Mesh Conversion window with input field (for Gaussian Splat component), file output folder location, conversion settings, reference fields for files that are created in the process (.ply and .mesh files), as well as the reference field for the game object that will be created and placed in current scene (Instance).
Mesh conversion window
The sliders adjust the level of detail on the mesh output.
Once the **Start conversion to Mesh** button is used the process will start populating the object fields as they are created. The process takes approximately **one minute** to convert the Gaussian Splat (PLY) to mesh (FBX).
### Import/Export .ply
The Gaussian Splat can be exported in .ply format using the **Export PLY** button.
.ply files can be imported by adding them to the project's Assets folder and the scene.
A large collection of Gaussian Splatting .ply files is available in the [404 Dataset](https://dataset.404.xyz/).
## Gaussian Splats
To learn more about 3DGS (3D Gaussian Splatting), visit the Gaussian Splatting section of this guide:
{% content-ref url="../3d-gaussian-splatting-3dgs" %}
[3d-gaussian-splatting-3dgs](https://guide.404.xyz/user-guide/3d-gaussian-splatting-3dgs)
{% endcontent-ref %}
