# Quality Guidelines

## Topics

<table data-card-size="large" data-view="cards"><thead><tr><th data-type="content-ref"></th><th></th></tr></thead><tbody><tr><td><a href="#optimise-performance">#optimise-performance</a></td><td>Guidelines for highest quality</td></tr><tr><td><a href="#quality-assurance-testing">#quality-assurance-testing</a></td><td>Recommendations for final review</td></tr><tr><td><a href="ve-guidelines/asset-types-and-collisions">asset-types-and-collisions</a></td><td>How creative method determines collisions</td></tr><tr><td><a href="ve-guidelines/asset-scale">asset-scale</a></td><td>Recommendations for common assets</td></tr><tr><td><a href="ve-guidelines/node-efficiency">node-efficiency</a></td><td>Best practices with visual examples</td></tr><tr><td><a href="ve-guidelines/pivot-point-and-alignment">pivot-point-and-alignment</a></td><td>Making assets easy to create &#x26; place</td></tr><tr><td><a href="ve-guidelines/animation">animation</a></td><td>Tips, name compatibility with behaviours</td></tr><tr><td><a href="ve-guidelines/visual-quality">visual-quality</a></td><td>Colour, shape &#x26; common issues</td></tr><tr><td><a href="ve-guidelines/asset-name-and-description">asset-name-and-description</a></td><td>Optimisation for discovery</td></tr><tr><td><a href="ve-guidelines/manage-files-and-folders">manage-files-and-folders</a></td><td>Prevent conflicts</td></tr></tbody></table>

## Optimise Performance

{% tabs %}
{% tab title="Guidelines" %}

### Minimalist Design

Efficient assets provide Experience creators greater flexibility to add more assets and logic to their creations.&#x20;

As a rule, every asset should be an optimised design. Strive for minimalism and simplicity in shape and add more detail in texture.

{% hint style="warning" %}
**MAXIMUM RECOMMENDATIONS**

The following guidelines are the absolute maximum recommendations for special circumstances in order to prioritise play quality in The Sandbox Game.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Maximum Size:</strong> <br>512 x 512 x 512 voxels</td><td></td></tr><tr><td><strong>Maximum Faces:</strong> <br>5,000</td><td>Face count tends to affect <a data-footnote-ref href="#user-content-fn-1">GPU</a> usage</td></tr><tr><td><strong>Maximum Nodes:</strong> <br>175</td><td>Node count tends to affect <a data-footnote-ref href="#user-content-fn-2">CPU</a> usage</td></tr></tbody></table>

{% hint style="info" %}
Face Count tends to affect your GPU usage. A GPU is a graphics processor built into your computer's graphics card, used to accelerate graphics rendering. It functions side by side with your CPU, or central processing unit.
{% endhint %}

{% hint style="info" %}
Node Count tends to affect your CPU usage. A CPU is the central processor built into your computer's motherboard, which performs basic operations on your device.
{% endhint %}

{% hint style="warning" %}
**CUMULATIVE EFFECTS**\
Nodes, faces, and colliders are constantly calculated in the game engine, so **it is highly recommended to strive for the most efficient design with most voxel art**.

Assets that are intended to be used frequently such as trees should be simpler for a lower cumulative effect on play performance.
{% endhint %}

{% hint style="info" %}
A compound entity rigged in the Animator with no motion keyframes added is calculated as having one node.
{% endhint %}
{% endtab %}

{% tab title="Resources" %}

## Best Practices for Optimal Performance

{% content-ref url="../creative-guides/art-techniques/3d-design/optimize-with-texture" %}
[optimize-with-texture](https://docs.sandbox.game/en/creator/voxedit/creative-guides/art-techniques/3d-design/optimize-with-texture)
{% endcontent-ref %}

{% content-ref url="../creative-guides/art-techniques/3d-design/trim-all-volumes" %}
[trim-all-volumes](https://docs.sandbox.game/en/creator/voxedit/creative-guides/art-techniques/3d-design/trim-all-volumes)
{% endcontent-ref %}

{% content-ref url="../creative-guides/art-techniques/3d-design/create-smooth-angled-lines" %}
[create-smooth-angled-lines](https://docs.sandbox.game/en/creator/voxedit/creative-guides/art-techniques/3d-design/create-smooth-angled-lines)
{% endcontent-ref %}

## When You Need to Revise

If you exceed our guidelines, simplify the geometry of your design without losing your concept.

{% content-ref url="../creative-guides/art-techniques/3d-design/need-to-simplify" %}
[need-to-simplify](https://docs.sandbox.game/en/creator/voxedit/creative-guides/art-techniques/3d-design/need-to-simplify)
{% endcontent-ref %}
{% endtab %}
{% endtabs %}

## Quality Assurance Testing

{% hint style="success" %}
*Ask these questions when testing assets in* **Game Maker:**

* *Does the colour look like you intended, including emissive colours?*
* *Does it look good with all ambient lighting settings (Global Parameters menu)?*
* *Is colour clashing on the same layer (z-fighting), or is there clipping?*
* *Are all animations working correctly?*
* *Are all keyframes closed?*
  {% endhint %}

[^1]: A GPU is a graphics processor built into your computer's graphics card, used to accelerate graphics rendering. It functions side by side with your CPU, or central processing unit.

[^2]: A CPU is a central processor built into your computer's motherboard, which performs basic operations on your device.


---

# 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.sandbox.game/en/creator/voxedit/docs/ve-guidelines.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.
