This page will be updated as soon as the formatting is complete and more progress has been made into the NBT Tags that can be attached to commands in 13w36a.
For now see this Minecraft Forum Topic regarding the NBT Tags that can be added to the commands /give and /summon: [1]
As of snapshot 13w36a, NBT tags can be specified for items and entities created with the /give and /summon commands. Each tag has the format <tagname>:<value> ; multiple tags are separated by commas. The contents of List tags are enclosed in square brackets [], while the contents of Compound tags are enclosed in curly braces {} – note that the entire data tag is itself a Compound tag. Tag names are case-sensitive, and white space is ignored.
See Entity Format for the various NBT Tags that are saved for each Entity. This page also contains basic information for each NBT Tag.
When None is used in a Tagname that means that this tag can be put directly into the start of the dataTag
Items
These can be used in /give commands as well as /clear. for such commands as /summon and /setblock, place them inside of a tag tag, like so: {id:"stone",Count:3 ... tag:{Name:"your name" ...}} These tags can be used on any item
| NBT Tag | Description | Allowed tagnames | Required tagnames | Syntax |
|---|---|---|---|---|
| ench | Allows the addition of enchantments to items. Contains information on the id of the echantment and the level of the enchantment. Can specify one enchantment or multiple enchantments. | id, lvl | All | {ench:[{id:"",lvl:""},{id:"",lvl:""}]} |
| display | Used to add custom names, colors (leather armor), and lore to items. Lore may have multiple lines.
Color is a hexadecimal color value, except in decimal. A converter can be found here: http://www.statman.info/conversions/hexadecimal.html |
Name, color, Lore | At least one | {display:{Name:"",color:,Lore:["", ""]}} |
| AttributeModifiers | Can be used to add attributes to mobs or items. | AttributeName, Name (Attribute), Amount, Operation, UUIDLeast, UUIDMost | All | AttributeModifiers:[0:{AttributeName,Name,Amount,Operation},1:{AttributeName,Name,Amount,Operation, UUIDLeast,UUIDMost}] |
| Unbreakable | Used to make items with durability never degrade. | Unbreakable | All | Unbreakable:1/0 (1 = true, 0 = false) |
The following table provides more details on previous sub-tags.
| Tagname | Description | Used In | Value Type | Allowed Values |
|---|---|---|---|---|
| id | Refers to the id of an enchantment. See Enchanting for details on which id correlates to which enchantment. | ench | Numerical | 0 - 62 |
| lvl | Determines the level of an enchantment. A level between one and ten will display properly on an item, however, any value above that will display enchantment.level.lvl. | ench | Numerical | 0 - 32767 |
| Name | Is the name of an item that will be displayed in game. For blocks such as Chests and Dispensers the name will replace the default 'Chest' or 'Dispenser' in the upper left hand corner of the GUI. When used on command blocks the name will be displayed when executing commands. This can be seen by using the /say command.
|
display | String | Any character that is available within the Minecraft language files (Most characters on your keyboard) |
Blocks
These tags are put on blocks.
| Tagname | Description | Value Type | Syntax |
|---|---|---|---|
| CanPlaceOn | This tag is used when making adventure maps to determine which block(s) the player can place it on | An array of Strings, each one saying the id of a block | CanPlaceOn:["minecraft:stone","minecraft:stonebrick"] |
| BlockEntityTag | This is used for tile entities, and stores their data for when they are placed down | Differs based on the block, see Blocks for details | BlockEntityTag:{TagName:"tagdata"} |
Entities
| NBT Tag | Description | Allowed tagnames | Required tagnames | Syntax |
|---|---|---|---|---|
| TileEntityData | Used to store all data kept within a block. Mainly used within blocks that can store items or contain various data values. I.E. Command blocks, Chests, Jukeboxes, Dispenser, Beacon, etc. | CustomName, Items, Command, Levels, Primary, Secondary, Delay, MaxNearbyEntities, MaxSpawnDelay, MinSpawnDelay, RequiredPlayerRange, SpawnCount, SpawnRange, EntityID | None | TileEntityData:{} |
| direction | Similar to motion, determines the direction that an entity will be moving upon being summoned. Must be entered as double precision floating point values (it has a decimal) Example: {direction:[0.0,1.0,0.0]} summons with an upwards velocity of 1.0. | X, Y, Z | All | direction:[X,Y,Z] |
| Motion | Similar to direction, determines the direction that an FallingSand entity will be moving upon being summoned. Must be entered as double precision floating point values (it has a decimal) Example: {Motion:[0.0,1.0,0.0]} summons with an upwards velocity of 1.0. | X, Y, Z | All | Motion:[X,Y,Z] |
| ActiveEffects | Sets the effects that will apply to a mob after it's summoned. | Id, Duration, Amplifier, Ambient | All | ActiveEffects:[{Id:,Duration:,Amplifier:,Ambient:},{Id:,Duration:,Amplifier:,Ambient:}] |
| Riding | Shows the information of the Entity that is stacked below another Entity. | id, Riding, CustomName, ActiveEffects | id | Riding:{id:} |
| Equipment | Adds armor & weapons to the Entity. The IDs list down to Item, Helmet, Chestplate, Leggings, and Boots. Tags can be left blank to indicate no Armor/Weapon. | id | id (Not all tags need to be filled.) | Equipment:[{id:},{id:},{id:},{id:},{id:}] |
The following table provides information on each tagname that can be added in an NBT Tag. These tagnames are specific to the /summon command.
| Tagname | Description | Used In | Value Type | Allowed Values |
|---|---|---|---|---|
| Type | Used to change the type of mobs, like horses. Setting a horse's type to 4 will make it a skeleton horse. | None | Summon | 1 - Infinity |
| Saddle | Used to spawn horses or pigs that have saddles on. | None | Summon | 1 - Infinity |
| Tame | Used to spawn tamed horses. | None | Summon | 1 - Infinity |
| Variant | Changes the horse variant. Setting no variant or putting an incorrect variant spawns a normal white horse. See Horse Variants for the list of Variants. | None | Summon | 1 - 1030 |
| TileID | Determines which block is being summoned when using /summon FallingSand. Use Data Values to find out the ID of each block. You can also use F3+H in-game to show the ID's of items in-game. | None | Block ID | 1 - 173 |
| Time | Whether or not the block despawns before hitting the ground. If set to 1 the block will fall normally, if set to less than 1 will be set to 0. If set to 0 the block will despawn immediately. Recommended to keep this value as 1. | None | Numerical | 0 - 127 |
| DropItem | Whether or not the block will drop its item form if the block is unable to be placed. If set to 0 the block will not drop its respective item, if set to 1 the block will drop its respective item. | None | Numerical | 0 or 1 |
| id | Determines the entity the other entity will be riding on. | None | Savegame ID | Any Savegame ID of an Entity |
| Fuse | Determines how long it takes for PrimedTnt to explode. | None | Numerical | 0 - 383 |