Version: 2023.1
Language : English
Raise or Lower Terrain
Paint Texture

Paint Holes

Use the Paint Holes tool to hide portions of your TerrainThe landscape in your scene. A Terrain GameObject adds a large flat plane to your scene and you can use the Terrain’s Inspector window to create a detailed landscape. More info
See in Glossary
. It allows you to paint openings in the Terrain for formations such as caves and cliffs.

To access the tool, click the Paint Terrain icon, and select Paint Holes from the drop-down menu.

Paint Holes tool in the Terrain Inspector
Paint Holes tool in the Terrain Inspector

To access Paint Holes from an overlay:

  1. In the Terrain Tools overlay, select Sculpt Mode Sculpt Mode Menu. Sculpt Mode tools display at the end of the Terrain Tools overlay.
  2. From the available Sculpt Mode tools on the Terrain Tools overlay, select Paint Holes Paint Holes button.

To paint holes, click and drag the cursor across the Terrain. To erase holes from the Terrain, click and drag while holding down the Shift key. Use the Brush Size slider to control the size of your tool. The Opacity slider determines the strength of the Brush when you apply it to the Terrain.

Internally, Unity uses a Texture to define the opacity mask for a Terrain surface. When you use the Paint Holes tool to paint on a Terrain, it modifies this Texture. Thus, any holes you paint are visible only if the Terrain Material you use clips or discards texels based on this mask.

Because this tool uses a Texture, you might see aliased edges surrounding holes you paint. Therefore, for example, when you make a cave, you might choose to hide the aliased edges of the hole with other geometry such as rock meshes.

Terrain holes work with lighting, physics, and NavMeshA mesh that Unity generates to approximate the walkable areas and obstacles in your environment for path finding and AI-controlled navigation. More info
See in Glossary
baking. Unity discards the Terrain information in areas where you paint holes to ensure accurate lighting, Terrain CollidersAn invisible shape that is used to handle physical collisions for an object. A collider doesn’t need to be exactly the same shape as the object’s mesh - a rough approximation is often more efficient and indistinguishable in gameplay. More info
See in Glossary
, and baked NavMeshes.

To support physics Colliders, the resolution of the hole’s mask Texture is equal to the resolution of the Terrain’s heightmapA greyscale Texture that stores height data for an object. Each pixel stores the height difference perpendicular to the face that pixel represents.
See in Glossary
- 1.

Additional resources


  • Paint Holes added in 2019.3 NewIn20193
Raise or Lower Terrain
Paint Texture