Volumes Reference

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 a Volume from the Volumes tab of the Modes menu 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:

PainCausingVolume_NoEffect.png PainCausingVolume_NoEffect_NoVolume.png

In Editor

In Game

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:

PainCausingVolume_Effect.png PainCausingVolume_Effect_NoVolume.png

In Editor

In Game

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

See the Collision Documentation for more details.

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 are Volumes with their collision settings pre-configured to block only cameras and ignore everything else. They are intended to define invisible barriers that keep the camera out of bad locations. An example of this might be in a third-person game, when the walls of the play area have decorative coverings like leafy vines. In these cases, 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 will call 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

See the details page for more information on the specific properties of Pain-Causing Volumes.

Physics Volume

See the details page for more information on the specific properties of Physics Volumes.

Trigger Volume

Trigger Volumes are used as a way to cause events when a Player or other object enters or exits them. They can be used quickly 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 TriggerVolume 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.

Remember to check the collision settings to ensure that your trigger will react to the intended Actors with the Overlap collision response setting.

Graphical and Audio Volumes

Audio Volume

See the details page for more information on the specific properties of Audio Volumes.

Cull Distance Volume

Cull Distance Volumes are optimization tools that allow for 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, simply 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 have no special properties, but are used by the 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 usage of this type of Volume 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

For more information on Lightmass and Lightmass Importance Volumes, please see the Lightmass documentation.

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 reduce geometry in a more optimal way.

Post Process Volume

For more information on Post Processing, please see the Post Processing Documentation.

Precomputed Visibility Volume

Precomputed Visibility Volumes are used primiarly 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 where 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 Volumes are used as a way to control where Nav Meshes will be built in a level. Nav Meshes are used to 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.

You can press P at any time in the viewport to visualize the Nav Mesh.

Please see the Content Examples and Nav Mesh Documentation for more details and examples.