Models

In this section of the core concepts, we will explore the Models, the core grouping mechanism of the engine. The editor allows the user to group voxels into different groups called Models, which lets you decide their rendering order, transform pose, and apply effects to a specific group.

What a model holds

A model is a named container of voxels plus the settings that control how it appears in the Scene:

• Name — shown in the scene tree and used as the export filename.
• Position & Rotation — the model’s transform pose within the scene (Vector3).
• Visibility — toggle the model on or off without deleting it.
• Materials — the palette of colors/materials its voxels reference.

Voxels inside a model store a material id rather than a raw color, so editing a material recolors every voxel that uses it at once.

Why group into models?

Splitting a creation into models keeps it organized and editable: you can pose, hide, recolor, or export each part independently. The agentic generator uses this deliberately — it builds into named layers and models rather than one undifferentiated blob, so the result is structured and easy to refine.