/data command

The /data command is used to modify and fetch NBT data of blocks, entities and storages.

Subcommands

get <source> [path] [scale]

Gets the data from a data source, and a path, if specified. Multiplies the resulting value by scale, if specified.
source is a data source, path is an nbt path and scale is a number.
If scale is set, and the data at that path it not a number, the command fails.

After fetching the NBT at the path, if it exists, it prints the data in SNBT format in the chat. Therefore, its main use is manually inspecting NBT data. However, it also returns the integer representation of the fetched data, so it can be used in combination with execute store or return run to convert NBT into an integer.

Examples

data get entity @s SelectedItem.id data get block ~ ~ ~ Items

merge <target> <nbt>

Merges data with the given data source.
target is a data source and nbt is an SNBT compound.
This command fails if the given entity or block does exist, or if the block is not a block entity and cannot hold NBT data. However, if the data source is a storage, and that storage does no exist yet, the storage is automatically created.

Examples

data merge entity @n[type=creeper] {Fuse: 10s, ignited: true, ExplosionRadius: 8} data merge storage example:data {a: 1, b: "b", c: [41b, 0b]}

modify <target> <path> <action> <source>

Modifies the NBT data at the specified path of the given data source. This gives more fine-grained control that data merge.
target is the data source to modify and path is an NBT path, the specific sub-path of that data source.
action determines what kind of modification occurs. There are 5 possible actions, as below.
source determines the source of the data being used to modify the target. See source below.

append

Appends an NBT value to a list or a typed array, making the value the last element.
If the specified path does not exist in the data source, it is created and initialized as a list containing the value just appended.
This is equivalent to data modify ... insert 0 ....

insert <index>

Inserts an NBT value into a list or array at a specific index, shifting all proceeding elements to the right. Negative indices may be used to indicate inserting values from the end.
If the index specified would cause the inserted item to be further than one after the first or last element of the list, the command fails.
Inserting creates list if it doesn’t exist in the same way as append.

merge

Merges source into target at path. This is similar to data merge, but allows modifying a sub-path of a data source, and allows merging from more than just hardcoded NBT values.

prepend

Prepends an NBT value to a list or a typed array, making the value the first element.
Lists are created in the same wat as append.
This is equivalent to data modify ... insert -1 ....

set

Sets the value of target at path, discarding any previously present value. This will create keys in a compound if not present, but cannot be used to add elements to an array or list, only modify existing ones.
set can create a chain of nested compounds if they don’t already exist.
For example, if the storage example:main does not yet exist, after the following command:

data modify storage example:main a.b.c.d set value 10

The example:main storage looks like this: {a: {b: {c: {d: 10}}}}.

source

source determines the value modifying target. It can be one of:

• value <value> - Gets the value from an SNBT literal.
• from <data-source> [path] - Gets the data from the specified data source and path.
• string <data-source> [path] [start] [end] - Gets the data from the specified data source and ensures that it’s a string. If start or end is specified, truncates the string using those values. start is inclusive, while end is exclusive. Both numbers are allowed to be negative, counting from the end of the string. For example, the indices 1 -1 remove one character from each end of the string, while 0 1 takes the first character.

remove <source> <path>

Removes the NBT data from source at path. source is a data source and path is an NBT path.
This deletes compound keys, and removes array and list elements, shifting proceeding elements left. It cannot, however, be used to delete an entire storage using the special {} path; only single keys of the root storage.

data modify storage example:main temp.a set value 1
data modify storage example:main temp.b set value 2
# Removes both keys
data remove storage example:main temp

Data source

The place to get data from or store data to. One of:

• entity <selector> - The NBT of an entity.
• block <pos> - The NBT of a block entity.
• storage <name> - The NBT from a data storage.

Data merging

Data merging is a process of merging two data values into one another.
There are two values: The left side and the right side. The left side is the base of the operation, with the right being merged into the left.

If both sides of the operation are compounds, each key of the right compound is merged into the matching key of the left compound. If the key does not exist in the left compound, it is created and set to the value of the right.

If both sides are not a compound, the left is simply set to the right.