This compendium is not a tutorial. This page holds information concerning the need to label tag-types within dataTags for the /summon command. An example is attempting to add the "UUIDLeast" and "UUIDMost" tags to an entity. Without appending the value with an "l", which stands for "long", the tag will not be set. This oddity is not present on all tags, and there does not appear to be any pattern to determine which tags require labels. Thus this compendium will list all tags and note whether or they the work in /summon, and whether or not they need a suffix in /summon.
◊ = PartialWhen a tag is labeled as partial, the tag can work but may require assistance to be apparent/existent, or has limitations with its use. If a tag is marked as "Working", this does not dictate the usefulness of the tag, merely that the tag can be applied. Data on this page is not necessarily 100% accurate and is not advertised to be. If corrections need to be made, please contact me on the forums. This page currently reflects tag status as of 14w11b and attempts to follow the Wiki page that details all NBT tags for entities.
GENERAL |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| id | string | ◊ | ✕ | id:Creeper | The ID is labelled in the syntax, thus is ignored in the root dataTags. Can be used in lower branches, such as "Riding". |
| Pos | list (double) | ✕ | - | - | The Pos is labelled in the command syntax, thus is ignored. |
| Motion | list (double) | ✓ | ✕ | Motion:[0.0,1.0,0.0] Motion:[.0,.5] |
Does not need all 3 values, defaulting undefined ones to 0.0. Must have a decimal with a number following, but does not need a number before the decimal. |
| Rotation | list (float) | ◊ | ✓ | Rotation:[45f] Rotation:[45f,30f] |
Requires Motion greater than 0 to update their rotation. Can define just yaw, but yaw must have suffix for pitch to work. |
| FallDistance | float | ✓ | ✕ | FallDistance:50 | - |
| Fire | short | ✓ | ✕ | Fire:20 | - |
| Air | short | ✓ | ✕ | Air:0 | Tag will be set back to default if the mob is not underwater. |
| OnGround | byte | ✓ | ✕ | OnGround:0 | Tag works but is essentially useless, updated automatically. |
| Dimension | integer | ✓ | ✕ | Dimension:1 | Does not seem to be updated. Might be worth using this over "CustomName" for NBT tracking, though won't work in entity selectors (@e). |
| Invulnerable | byte | ✓ | ✕ | Invulnerable:1 | Any value apart from 0 will cause the mob to become invulnerable. As of 1.8, invulnerable entities are now killable via the void and /kill commands. |
| PortalCooldown | integer | ✓ | ✕ | PortalCooldown:6000 | - |
| UUIDMost | long | ◊ | ✓ | UUIDMost:40l | Requires UUIDLeast to correctly exist. |
| UUIDLeast | long | ◊ | ✓ | UUIDLeast:40l | Requires UUIDMost to correctly exist. |
| Riding | compound | ✓ | ✕ | Riding:{} Riding:{id:Creeper} |
- |
MOBS GENERAL |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| HealF | float | ✓ | ✕ | HealF:1 | Will die instantly if lower than 1. Overrides "Health" if set. |
| Health | short | ✓ | ✓ | Health:1s | Will die instantly if lower than 1. Overridden by "HealF" if "HealF" is set, otherwise "HealF" will match "Health" when summoned. |
| AbsorptionAmount | float | ✓ | ✕ | AbsorptionAmount:1 | - |
| AttackTime | - | ✕ | - | - | Does not appear to exist any more? |
| HurtTime | short | ✓ | ✕ | HurtTime:600 | The value is overwritten once the mob is struck. |
| DeathTime | short | ✓ | ✕ | DeathTime:600 | The mob will not die upon being summoned, but will have their "DeathTime" set as defined. Once the mob dies, its "DeathTime" tag will increase by 1 per tick, starting at the defined value. Once the value hits 20, the mob will be unloaded. If the value is 20 or higher, the mob will never be unloaded nor accessible in-game (the death animation still plays), and can only be removed via third-party editors. Negative values may be used and the mob will not unload until their "DeathTime" reaches 20, in which the mob is still inaccessible during this time. A "DeathTime" of 19 will result in near-instant unloading, skipping almost the entire animation. |
| Attributes | list (compound) | ✓ | ✕ | Attributes:[] Attributes:[{}] |
- |
| Attributes / Name | string | ✓ | ✕ | Name:generic.movementSpeed | - |
| Attributes / Base | double | ✓ | ✕ | Base:0 | - |
| Attributes / Modifiers | list (compound) | ✓ | ✕ | Modifiers:[] Modifiers:[{}] |
- |
| Attributes / Modifiers / Name | string | ✓ | ✕ | Name:"Custom Name" | - |
| Attributes / Modifiers / Amount | double | ✓ | ✕ | Amount:5 | - |
| Attributes / Modifiers / Operation | integer | ✓ | ✕ | Operation:0 | - |
| Attributes / Modifiers / UUIDMost | long | ✓ | ✕ | UUIDMost:40 | - |
| Attributes / Modifiers / UUIDLeast | long | ✓ | ✕ | UUIDLeast:40 | - |
| ActiveEffects | list (compound) | ✓ | ✕ | ActiveEffects:[] ActiveEffects:[{}] |
- |
| ActiveEffects / Id | byte | ✓ | ✕ | Id:11 | - |
| ActiveEffects / Amplifier | byte | ✓ | ✕ | Amplifier:0 Amplifier:-128 |
Amplifier can be set "greater than" 127 by switching to negatives, starting at -128 and increasing. -1 would be an amplifier of 255. This is how the /effect command can use amplifiers "greater than" 127, despite using a tag-type of byte. This allows you to mimic odd amplifier behaviours, such as removal of jumping on mobs by setting to -128 (though the mob will die when changing height). If value is negative, particles will not display regardless of "ShowParticles" tag. |
| ActiveEffects / Duration | integer | ✓ | ✕ | Duration:200 | - |
| ActiveEffects / Ambient | byte | ✓ | ✕ | Ambient:1 | Any value apart from 0 will decrease visibility of particles. |
| ActiveEffects / ShowParticles | byte | ✓ | ✓ | ShowParticles:0b | Any value apart from 0 will cause particles to display. |
| Equipment | list (compound) | ✓ | ✕ | Equipment:[] Equipment:[{}] |
See /summon item format for item details. |
| DropChances | list (float) | ✓ | ✓ | DropChances:[0.5f] DropChances:[.5f] DropChances:[1f,1f,1f,1f,2f] |
If value is 1.0 or lesser, the durability on the item (if a tool) will be randomized, regardless of defined "Damage" value (unless "Unbreakable" exists). If greater than 1.0, the durability will remain as defined. |
| CanPickUpLoot | byte | ✓ | ✓ | CanPickUpLoot:1b | Any value apart from 0 will allow the mob to pick up items. |
| PersistenceRequired | byte | ✓ | ✕ | PersistenceRequired:1 | Any value apart from 0 will force the mob to be persistent. |
| CustomName | string | ✓ | ✕ | CustomName:"Test Test" | - |
| CustomNameVisible | byte | ✓ | ✕ | CustomNameVisible:1 | Any value apart from 0 will set the name to be visible from afar. |
| Leashed | byte | ✓ | ✕ | Leashed:1 | Any value apart from 0 will flag the mob as being leashed. |
| Leash | compound | ✓ | ✕ | Leash:{} | - |
| Leash / UUIDMost | long | ◊ | ✓ | UUIDMost:40l | Overrides X/Y/Z. Requires UUIDLeast to be defined. |
| Leash / UUIDLeast | long | ◊ | ✓ | UUIDLeast:40l | Overrides X/Y/Z. Requires UUIDMost to be defined. |
| Leash / X | integer | ✓ | ✕ | X:10 | - |
| Leash / Y | integer | ✓ | ✕ | Y:4 | - |
| Leash / Z | integer | ✓ | ✕ | Z:10 | - |
MOBS |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| Breeding/Taming | |||||
| InLove | integer | ✓ | ✕ | InLove:200 | Particles will not display, but functions otherwise. |
| Age | integer | ✓ | ✕ | Age:200 | - |
| ForcedAge | integer | ✓ | ✕ | ForcedAge:200 | - |
| Owner | string | ✓ | ✕ | Owner:Skylinerw | - |
| Sitting | byte | ✓ | ✕ | Sitting:1 | Any value apart from 0 will cause the mob to sit. |
| Bat | |||||
| BatFlags | byte | ✓ | ✕ | BatFlags:1 BatFlags:3 |
Appears to be a bit field, with "hanging upside-down" as 1. Unsure what the other values are, if any. |
| Chicken | |||||
| IsChickenJockey | byte | ✓ | ✕ | IsChickenJockey:1 | Any value apart from 0 will cause the chicken to despawn naturally. |
| Creeper | |||||
| powered | byte | ✓ | ✕ | powered:1 | Any value apart from 0 will power the creeper. |
| ExplosionRadius | byte | ✓ | ✕ | ExplosionRadius:0 | - |
| Fuse | short | ✓ | ✕ | Fuse:0 Fuse:32767 |
Setting to 0 or lower will cause the creeper to instantly explode upon summoning. |
| ignited | byte | ✓ | ✕ | ignited:1 | Any value apart from 0 will ignite the creeper. |
| Enderman | |||||
| carried | short | ✓ | ✕ | carried:35 carried:minecraft:wool |
The end result of the tag is a type "short", even though you can input the alphabetical block ID. I'm under the assumption that the "carried" tag will house the randomly-assigned numerical ID per map instead of the alphabetical block ID. All the other conversions from "short" to "string" involve items, while the enderman can only hold physical blocks. This is likely the case as placed blocks will be stored as numerical values, which is what the enderman picks up. Same case with pistons moving blocks. However, the "inTile" tag for projectiles says differently, which does store the alphabetical name of the block. We'll just have to wait and see, then. |
| carriedData | short | ✓ | ✕ | carriedData:14 | - |
| Endermite | |||||
| Lifetime | integer | ✓ | ✕ | Lifetime:0 Lifetime:-2147483648 Lifetime:2400 |
When value is 2400 or higher, the Endermite will be forcibly despawned. Value does not increment if the "CustomName" tag exists on the entity. |
| EntityHorse | |||||
| Bred | byte | ✓ | ✕ | Bred:1 | |
| ChestedHorse | byte | ✓ | ✕ | ChestedHorse:1 | Any value apart from 0 will indicate a chested horse. |
| EatingHaystack | byte | ✓ | ✕ | EatingHaystack:1 | Any value apart from 0 will initiate the "eating haystack" animation. |
| HasReproduced | byte | ✓ | ✕ | HasReproduced:1 | |
| Tame | byte | ✓ | ✕ | Tame:1 | Any value apart from 0 will indicate a tame horse. |
| Temper | integer | ✓ | ✕ | Temper:100 | - |
| Type | integer | ✓ | ✕ | Type:1 | - |
| Variant | integer | ✓ | ✕ | Variant:1 | - |
| OwnerName | strig | ✓ | ✕ | OwnerName:Skylinerw | - |
| Items | list (compound) | ✓ | ✕ | Items:[] Items:[{}] |
See /summon item format for item details. |
| ArmorItem | compound | ✓ | ✕ | ArmorItem:{} | See /summon item format for item details. |
| SaddleItem | compound | ✓ | ✕ | SaddleItem:{} | See /summon item format for item details. |
| Saddle | byte | ✓ | ✕ | Saddle:1 | Any value apart from 0 will place a default saddle on the horse. |
| Ghast | |||||
| ExplosionPower | integer | ✓ | ✕ | ExplosionPower:0 | No matter what the value is, the ghast will be dealt 2000 damage (1000 hearts) if hit by it. |
| Ozelot | |||||
| CatType | integer | ✓ | ✕ | CatType:1 | - |
| Pig | |||||
| Saddle | byte | ✓ | ✕ | Saddle:1 | Any value apart from 0 will cause the pig to have a saddle. |
| Sheep | |||||
| Sheared | byte | ✓ | ✕ | Sheared:1 | Any value apart from 0 will cause the sheep to be sheared. |
| Color | byte | ✓ | ✕ | Color:14 | - |
| Skeleton | |||||
| SkeletonType | byte | ✓ | ✕ | SkeletonType:1 | - |
| Slime | |||||
| Size | integer | ✓ | ✕ | Size:4 | Values under 0 will default back to 0. Slimes will now halve into proper sizes when killed. |
| WitherBoss | |||||
| Invul | integer | ✓ | ✕ | Invul:200 | - |
| Wolf | |||||
| Angry | byte | ✓ | ✕ | Angry:1 | - |
| CollarColor | byte | ✓ | ✕ | CollarColor:14 | - |
| Villager | |||||
| Profession | integer | ✓ | ✕ | Profession:1 | Negative values will produce a 'generic' villager, and will cause the game to crash when attempting to open the trade menu. |
| Riches | integer | ✓ | ✕ | Riches:40 | - |
| Career | integer | ✓ | ✕ | Career:1 | - |
| CareerLevel | integer | ✓ | ✕ | CareerLevel:1 | - |
| Willing | byte | ✓ | ✕ | Willing:1 | - |
| Inventory | list (compound) | ✓ | ✕ | Inventory:[] Inventory:[{}] |
See /summon item format for item details. |
| Offers | compound | ✓ | ✕ | Offers:{} | - |
| Offers / Recipes | list (compound) | ✓ | ✕ | Recipes:[] Recipes:[{}] |
- |
| Offers / Recipes / rewardExp | byte | ✓ | ✓ | rewardExp:0b rewardExp:1b |
Any value apart from 0 will reward the player with experience for trading. |
| Offers / Recipes / maxUses | integer | ✓ | ✕ | maxUses:40 | - |
| Offers / Recipes / uses | integer | ✓ | ✕ | uses:0 uses:-2147483648 |
- |
| Offers / Recipes / buy | compound | ✓ | ✕ | buy:{} | See /summon item format for item details. Currently ignores all data within the "tag" tag for items. |
| Offers / Recipes / buyB | compound | ✓ | ✕ | buyB:{} | See /summon item format for item details. Currently ignores all data within the "tag" tag for items. |
| Offers / Recipes / sell | compound | ✓ | ✕ | sell:{} | See /summon item format for item details. |
| VillagerGolem | |||||
| PlayerCreated | byte | ✓ | ✕ | PlayerCreated:1 | Any value apart from 0 will prevent the golem from becoming hostile towards the player. |
| Zombie | |||||
| IsVillager | byte | ✓ | ✕ | IsVillager:1 | Any value apart from 0 indicates a villager zombie. |
| IsBaby | byte | ✓ | ✕ | IsBaby:1 | Any value apart from 0 indicates a baby zombie. |
| ConversionTime | integer | ✓ | ✕ | ConversionTime:200 | Any value below -1 will be set back to -1. |
| CanBreakDoors | byte | ✓ | ✕ | CanBreakDoors:1 | Any value apart from 0 will allow the zombie to break doors. |
| PigZombie | |||||
| Anger | short | ✓ | ✕ | Anger:200 | The number of ticks remaining until the zombie pigman is neutral. 0 when neutral. As of 1.8, zombie pigmen have had their AI updated to match the AI other mobs use. They no longer attack any nearby player if this tag is set, thus you can no longer summon hostile zombie pigmen. |
PROJECTILES |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| General | |||||
| xTile | short | ✓ | ✕ | xTile:10 | The tag will be set but will automatically update once the arrow lands. Does not affect actual position. |
| yTile | short | ✓ | ✕ | yTile:4 | The tag will be set but will automatically update once the arrow lands. Does not affect actual position. |
| zTile | short | ✓ | ✕ | zTile:10 | The tag will be set but will automatically update once the arrow lands. Does not affect actual position. |
| inTile | string | ✓ | ✕ | inTile:minecraft:stone | The tag will be set but will automatically update once the arrow lands. |
| inGround | byte | ? | ? | ? | Updated the instant it's summoned; cannot tell if tag needs suffix or not (not that it matters). |
| shake | byte | ✓ | ✕ | shake:10 | Not effective in /summon command, as the arrow will always be "in flight" when summoned. The animation will be visible for a brief instant until the arrow skips the animation to land (thus initiating the shake) or fall. The value will not automatically update, even when it lands, and will decrease by 1 per tick. Setting to higher values will not affect the outcome of its animation once it lands. |
| Arrow | |||||
| inData | byte | ✓ | ✕ | inData:14 | Will not be updated until the arrow lands. |
| pickup | byte | ✓ | ✕ | pickup:1 | - |
| player | byte | ✓ | ✕ | player:1 | Any value apart from 0 will allow the arrow to be picked up. |
| life | short | ? | ? | ? | Updated the instant it's summoned, even if summoned within a block (arrows are /summoned in-flight, which will update the tag); unsure if tag needs suffix or not (not that it matters). Setting to 1199 or higher does not despawn the arrow instantly. |
| damage | double | ✓ | ✕ | damage:40 | - |
| Other | |||||
| direction | list (double) | ✓ | ✕ | direction:[] direction:[0.0,0.0,0.0] |
Decimals are required when setting values. |
| ExplosionPower | integer | ✓ | ✕ | ExplosionPower:0 | - |
| ownerName | string | ✓ | ✕ | ownerName:Skylinerw | Only increments scores if the named player is online. Does not work for incrementing entity scores, whether using their UUID pair or CustomName. |
| Potion | compound | ✓ | ✕ | Potion:{} | - |
| potionValue | integer | ✓ | ✕ | potionValue:16452 | - |
ITEMS |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| Item | |||||
| Age | short | ✓ | ✕ | Age:5980 Age:-32768 |
Setting to -32768 will prevent the value from increasing. |
| Health | short | ◊ | ✕ | Health:127 Health:128 |
Seems it wants to be a byte rather than a short, but is still saved as a short. Any value above 127 will be set accordingly. 128 will be set to -128, 129 set to -127, 255 set to -1, 257 set to 1, etc. Also occurs when modifying with a third-party editor. |
| PickupDelay | short | ✓ | ✕ | PickupDelay:40 PickupDelay:32767 |
Setting to 32767 will prevent the value from decreasing. |
| Owner | string | ✓ | ✕ | Owner:Skylinerw | - |
| Thrower | string | ✓ | ✕ | Thrower:Skylinerw | - |
| Item | compound | ✓ | ✕ | Item:{} | - |
| XPOrb | |||||
| Health | short | ◊ | ✕ | Health:127 Health:128 |
The tag is saved as a short (including natural XP orbs). It behaves in the exact same way as the Item's Health tag, in which values above 127 overflow accordingly; 128 will be set to -128, 129 set to -127, 255 set to -1, 257 set to 1, etc. |
| Value | short | ✓ | ✕ | Value:40 | Negative values can be used but results in oddities with the players XP, such as being incapable of gaining XP levels from XP orbs (/xp while giving levels still works). Unsure if this has any extreme negative bearings on gameplay or if it can be used in custom maps effectively. |
VEHICLES |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| General | |||||
| CustomDisplayTile | byte | ✓ | ✕ | CustomDisplayTile:1 | Any value apart from 0 will show the display tile. |
| DisplayTile | string | ✓ | ✕ | DisplayTile:minecraft:wool | - |
| DisplayData | integer | ✓ | ✕ | DisplayData:14 | - |
| DisplayOffset | integer | ✓ | ✕ | DisplayOffset:40 DisplayOffset:-40 |
- |
| CustomName | string | ✓ | ✕ | CustomName:"Test Test" | - |
| MinecartChest/MinecartHopper | |||||
| Items | list (compound) | ✓ | ✕ | Items:[] Items:[{}] |
See /summon item format for item details. |
| MinecartFurnace | |||||
| PushX | double | ✓ | ✕ | PushX:1 PushX:-1 |
Will automatically update once it is on track, and will remain negative if set. |
| PushZ | double | ✓ | ✕ | PushZ:1 PushZ:-1 |
Will automatically update once it is on track, and will remain negative if set. |
| Fuel | short | ✓ | ✕ | Fuel:400 | - |
| MinecartHopper | |||||
| TransferCooldown | integer | ✓ | ✕ | TransferCooldown:40 | Value will decrease by 1 per tick once summoned. |
| MinecartTNT | |||||
| TNTFuse | integer | ✓ | ✕ | TNTFuse:40 | - |
| MinecartCommandBlock | |||||
| Command | string | ✓ | ✕ | Command:"/say Test" | Can exceed the in-game maximum of 16369 characters, taking full potential of the string tag-type. |
| SuccessCount | integer | ✓ | ✕ | SuccessCount:14 SuccessCount:-1 |
Negative values will turn comparators on (powered_comparator), but no signal will be produced. |
| LastOutput | string | ✓ | ✕ | LastOutput:Test | - |
| TrackOutput | byte | ✓ | ✕ | TrackOutput:0 TrackOutput:1 |
Any value apart from 0 will update the LastOutput tag when the command block is powered. If set to 0, the LastOutput tag is not updated. Does not affect the commands ability to initiate. |
DYNAMIC TILES |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| PrimedTnt | |||||
| Fuse | byte | ✓ | ✕ | Fuse:40 | - |
| FallingSand | |||||
| Block | string | ✓ | ✕ | Block:minecraft:wool | - |
| Data | byte | ✓ | ✕ | Data:14 | - |
| TileEntityData | compound | ✓ | ✕ | TileEntityData:{} | - |
| Time | byte | ✓ | ✕ | Time:0 Time:1 |
- |
| DropItem | byte | ✓ | ✕ | DropItem:0 DropItem:1 |
Any value apart from 0 will allow the FallingSand to be dropped as an item. |
| HurtEntities | byte | ✓ | ✕ | HurtEntities:0 HurtEntities:1 |
Any value apart from 0 will cause the entity to hurt others. |
| FallHurtMax | integer | ✓ | ✕ | FallHurtMax:400 | - |
| FallHurtAmount | float | ✓ | ✕ | FallHurtAmount:4 | - |
ITEM FORMAT |
|||||
|---|---|---|---|---|---|
| Tag Name | Tag Type | Working | Suffix | Example | Notes |
| tag / CustomPotionEffects / Ambient | byte | ◊ | ✕ | Ambient:1 | Any value apart from 0 will decrease visibility of particles. Currently does not work with splash potions, whether it be the entity or item. |
| tag / CustomPotionEffects / ShowParticles | byte | ◊ | ✓ | ShowParticles:1b ShowParticles:0b |
Any value apart from 0 will display particles. Currently does not work with splash potions, whether it be the entity or item. |