# 3D Models

Unit owners can upload custom 3D models to their plots as long as they meet the Carda Station Compatible Assets specifications.

The Carda Staiton Viewer will be updated to preview your builds.

{% hint style="info" %}
Please note that the requirements and specifications listed in this document are subject to changes as we continue to develop and test 3D assets within Carda Station.
{% endhint %}

### Model Requirements

#### Animations

All animations should be embedded into the glb file.

By default, only the first animation will play.  Multiple animations can be combined into one when exporting to the binary glb file format (.glb).  In Blender, this is accomplished through assigning the same group name in the Non-Linear Animation editor.

**Unity Specific Mesh Naming**

Meshes can be named in such a way that a corresponding action will be added to the object when imported into Unity.  A mesh name listed below with an "\*" on the end means that multiple meshes can be named with the prefix, with an unique suffix added to each mesh. 

The following actions can be assigned to a mesh by assigning the corresponding name:

<table><thead><tr><th width="150">Category</th><th width="160">Mesh name</th><th>Action</th><th>Trigger</th></tr></thead><tbody><tr><td>Website</td><td>web_interaction</td><td>Users will be shown the website url and given the option to visit</td><td>Avatar presence within 1 meter.</td></tr><tr><td>Information</td><td>note_interaction</td><td>Users will be shown the custom note </td><td>Avatar presence within 1 meter.</td></tr></tbody></table>

#### Camera

Cameras are not allowed as these interfere with the player's camera. Ensure any camera is deleted.

#### File Type

The 3D Model will need to be a binary GLTF file format (.glb). The glb version is smaller in size compared to the gltf version and will allow for faster downloads and rendering.

#### Lightning

Lights are currently not supported. You can use materials with emissions instead.

#### Materials

Supported shaders are PBR Metallic-Roughness, PBR Specular-Glossiness and Unlit.

#### Orientation

To help align the rotation of your model in the world, use the following to map your positions to the unit.\
Y- = Unit Entrance\
X- = East of Entrance\
Y+ = South of Entrance\
X+ = West of Entrance

#### Positioning

The model should be positioned at the centre of the 3D application at (0,0,0). Do not build out from position (0,0,0) but rather ensure the centre of your model is positioned at (0,0,0).

#### Scale

Ensure models are scaled correctly and fit within the unit's boundaries.&#x20;

#### Textures

Texture size should not exceed 1024 by 1024 pixels. Color depth should be no more than 8-bit if PNG, or Quality Level 6 if JPG.  All textures should be embedded onto the glb file.&#x20;

Preloaded default textures will be added to the player's clients for faster rendering. These will be shared when made available.

### Scene Limitations

Each unit can use 2 meters of space in front of the entrance.

Each unit with space above can use up to 5 meters of the height above the roof of the unit.

<table><thead><tr><th width="150">Unit Size</th><th width="150">File Size Limit (mb)</th><th width="150">Dimensions (meters)</th><th width="150">Meshes</th><th width="150">Triangles</th><th width="150">Materials</th><th>Textures</th></tr></thead><tbody><tr><td>Small</td><td>15</td><td>10 x 10</td><td>30</td><td>20K</td><td>15</td><td>5</td></tr><tr><td>Medium</td><td>25</td><td>10 x 20</td><td>60</td><td>40K</td><td>25</td><td>10</td></tr><tr><td>Large</td><td>35</td><td>10 x 40</td><td>90</td><td>60K</td><td>35</td><td>20</td></tr></tbody></table>

### Scene Examples

<figure><img src="/files/tbaiceQLdLY83shTvwex" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cardastation.com/home/scenes/community-hub-units/create-custom-scenes/3d-models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.