VOLUMES DOCUMENTATION
Version: 1.17.0.2

Index

Volumes
Volume Components
Volume Definition Properties
Volume Description Properties

Volumes

Volume Components

These are the various possible components for this entity

Name

Type

Default Value

Description

minecraft:bounds

Component that defines a minimum and maximum block position for a bounding box and which world dimension the bounding box is in. Every volume must have a bounds component.

Name	Type	Description
dimension	String	The name of the dimension the bounding box will exist in: one of 'overworld', 'nether' or 'the end'.
max	Vector [a, b, c]	The maximum block position of the bounding box.
min	Vector [a, b, c]	The minimum block position of the bounding box.

minecraft:fog

Displays the given fog whenever a player enters the volume. Each volume can only have one fog attached.

Name	Type	Default Value	Description
fog_identifier	String		The identifier of a fog definition. Note that you will not receive any feedback if the definition does not exist.
priority	Integer	INT_MAX	The priority for this fog definition setting. Smaller numbers have higher priority. Fogs with equal priority will be combined together.

Volume Definition Properties

The properties of a minecraft:volume entity. Note that every volume must have a bounds component. All other components are optional.

Name	Type	Default Value	Description
format_version	String		Specifies the version of the game this entity was made in. Minimum supported version is 1.17.0. Current supported version is 1.17.0.

Example

{
  "format_version": 1.17.0,
  "minecraft:volume": {
    "description": {
      "identifier": "your_custom_namespace:sample_volume"
    },
    "components": {
      "minecraft:bounds": {
        "min": [-50, 0, -50],
        "max": [50, 256, 50]
      },
      "minecraft:fog": {
        "fog_identifier": "minecraft:fog_savanna",
        "priority": 1
      }
    }
  }
}

Volume Description Properties

The description contains a single 'identifier' string

Name	Type	Default Value	Description
identifier	String		The unique identifier for this volume. It must be of the form 'namespace:name', where namespace cannot be 'minecraft'.