This feature is exclusive to Java Edition.
The /data command allows the user to get, merge, modify, and remove NBT data of a block entity, entity, or Command NBT storage.
Syntax[]
There are four instructions for /data (get, merge, modify, remove), and the targets/sources referenced by each instruction command may be either block <targetPos>, entity <target>, or storage <target>.
/data ...... get... (block <targetPos>|entity <target>|storage <target>) [<path>] [<scale>]- Read off the entire NBT data or the subsection of the NBT data from the targeted block position or entity to the executor with syntax highlighting, scaled by <scale> if specified.
... merge... (block <targetPos>|entity <target>|storage <target>) <nbt>- Merge the NBT data from the target block position or entity with the specified
<nbt>data.
- Merge the NBT data from the target block position or entity with the specified
... modify (block <targetPos>|entity <target>|storage <target>) <targetPath> ...... append from (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>]... append string (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>] [<start>] [<end>]... append value <value>- Append the source data or direct value data onto the end of the pointed-to list.
... insert <index> from (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>]... insert <index> string (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>] [<start>] [<end>]... insert <index> value <value>- Insert the source data or direct value data into the pointed-to list as element
<index>, then shift higher elements one position upward.
- Insert the source data or direct value data into the pointed-to list as element
... merge from (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>]... merge string (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>] [<start>] [<end>]... merge value <value>- Merge the source data or direct value data into the pointed-to object.
... prepend from (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>]... prepend string (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>] [<start>] [<end>]... prepend value <value>- Prepend the source data or direct value data onto the beginning of the pointed-to list.
... set from (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>]... set string (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>] [<start>] [<end>]... set value <value>- Set the tag specified by
<targetPath>to the source data or direct value data.
- Set the tag specified by
... remove... (block <targetPos>|entity <target>|storage <target>) <path>- Removes NBT data at
<path>from the targeted block position or entity. Player NBT data cannot be removed.
- Removes NBT data at
Syntax displayed in various ways
Simplified tree: /data- where substituted arguments are:
<TARGET>=(block <targetPos> | entity <target> | storage <target>)<MODIFICATION>=(append|insert <index>|merge|prepend|set)<SOURCE>=(block <sourcePos> | entity <source> | storage <source>)
Squished tree: /data… get (block <targetPos>|entity <target>|storage <target>) [<path>] [<scale>]… merge (block <targetPos>|entity <target>|storage <target>) <nbt>… modify (block <targetPos>|entity <target>|storage <target>) <targetPath> (append|insert <index>|merge|prepend|set)… from (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>]… string (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>] [<start>] [<end>]… value <value>
… remove (block <targetPos>|entity <target>|storage <target>) <path>
Maximised: data get block <targetPos> [<path>] [<scale>]data get entity <target> [<path>] [<scale>]data get storage <target> [<path>] [<scale>]data merge block <targetPos> <nbt>data merge entity <target> <nbt>data merge storage <target> <nbt>data modify block <targetPos> <targetPath> append from block <sourcePos> <sourcePath>data modify block <targetPos> <targetPath> append from entity <source> <sourcePath>data modify block <targetPos> <targetPath> append from storage <source> <sourcePath>data modify block <targetPos> <targetPath> append string block <sourcePos> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> append string entity <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> append string storage <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> append value <value>data modify block <targetPos> <targetPath> insert <index> from block <sourcePos> <sourcePath>data modify block <targetPos> <targetPath> insert <index> from entity <source> <sourcePath>data modify block <targetPos> <targetPath> insert <index> from storage <source> <sourcePath>data modify block <targetPos> <targetPath> insert <index> string block <sourcePos> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> insert <index> string entity <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> insert <index> string storage <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> insert <index> value <value>data modify block <targetPos> <targetPath> merge from block <sourcePos> <sourcePath>data modify block <targetPos> <targetPath> merge from entity <source> <sourcePath>data modify block <targetPos> <targetPath> merge from storage <source> <sourcePath>data modify block <targetPos> <targetPath> merge string block <sourcePos> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> merge string entity <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> merge string storage <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> merge value <value>data modify block <targetPos> <targetPath> prepend from block <sourcePos> <sourcePath>data modify block <targetPos> <targetPath> prepend from entity <source> <sourcePath>data modify block <targetPos> <targetPath> prepend from storage <source> <sourcePath>data modify block <targetPos> <targetPath> prepend string block <sourcePos> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> prepend string entity <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> prepend string storage <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> prepend value <value>data modify block <targetPos> <targetPath> set from block <sourcePos> <sourcePath>data modify block <targetPos> <targetPath> set from entity <source> <sourcePath>data modify block <targetPos> <targetPath> set from storage <source> <sourcePath>data modify block <targetPos> <targetPath> set string block <sourcePos> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> set string entity <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> set string storage <source> <sourcePath> <start> <end>data modify block <targetPos> <targetPath> set value <value>data modify entity <target> <targetPath> append from block <sourcePos> <sourcePath>data modify entity <target> <targetPath> append from entity <source> <sourcePath>data modify entity <target> <targetPath> append from storage <source> <sourcePath>data modify entity <target> <targetPath> append string block <sourcePos> <sourcePath> <start> <end>data modify entity <target> <targetPath> append string entity <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> append string storage <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> append value <value>data modify entity <target> <targetPath> insert <index> from block <sourcePos> <sourcePath>data modify entity <target> <targetPath> insert <index> from entity <source> <sourcePath>data modify entity <target> <targetPath> insert <index> from storage <source> <sourcePath>data modify entity <target> <targetPath> insert <index> string block <sourcePos> <sourcePath> <start> <end>data modify entity <target> <targetPath> insert <index> string entity <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> insert <index> string storage <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> insert <index> value <value>data modify entity <target> <targetPath> merge from block <sourcePos> <sourcePath>data modify entity <target> <targetPath> merge from entity <source> <sourcePath>data modify entity <target> <targetPath> merge from storage <source> <sourcePath>data modify entity <target> <targetPath> merge string block <sourcePos> <sourcePath> <start> <end>data modify entity <target> <targetPath> merge string entity <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> merge string storage <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> merge value <value>data modify entity <target> <targetPath> prepend from block <sourcePos> <sourcePath>data modify entity <target> <targetPath> prepend from entity <source> <sourcePath>data modify entity <target> <targetPath> prepend from storage <source> <sourcePath>data modify entity <target> <targetPath> prepend string block <sourcePos> <sourcePath> <start> <end>data modify entity <target> <targetPath> prepend string entity <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> prepend string storage <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> prepend value <value>data modify entity <target> <targetPath> set from block <sourcePos> <sourcePath>data modify entity <target> <targetPath> set from entity <source> <sourcePath>data modify entity <target> <targetPath> set from storage <source> <sourcePath>data modify entity <target> <targetPath> set string block <sourcePos> <sourcePath> <start> <end>data modify entity <target> <targetPath> set string entity <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> set string storage <source> <sourcePath> <start> <end>data modify entity <target> <targetPath> set value <value>data modify storage <target> <targetPath> append from block <sourcePos> <sourcePath>data modify storage <target> <targetPath> append from entity <source> <sourcePath>data modify storage <target> <targetPath> append from storage <source> <sourcePath>data modify storage <target> <targetPath> append string block <sourcePos> <sourcePath> <start> <end>data modify storage <target> <targetPath> append string entity <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> append string storage <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> append value <value>data modify storage <target> <targetPath> insert <index> from block <sourcePos> <sourcePath>data modify storage <target> <targetPath> insert <index> from entity <source> <sourcePath>data modify storage <target> <targetPath> insert <index> from storage <source> <sourcePath>data modify storage <target> <targetPath> insert <index> string block <sourcePos> <sourcePath> <start> <end>data modify storage <target> <targetPath> insert <index> string entity <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> insert <index> string storage <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> insert <index> value <value>data modify storage <target> <targetPath> merge from block <sourcePos> <sourcePath>data modify storage <target> <targetPath> merge from entity <source> <sourcePath>data modify storage <target> <targetPath> merge from storage <source> <sourcePath>data modify storage <target> <targetPath> merge string block <sourcePos> <sourcePath> <start> <end>data modify storage <target> <targetPath> merge string entity <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> merge string storage <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> merge value <value>data modify storage <target> <targetPath> prepend from block <sourcePos> <sourcePath>data modify storage <target> <targetPath> prepend from entity <source> <sourcePath>data modify storage <target> <targetPath> prepend from storage <source> <sourcePath>data modify storage <target> <targetPath> prepend string block <sourcePos> <sourcePath> <start> <end>data modify storage <target> <targetPath> prepend string entity <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> prepend string storage <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> prepend value <value>data modify storage <target> <targetPath> set from block <sourcePos> <sourcePath>data modify storage <target> <targetPath> set from entity <source> <sourcePath>data modify storage <target> <targetPath> set from storage <source> <sourcePath>data modify storage <target> <targetPath> set string block <sourcePos> <sourcePath> <start> <end>data modify storage <target> <targetPath> set string entity <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> set string storage <source> <sourcePath> <start> <end>data modify storage <target> <targetPath> set value <value>data remove block <targetPos> <path>data remove entity <target> <path>data remove storage <target> <path>
Arguments[]
<targetPos>: block_pos
- The position of the target block entity whose NBT is to be operated on.
- Must be a block position composed of
<x>,<y>and<z>, each of which must be an integer or a tilde and caret notation.
<target>: entity (in entity <target> mode)
- Specifies an entity whose NBT is to be operated on.
- Must be a player name, a target selector or a UUID. And the target selector must be in single type.
<target>: resource_location (in storage <target> mode)
- Specifies a storage to be operated on.
- Must be a resource location which will be resolved during command execution into unregistered content or client-side content.
<path>: nbt_path
- Specifies the NBT to retrieve or remove.
- Must be an NBT path.
<scale>: double
- Scalar for the command's return value.
- Must be a Double-precision floating-point format number.
<nbt>: nbt_compound_tag
- Specifies a compound tag to be merged into somewhere.
- Must be a compound NBT in SNBT format.
<targetPath>: nbt_path
- Specifies target NBT to modify.
- Must be an NBT path.
<index>: integer
- Specifies an item's index within a list.
- Must be a 32-bit integer number.
<sourcePos>: block_pos
- The position of the target block entity whose NBT is to be used.
- Must be a block position composed of
<x>,<y>and<z>, each of which must be an integer or a tilde and caret notation.
<source>: entity (in entity <source> mode)
- Specifies an entity whose NBT is to be used by
modify. - Must be a player name, a target selector or a UUID. And the target selector must be in single type.
<source>: resource_location (in storage <source> mode)
- Specifies a storage to be used by
modify. - Must be a resource location which will be resolved during command execution into unregistered content or client-side content.
<sourcePath>: nbt_path
- Specifies the source NBT to be used by
modify. - Must be an NBT path.
<start>: integer
- Specifies the index of first character to include at the start of the string. Negative values are interpreted as index counted from the end of the string.
- Must be a 32-bit integer number.
<end>: integer
- Specifies the index of the first character to exclude at the end of the string. Negative values are interpreted as index counted from the end of the string.
- Must be a 32-bit integer number.
<value>: nbt_tag
- Value used in modifying the target NBT. Should match its data type.
- Must be an NBT tag of any type in SNBT format.
Result[]
| Command | Trigger | Java Edition |
|---|---|---|
| any | the arguments are not specified correctly | Unparseable |
<targetPos> is unloaded or out of the world | Failed | |
the block at <targetPos> is not a block entity | ||
<target> (in entity <target> mode) fails to resolve to an entity (named player must be online) | ||
/data get ... | more than one tag is got | |
/data get ... <path> | <path> does not exist | |
/data get ... <path> <scale> | the obtained tag is not a numeric tag | |
/data merge ... | nothing is changed | |
| try to edit player's data | ||
/data remove ... | <path> is the root compound tag | |
/data modify ... (from|string) block ... | <sourcePos> is unloaded or out of the world | |
the block at <sourcePos> is not a block entity | ||
/data modify ... (from|string) entity ... | <sourceEntity> fails to resolve to an entity (named player must be online) | |
/data modify ... (from|string) ... <sourcePath> | <sourcePath> does not exist | |
/data modify ... string ... <sourcePath> <start> <end> | <sourcePath> isn't a string or numeric tag (will be converted to a string) | |
<start> or <end> is out of valid indexes of the source string | ||
Character indexed by <start> is behind of that indexed by <end> | ||
/data modify ... append ... | the target tag isn't a list or array | |
| source data isn't of an item type appropriate for the list | ||
/data modify ... insert <index> ... | the index is invalid | |
/data modify ... merge ... | the target path does not specify a compound tag | |
| the source data is not a compound tag | ||
| any | Otherwise | Successful |
Output[]
| Command | Edition | Situation | Success Count | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| any | Java Edition | On fail | 0 | 0 | 0 |
/data get ... | On success | 1 | 1 | 1 | |
/data get ... <path> | a numeric tag is got | 1 | 1 | the obtained value after rounding down[1] | |
| a list or array tag is got | 1 | 1 | The number of elements in this list or array | ||
| a string tag is got | 1 | 1 | The length of the string | ||
| a compound tag is got | 1 | 1 | The number of tags that are direct children of that compound | ||
/data get ... <path> <scale> | On success | 1 | 1 | the obtained value multiplied by <scale>, then rounded down[2] | |
/data merge ... | On success | 1 | 1 | 1 | |
/data remove ... | On success | 1 | 1 | 1 | |
/data modify ... append ... | On success | 1 | 1 | the number of lists or arrays to which new elements are added | |
/data modify ... set ... | On success | 1 | 1 | the number of target tags that was successfully modified | |
/data modify ... merge ... | On success | 1 | 1 | the number of target compound tags that was successfully modified |
Examples[]
- To get the saturation level of the current player:
/data get entity @s foodSaturationLevel
- To make the nearest item within 10 blocks unable to be picked up by players:
/data modify entity @e[type=item,distance=..10,limit=1,sort=nearest] PickupDelay set value -1
- To get the Y-position of a random item:
/data get entity @e[type=item,limit=1,sort=random] Pos[1]
- To get the item ID of the item in the first hotbar slot of the nearest player:
/data get entity @p Inventory[{Slot:0b}].id
- To set the armor attribute of the dolphin closest to coordinates (0, 64, 0) to 20:
/data modify entity @e[x=0,y=64,z=0,type=dolphin,limit=1] Attributes[{Name:"minecraft:generic.armor"}].Base set value 20
- To change the first item in a chest located at coordinates (1, 64, 1) into a diamond block, keeping all NBT data:
/data modify block 1 64 1 Items[0].id set value "minecraft:diamond_block"
- To make the nearest zombie have a 80% chance to drop items in its off-hand when it dies, and never drop items in the main hand:
/data merge entity @e[type=zombie,limit=1,sort=nearest] {HandDropChances: [0f, 0.8f]}
- To make the nearest zombie have a 80% chance to drop items in its off-hand when it dies, without affecting the chance for the main hand:
/data modify entity @e[type=zombie,limit=1,sort=nearest] HandDropChances[1] set value 0.8f
Storage[]
See also: command storage format
The command storage of NBT data is an efficient way for commands to access or save NBT data without an overhead for block entities or entities reading from or writing to the NBT data.
Each command storage is a general purpose, key-value storage, identified by a resource location to prevent unintentional conflicts.
/data get and /data modify can read from the storage, while /data merge, /data modify, /data remove, and /execute store can write to the storage.
A storage array can hold up to 2304 objects before maxing out.
The command storage is accessible with JSON text as well.
History[]
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.13 | 17w45b | Added /data. | |||
| 17w47a | Commands /blockdata and /entitydata have been removed as their features are merged into /data. | ||||
| 18w03a | Using /data get (block|entity|storage) with a path now works on non-numeric values. | ||||
| 1.14 | 18w43a | Added /data modify (block|entity|storage). | |||
| 1.15 | 19w38a | Added storage <resource location> as a source or target. | |||
| 1.19.4 | 23w03a | Added string source. | |||
| 1.20 | Pre-release 1 | Now <start> or <end> in string source accept negative boundaries, which are interpreted as index counted from the end of the string. | |||
| Pre-release 2 | Now invalid <start> or <end> in string source result in command failure instead of unhandaled error.[3] | ||||
References[]
- ↑ double n = (double)value;
int output = n < (int)n ? (int)n - 1 :(int)n;
See also MC-259032 - ↑ double n = (double)value * scale;
int output = n < (int)n ? (int)n - 1 :(int)n;
See also MC-259032 - ↑ MC-260602 — "/data modify from string index failure does not return 0 for /execute store success." — resolved as "Fixed".