> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lightcraft.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Objects

> Add default or USD objects to a 3D scene, then move, rename, replace or remove them.

Objects are the USD models you place in a location: props, vehicles and characters. Each object belongs to a setup, and shows under that setup in the Outliner.

![The scene editor with the P5 bike object selected in the hall. Box 1 is on the move, rotate and scale buttons, 2 on the object's row in the Outliner, 3 on Remove from Scene, 4 on Name and 5 on the Replace and settings buttons.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scene-editor/object-selected.jpg?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=9913fe75e6daf32e1bddbbf95de8b769)

1. Gizmo: **Position**, **Rotation**, **Scale**
2. Object row, under its setup and kind
3. **Remove from Scene**
4. **Name**
5. ↻ **Replace with another file**, ⚙ file settings

## Add an object

### 1. Open the object library

On the setup's row in the Outliner, click **Add an object to this setup** (the cube). The Asset Library opens on **Objects**.

![The Outliner with a box on the cube button of the Base Setup row.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/add-object.jpg?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=cf0c2de22a4f127bc7404fe9f28f05e9)

### 2. Pick an object

Hover an object, then click **Add to Scene**. The library closes.

![The object library open on Objects. The pointer is on the Motorcycle card, with a box on its Add to Scene button.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/add-object-card.jpg?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=0c877f3c222ce0a7d8958add4856a171)

### 3. Place it

Spark says **Click on canvas to place object. Press Esc to cancel.** Click where it goes in the 3D canvas.

![The empty 3D canvas with a box on the message Click on canvas to place object. Press Esc to cancel.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scene-editor/place-object.jpg?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=50c12323a1bf1e59caa2f4a55c09e9d4)

## Prepare USD objects

Upload your own object with **Add to Library**. The **Object Settings** window asks for a subcategory and a name, and detects the up axis.

![Object Settings for an uploaded USDA file: Step 1 with Subcategory Prop and the name, Step 2 detecting Y-Up, and a box on the warning Scale hasn't been adjusted, with Let me check and Add it anyway.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scene-editor/scale-warning.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=ee479f94ed9abc62277b0dc7a5ae6a80)

* **Step 2** reads the file's up axis, such as **Detected: Y-Up**. Tick **Invert Up** or **Z-Up** if the preview is upside down or on its side.
* If you leave the scale as it is, Spark asks **Scale hasn't been adjusted. Are you sure it's right?** Click **Let me check**, or **Add it anyway**.

> [!WARNING]
>
> Export every model as a mesh. Spark doesn't render USD shapes such as Cube or Sphere. It also ignores `displayColor`, so put color in a USD material.

## Move, rotate or scale

Select the object, then drag the gizmo in the 3D canvas. Switch the gizmo's mode with the buttons at the top right of the canvas.

![The 3D canvas with the P5 bike selected. Boxes 1 to 3 are on the three gizmo buttons at the top right: move, rotate and scale.](https://mintcdn.com/lightcraft/pm0on6iM7wuwWTJD/images/spark/scene-editor/gizmo-buttons.jpg?fit=max\&auto=format\&n=pm0on6iM7wuwWTJD\&q=85\&s=5d8dc2beb4b137b135a568dc35dbe95d)

1. **Position**
2. **Rotation**
3. **Scale**

| Button | Shortcut |
| - | - |
| **Position** | **Ctrl+1** |
| **Rotation** | **Ctrl+2** |
| **Scale** | **Ctrl+3** |

To enter exact values, use **Position**, **Rotation** and **Scale** in **Object Properties**. Press **Enter** or **Tab** after each value.

## Rename, replace or remove an object

* **Rename:** change **Name** in **Object Properties**. The Outliner and Timeline update.
* **Replace:** click ↻ **Replace with another file**. The library opens with **Replace** on each card. The object keeps its place and takes the new file's name.
* **Hide:** hover the object's row, then click the eye. The row turns dim. Your choice stays after a reload.
* **Remove:** click **Remove from Scene**, then **Remove**. The object leaves the scene and every setup. Its file stays in the library, and **Ctrl+Z** brings it back.

The trash on the object's row does the same as **Remove from Scene**.

![The P5 bike row in the Outliner. Box 1 is on its eye, 2 on Replace file and 3 on the trash.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scene-editor/object-row-buttons.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=ac708544dd500f58a7d7c40a3ee01237)

1. Hide
2. **Replace file**
3. Delete

![The Remove from Scene window: This will remove P5 bike from the scene and every setup. The file will remain in your library. Cancel, and a box on Remove.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scene-editor/remove-object.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=e7425fd15b70711592833a7fcf0b664c)

Objects can't be parented to other objects. Only a camera can follow an object. See [Parent to an object or part](https://docs.lightcraft.pro/spark/setups-cameras/cameras.md#parent-to-an-object-or-part).

> [!NOTE]
>
> ⚙ on the asset row edits the file in the library. The change applies to new placements only. Objects already in a scene keep their settings.

## Related

> [card] [Parts of an object](https://docs.lightcraft.pro/spark/scene-editor/parts-of-an-object.md)
>
> Select and change one part of an object.

> [card] [Asset Library](https://docs.lightcraft.pro/spark/scene-editor/asset-library.md)
>
> Upload your own objects.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.