> For the complete documentation index, see [llms.txt](https://docs.airship.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airship.gg/core-package/voxelworld/voxel-world-getting-started.md).

# Voxel World Getting Started

How to setup a voxel world and our suggested best practices

## Creating a Voxel World

VoxelWorld is a component that you will place on a GameObject. To have a Voxel World you will need several components.

<figure><img src="https://214663474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbaXflSJA8L9N9yOx089%2Fuploads%2FpZQS9psmOh5iPflpIiw1%2Fimage.png?alt=media&amp;token=ebab8d17-1fb7-4384-b123-d2b4dec68792" alt=""><figcaption></figcaption></figure>

* Voxel World - This is the main component that provides the main editor tools for creating a voxel world
* Voxel Blocks - Points to the data for your voxels
* Voxel World Networker - Handles syncing the voxels from server to clients
* Network Identity - Standard ID component for any networked object

{% hint style="info" %}
VoxelWorldNetworker and NetworkIdentity are both only needed if this is a networked voxel world. If you just want to draw something locally they are not needed.&#x20;
{% endhint %}

## Saving the Data

The world data is saved into an object in your project called a WorldSaveFile. In your VoxelWorld component you can select the save file you want, load, and save edits.&#x20;

You can create a new save file in the project by right clicking and choosing:\
`Create/Airship/VoxelWorld/VoxelWorldSaveFile`

## Drawing Blocks

To edit blocks, click the Open Editor button on the VoxelWorld component. This opens a window that you should dock somewhere convenient. The editor lets you switch between voxel worlds, select block types, and access the tools panel.

<figure><img src="https://214663474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbaXflSJA8L9N9yOx089%2Fuploads%2FNVvveQMDahhxwZ3t3lL9%2Fimage.png?alt=media&amp;token=71e9b2fa-e482-46c5-9233-b37ec639df4b" alt=""><figcaption></figcaption></figure>

Tools will show up in your scene view for extra functionality

<figure><img src="https://214663474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbaXflSJA8L9N9yOx089%2Fuploads%2FSemdIfSeAvqzQgVNdhZ6%2Fimage.png?alt=media&amp;token=6cc303fd-9094-4226-aca0-bee672575e89" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Be sure to save your work after you are done editing!&#x20;
{% endhint %}
