Components are objects that can be reused multiple times throughout your scene and whenever there are changes made to the main component all instances will update accordingly.
Components will help you stay organized and consistent by allowing you to create a design system you can reuse across your scene.
🍀 Main Component
The main object that all instances will refer back to and where you can make changes to update all instances.
☘️ Instances
For objects whose properties are connected to the main component, any changes made on the main component will be reflected on the instances unless there have been overrides made to some properties.
Creating a Component
There are two ways to create a new component:
- By right-clicking and selecting “Create Component” from the object context menu
- With the shortcut ⇧⌘K
Creating Instances
There are multiple ways to create an instance of the main component:
- Duplicate the main component with ⌘D
- Copy and paste the main component with ⌘C and ⌘V
- ⌘ + Drag the main component to a different location
Detaching Instances
Detaching an Instance turns it into a normal object, meaning that it will no longer refer back to the main component and any changes on the main component will not be reflected on that object anymore.
There are two ways to detach an instance from the main component:
- By right-clicking and selecting “Detach Instance” from the object context menu
- From the Instance Panel, by pressing the detach icon
Instance Overrides
In an instance, it is possible to override object properties like Transform, Geometry Resize, Material, Events, etc.
Reset Instance Overrides
From the Instance Panel, it is possible to Reset Overrides made to the Instance root or child objects of that Instance.
From the Instance root:
- Reset Object Overrides → Resets overrides made on the Instance root (currently only physics properties)
- Reset All Overrides → Resets all overrides made on the root and all child objects of that Instance, making it look exactly like the main component again.
- Push Changes to Main → Pushes all the overrides made on the Instance to the Main Component.
From child objects of an Instance:
- Reset Object Overrides → Resets all overrides made only on the selected object. If that object has child objects or is a group, the child objects will not be reset.
- Reset All Overrides → Resets all the overrides made on the selected object and its child objects, making it look exactly like on the main component again.
- Reset individual properties like Transform, Geometry, Material, etc.
Component Swapping
From the Instance Panel, the instance dropdown allows you to swap between different components present in your scene.
Component Variations
A great way to add versatility to your main component is by creating object variations that can be toggled visible/hidden based on what you want to show on your instances.
You can do this by creating different elements on your main component and hiding all the extra variations.
In your instances, you can now toggle visible/hidden variations to create different versions from your main component. While still keeping the connection to any changes made to the object variations made on the main component.
