# Hole Layers

## Overview

Hole Layers enable you to add holes for caves or other structures that should pierce through the landscape by either painting directly in World Creator or importing a bitmap from an external source. 

## Results

<div><figure><img src="/files/q1z0q2Y8PEpoDb8Pmb7I" alt=""><figcaption><p>Putting a cave entry in a mountain</p></figcaption></figure> <figure><img src="/files/g5Tgc0BwRdO9pBLfWunm" alt=""><figcaption><p>Full terrain with the cave</p></figcaption></figure></div>

## Layer Parameters

### Mask Layer Settings

| ![](/files/TqOFxWi2BdBVInLp2wWo) | <ul><li><strong>Show Mask</strong> <br>Shows the mask on the terrain.</li><li><strong>Import/Export</strong> <br>Allows you to import or export the mask.</li><li><strong>Edit</strong> <br>Allows you to edit the mask using brushes.</li></ul> |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

### Area Settings

The Area Settings allow you to freely position Hole Layers on your terrain and offer simple controls to blend them into your terrain.

| ![](/files/Fi7Qpj3knuEvClInyNY9) | <ul><li><strong>X/Y</strong><br>The position of the area on the terrain.</li><li><strong>Area Scale</strong><br>The size of the area.</li><li><strong>Rotation</strong><br>The rotation of the area</li><li><strong>Fit to Terrain</strong><br>Matches the area to the terrains full size.</li><li><strong>Blending</strong><br>Controls the opacity of the whole shape layer.</li><li><strong>Blend Size</strong><br>Adds a fade in to the area.</li><li><strong>Blend Roundness</strong><br>Rounds the corners of the face.</li></ul> |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

## Editing Parameters

These parameters are only available when the hole layer is in **Edit** mode.

### Brush Tools <a href="#brush-tools" id="brush-tools"></a>

Simple paint tools to modify the hole. Choose your preferred tool by clicking on it, and then draw with your mouse (press the left mouse button on the terrain). The following functions are available:

| <ul><li><strong>Paint</strong><br>Adds to the mask.</li></ul>                   | <ul><li><strong>Erase</strong><br>Removes from the mask.</li></ul> |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| <ul><li><strong>Smooth</strong><br>Averages the mask under the brush.</li></ul> |                                                                    |

### Actions

The operations are utilized to rapidly implement precise modifications. Please refer to the list below to understand the function of each operation.

| <ul><li><strong>Flip X</strong><br>Flips the mask along the X axis.</li></ul> | <ul><li><strong>Flip Y</strong><br>Flips the mask along the Y axis.</li></ul> |
| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| <ul><li><strong>Rot Left</strong><br>Rotates the mask by 90°.</li></ul>       | <ul><li><strong>Rot Right</strong><br>Rotates the terrain by 90°.</li></ul>   |
| <ul><li><strong>Clear</strong><br>Sets the whole mask to 0.</li></ul>         | <ul><li><strong>Fill</strong><br>Sets the whole mask to 1.</li></ul>          |

### Brush Settings

<table><thead><tr><th width="199.800048828125">Properties</th><th>Description</th></tr></thead><tbody><tr><td><strong>Brush</strong> </td><td>Allows you to specify several preinstalled brushes as well as import your own custom brushes.</td></tr><tr><td><strong>Falloff Mode</strong></td><td>Offers different brush falloff modes.</td></tr><tr><td><strong>Brush Radius</strong></td><td>The radius of the brush.</td></tr><tr><td><strong>Brush Smooth</strong></td><td>The size of the brush smoothing.</td></tr><tr><td><strong>Brush Strength</strong></td><td>Controls the strength of the current selected brush.</td></tr><tr><td><strong>Rotation</strong></td><td>Rotates the brush pattern.</td></tr><tr><td><strong>Random Rotation</strong></td><td>Adds random rotation to the brush pattern.</td></tr><tr><td><strong>Align to Draw Direction</strong></td><td>Orients the brush pattern to the drawing direction.</td></tr></tbody></table>


---

# 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.world-creator.com/reference/terrain/hole-layers.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.