> For the complete documentation index, see [llms.txt](https://docs.fullscreen.no/info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullscreen.no/info/standalone-assets/runtime-studio/plugins/terrain-editor.md).

# Terrain Editor

## Runtime Studio Terrain Getting Started

This guide shows the fastest way to get the Terrain plugin working.

### 1. Install the Terrain plugin

Import both:

* Runtime Studio
* Runtime Studio Terrain Editor

The Terrain Editor requires the Runtime Studio base package.

### 2. Add Runtime Studio to a scene

1. Add `RuntimeStudioEditor` to a GameObject in your scene.
2. Assign a `RuntimeStudioSettings` asset.
3. Open the Runtime Studio Settings window and make sure the Terrain plugin is enabled.

### 3. Configure Terrain settings

Open:

`Tools > Fullscreen > Runtime Studio > Settings`

Select the **Terrain** plugin from the sidebar.

Configure the assets you want available at runtime.

#### Terrain Material

The material assigned to newly created runtime terrains.

#### Default Terrain Layer

The terrain layer automatically applied to new terrains.

Setting this allows new terrains to be painted immediately.

#### Terrain Layers

The terrain textures that players can paint.

#### Grass Details

Grass and detail textures available for painting.

#### Detail Meshes

Mesh-based terrain details available for painting.

#### Tree Prefabs

Tree prefabs available in the Trees tool.

#### Brush Textures

Optional brush masks used by terrain brushes.

You can drag individual assets, multiple assets, or entire folders into these lists.

### 4. Enter Play Mode

Terrain editing only happens while the game is running.

Press **Play**, then open Runtime Studio.

### 5. Open Terrain Mode

Click the **Terrain** button in the Runtime Studio toolbar.

When Terrain Mode opens:

* the Terrain panel appears
* the Inspector panel is hidden
* transform tools are disabled
* brush settings return to their default values

### 6. Create a terrain

There are two ways to create a terrain.

#### Terrain panel

If no editable terrain exists, click **Create Terrain**.

#### Hierarchy

Right-click inside the Runtime Studio Hierarchy and select:

`3D Object > Terrain`

Choose:

* name
* width
* height
* length
* heightmap resolution
* alphamap resolution
* detail resolution

### 7. Select a tool

The Terrain Editor includes the following tools:

* Raise
* Flatten
* Smooth
* Texture
* Details
* Trees
* Erase
* Cut Trees
* Cut Holes
* Fill Holes

Each tool has its own settings depending on the selected mode.

### 8. Adjust the brush

Most tools support the same brush settings:

* Radius
* Strength
* Falloff
* Brush Texture

Experiment with different brush sizes and strengths to achieve smoother results.

### 9. Paint textures

To paint textures:

1. Add Terrain Layers in the Terrain settings.
2. Open the **Textures** tool.
3. Select a terrain layer.
4. Paint directly onto the terrain.

### 10. Paint grass and details

To paint grass or detail meshes:

1. Add Grass Details or Detail Meshes in the Terrain settings.
2. Open the **Details** tool.
3. Select the detail to paint.
4. Adjust the density.
5. Paint onto the terrain.

Detail meshes use GPU instancing by default where supported.

### 11. Paint trees

To paint trees:

1. Add Tree Prefabs in the Terrain settings.
2. Open the **Trees** tool.
3. Select a tree.
4. Adjust the density and random scale.
5. Paint onto the terrain.

### 12. Create neighbouring terrains

Open the **Neighbours** section while a terrain is selected.

You can create new terrain tiles to the:

* North
* South
* East
* West

Neighbour terrains connect automatically, making it easy to build larger worlds.

### 13. Edit multiple terrains

Select multiple terrains in the Hierarchy to add:

* Terrain Layers
* Grass Details
* Detail Meshes
* Tree Prefabs

to all selected terrains at the same time.

### 14. Save your terrain

Terrain data is fully integrated with Runtime Studio.

Terrain edits are automatically included when using:

* Save
* Load
* Export
* Import
* Undo
* Redo

No additional setup is required.
