Model component
The Model component loads 3D models in glTF or GLB formats into your scene. This is the primary way to bring 3D content into scenes. Models can also reference prefabs, which are themselves glTF files, allowing for complex and reusable content structures.
Additionally, the Model component provides options to automatically apply colliders and rigid bodies, allowing models to interact with the physics system without additional manual setup.
Property | Description |
|---|---|
Model Url | The file path or URL to the 3D model (glTF or GLB file). You can drag and drop assets directly onto the URL field to load them into the entity. |
Occlude camera | Determines whether the model should be culled when not in view. When enabled, the model is not rendered when outside the camera’s view, improving performance. It is recommended to leave this on unless working with instanced geometry. |
Apply Colliders | Adds a merged Collider component to the model, automatically wrapping the mesh in a default Box Collider. The collider can be adjusted. Prompts the user to Add a Rigidbody if none is present. |
Add RigidBody | *Only visible when Apply Colliders is enabled. Adds a Rigidbody component to the model, allowing it to interact with physics-based movement and collisions. |
Export settings | Options for exporting modifications made to the model in the scene back to a glTF or GLB file. This option allows saving modifications or creating prefabs from the model, including nested objects. |
- Saving changes: After modifying a model in the scene, changes can be saved back to the original file using the Save button in the hierarchy panel.
- Creating prefabs: Right-click on an entity and select the Create prefab option to create a new prefab file from the current model and its modifications. Prefabs reference the original model file and include any changes you've made.
⚠️ References vs. copies
Be aware that creating prefabs creates a reference to the original model. If you modify the original model file, those changes will propagate to all prefabs referencing it.
To create independent copies, use the Export settings to save the model under a new name.
- Colliders and Rigidbodies: Enabling Apply Colliders and Apply Rigid Body automatically assigns these components, but they can be adjusted or removed manually.
- Instanced geometry: If working with instanced geometry, disabling Occlude Camera may be necessary to ensure proper rendering.
- File overwriting: Using the Save function overwrites the existing model file, replacing it with the modified version in the project.
- Prefab system: The Export settings can be used to generate standalone copies of models, separate from prefabs.
