Version: 2019.3
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 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 CollidersA terrain-shaped collider component that handles collisions for collision surface with the same shape as the Terrain object it is attached to. More info
See in Glossary
, and baked NavMeshes.

To support physics 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
, 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.


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