Unreal Engine 5 Documentation has been moved to the Epic Developer Community

Volumes are three-dimensional Actors used to alter the behavior of areas within levels. Volumes can be used for behaviors like:

• Causing damage to the player or other Actors inside the Volume.

• Blocking certain Actors from entering the Volume, acting as a collision surface.

• Opening a door when an Actor enters the Volume.

• Changing the way a level calculates its lighting or visibility.

Creating and Placing Volumes

Volumes can be created by selecting one from the Volumes tab on the Place Actors panel and dragging and dropping it into the level viewport.

Once the Volume has been placed in the level, you can resize or reposition it as you see fit. There are two important points to keep in mind when placing Volumes:

1. Volumes are support Actors, generally used to detect when certain Actor types have entered a specific area and trigger an effect in response.

2. Volumes sometimes have built-in effects of their own (either in code or Blueprints), but most often they'll provide cues to other Actors. They should usually be thought of as parts of a greater system, with some other element acting as a visual cue.

As an example, a Pain-Causing Volume , which causes damage to anything inside the Volume, could be placed into a level like this:

In this case, the player will not know to avoid the Volume, or understand why they take damage when they enter it. The level designer should provide a hint to the player that explains the Pain Causing Volume:

In this case, the fire particle effect provides a visual explanation of why the area is dangerous, while the Pain Causing Volume supports the visuals with the gameplay effect of decreasing the player's health during exposure to the fire.

Volume Types

Collision and Overlap Volumes

Blocking Volume

A Blocking Volume Collision Documentation

Blocking Volumes can be used in the place of collision surfaces on Static Meshes, particularly in the case of walls in structures. This can cause scenes to operate more predictably, since physical objects won't interact with small details like bumps on the floor and walls. It can also improve performance by reducing the cost of physics simulation.

Camera Blocking Volume

Camera Blocking Volumes have pre-configured collision settings that block cameras and ignore everything else. They are intended to define invisible barriers that keep the camera out of unwanted locations. For example, a third-person game, the walls of the play area has decorative coverings, like leafy vines. In this case, a thin Camera Blocking Volume can be placed against the wall so that the camera doesn't bump into the vines or go behind the leaves, leaving it to slide smoothly and provide an unobstructed view of the action in the room.

Kill Z Volume

The purpose of Kill Z Volume is to prevent objects from going out of bounds in certain types of games, such as falling off of a cliff or into a pit in a platformer game, or leaving a spaceship without a suit in a science-fiction setting. The Kill Z Volume calls the FellOutOfWorld function on any Actor that enters it, and by default, Actors will go through a quick cleanup procedure and then destroy themselves. You can override this behavior for any of your Actor types if your game requires something different. For example, if a key or other item that the player is required to collect in order to continue the game falls into a lava pit, your game might want to teleport the item back up to an area the player can reach rather than destroying it, or at least inform the player that the item was lost and reload the last checkpoint, rather than leaving the game in an unwinnable state.

Pain-Causing Volume

Pain-Causing Volumes Pain-Causing Volumes Reference

Physics Volume

Physics Volumes are Volumes in which the physical setup that affects characters and other physics objects can be manipulated. A common use for them is for the creation of watery environments in which the player needs to swim. The effects of Physics Volumes are visible and can be interpreted as desired. The Character Movement Component class uses the current fields to adjust how their owning Character moves through the environment. If your game has custom physics, deriving your own child class from APhysicsVolume Physics Volume Reference

Trigger Volume

Trigger Volumes can cause events when a Player or other object enters or exits them. They can be used with the Level Blueprint to test out events and gameplay scenarios or functionality without the need for additional Blueprints.

For example, you could place a Trigger Volume in your level, then create an overlap event for the Volume in your Level Blueprint , which can play a sound, open a door, or start a cinematic scene.

Graphical and Audio Volumes

Audio Volume

Audio Volumes Audio Volume Reference

Cull Distance Volume

Cull Distance Volumes are optimization tools that allow objects to be culled (not drawn to the screen) based on that object's distance from the camera and its size. This can help optimize your scene by not drawing objects when they are small enough to be considered unimportant. Size is calculated by the bounding box along its longest dimension, and the cull distance chosen is the one closest to that size.

Cull Distance Volume setup is dependent on the Cull Distances property, shown in the Details panel below.

In the image above, the properties define the following behavior:

• Objects within the Volume that have a size closest to 50 units (distance equal to or less than 85 units) will be culled (disappear) when they are 500 units away from the camera or farther.

• Objects within the Volume that have a size closest to 120 units (distance between 85 units and 210 units) will be culled (disappear) when they are 1000 units away from the camera or farther.

• Objects within the Volume that have a size closest to 300 units (distance equal to or greater than 210 units) will never be culled, since 0 in this case is treated as infinity, meaning that the camera can never get far enough away.

Setup starts with adding a new entry into the Cull Distances array, which is done by clicking the button. Next, fill in the size of a given object and the desired distance at which you want objects of that size or smaller to be culled. These properties do not have to be created in a specific order.

Hierarchical LOD Volume

Hierarchical LOD Volumes are used by the Hierarchical Level of Detail (HLOD) system to group Actors into a single HLOD cluster. When generating clusters, the Unreal Engine will override its normal generation process in deference to manually-placed Volumes.

Lightmass Character Indirect Detail Volume

The Lightmass Character Indirect Detail Volume is similar to the Lightmass Importance Volume and generates indirect light samples, not just at Player height above ground, but inside the entire Volume. An example of how this type of Volume is used would be to place the Volume in an elevator shaft, ensuring that indirect lighting will be correct all the way along the shaft, instead of just at the bottom.

Lightmass Importance Volume

Lightmass Importance Volumes Lightmass Global Illumination

Mesh Merge Culling Volume

Mesh Merge Culling Volumes mark the mesh objects they contain so that these objects will be combined into a single mesh. This can improve performance by making a collection of small meshes in a contained area all cull together as one mesh, or by causing HLOD generation to more optimally reduce geometry.

Post Process Volume

A Post Process Volume can override Post Process settings applied to the camera by adjusting the properties in the Details Post Processing Documentation

Precomputed Visibility Volume

Precomputed Visibility Volumes are used primarily for performance optimization. These Volumes store the visibility of Actors for their location in the world. These should be placed only in areas the Player can access.

Precomputed Visibility Override Volume

Precomputed Visibility Override Volumes let you manually override the visibility of Actors for their location in the world if the auto-generated result of a Precomputed Visibilty Volume is undesired. These are also used for performance optimization and should only be placed in areas the Player can access.

Level and AI Volumes

Level Streaming Volumes

Level Streaming Volumes are used to aid in the Level Streaming process. They provide a simple way to encapsulate a level, as well as control when it streams in and out of memory, based on when a Player enters or exits the Volume.

Nav Mesh Bounds Volume

Nav Mesh Bounds Volumes are used to control where Nav Meshes will be built in a level. Nav Meshes calculate navigation paths throughout the areas of a level.

Within the Volume, a Nav Mesh is constructed on all surfaces with an appropriate angle to be walked upon. You may overlap as many of these as you need to generate the desired Nav Mesh.

To use the Nav Mesh Bounds Volume, simply create one (or more) that encloses the navigable areas of your level. The Nav Mesh will be built automatically.

Navmesh Content Examples