Components (Beta)

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

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:

  1. With right-click, by selecting “Create Component” from the object context menu
  2. With the shortcut ⇧⌘K

Creating Instances

There are multiple ways to create an instance of the main component:

  1. Duplicate the main component with ⌘D
  2. Copy and paste the main component with ⌘C and ⌘V
  3. ⌘ + 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:

  1. With right-click, by selecting “Detach Instance” from the object context menu
  2. From the Instance Panel, by pressing the detach icon

Instance Overrides

In the 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.

👉 Next Steps

Learn how to add interactions and animations to your scenes with States and Events.

How state-based animation works