We have begun migration of most wikis to our new host, Amazon Web Services. All but the top 100 wikis are in read-only mode until the migration is complete. Estimated completion: End of Week.

Template:Nbt

From Minecraft Wiki
Jump to: navigation, search
[view | edit | history | purge]Documentation
The sprite sheet

This template is used to more clearly illustrate NBT tags and JSON fields.

When showing the structure of an NBT file, this template is best coupled with a unordered list, wrapped in a treeview class.

Usage[edit source]

{{nbt|<tagname>|display text (optional)}}

Available tags[edit source]

Icon Tag name(s)

byte

short

int
integer

long

float

double

byte array
byte-array

string

list

compound

int array
int-array
integer array
integer-array

bool
boolean

Note: NBT does not use the boolean type (true/false attributes are usually of byte type), so this type should only be used for JSON.

JSON has no concept of numeric types other than double, nor of arrays that specify their elements' type, so the byte, short, int, long, float, byte array and int array tags should only be used to indicate what type Minecraft will convert a JSON field to after reading it.

Example[edit source]

Usage with treeview list[edit source]

<div class="treeview">
* {{nbt|compound}} World data.
** {{nbt|int|GameType}}: Whether in survival (0) or in creative (1) mode.
** {{nbt|long|LastPlayed}}: Stores the Unix time stamp (in seconds) when the player saved the game.
** {{nbt|string|LevelName}}: Specifies the name of the level.
** {{nbt|int|Platform}}: Seems to store the platform that the level is created on. Currently observed value is 2.
** {{nbt|compound|Player}}: Player entity information. See Entity Format and Mob Entity Format for details. It is missing the id tag and has additional elements:
*** {{nbt|int|Dimension}}: The dimension the player is in. 0 is the Overworld.
*** {{nbt|list|Inventory}}: Each TAG_Compound in this list defines an item the player is carrying or holding.
**** {{nbt|compound}} Inventory item data
***** {{nbt|byte|Slot}}: Indicates which inventory slot this item is in.
***** {{nbt|short|id}}: Item or Block ID.
***** {{nbt|byte|Count}}: Number of items stacked in this inventory slot. Any item can be stacked, including tools. Range is 1-255. Values above 127 and below -128 are not displayed in-game.
***** {{nbt|short|Damage}}: For tools, the amount of wear they have suffered. The maximum durability of the tool (for example, 33 for golden tools) means undamaged. When the Damage reaches 0, it breaks and disappears.
*** {{nbt|int|Score}}: The score of the player.
** {{nbt|long|RandomSeed}}: Random number providing the Random Seed for the terrain.
** {{nbt|long|SizeOnDisk}}: Estimated size of the entire world in bytes.
** {{nbt|int|SpawnX}}: X coordinate of the player's spawn position. Default is 0.
** {{nbt|int|SpawnY}}: Y coordinate of the player's spawn position. Default is 64.
** {{nbt|int|SpawnZ}}: Z coordinate of the player's spawn position. Default is 0.
** {{nbt|int|StorageVersion}}: Current version of Pocket Edition NBT. Currently 3.
** {{nbt|long|Time}}: Stores the current "time of day" in ticks. There are 20 ticks per real-life second, and 14400 ticks per Minecraft day/night cycle, making the full cycle length 12 minutes—8 minutes shorter than the standard 20 minute day/night cycle. 0 is the start of daytime, 7200 is the start of sunset, 8280 is the start of nighttime, 13320 is the start of sunrise, and 14400 is daytime again. The value stored in level.dat is always increasing and can be larger than 14400, but the "time of day" is always modulo 14400 of the "Time" field value.
</div>

  • World data.

    •  GameType: Whether in survival (0) or in creative (1) mode.

    •  LastPlayed: Stores the Unix time stamp (in seconds) when the player saved the game.

    •  LevelName: Specifies the name of the level.

    •  Platform: Seems to store the platform that the level is created on. Currently observed value is 2.

    •  Player: Player entity information. See Entity Format and Mob Entity Format for details. It is missing the id tag and has additional elements:

      •  Dimension: The dimension the player is in. 0 is the Overworld.

      •  Inventory: Each TAG_Compound in this list defines an item the player is carrying or holding.

        • Inventory item data

          •  Slot: Indicates which inventory slot this item is in.

          •  id: Item or Block ID.

          •  Count: Number of items stacked in this inventory slot. Any item can be stacked, including tools. Range is 1-255. Values above 127 and below -128 are not displayed in-game.

          •  Damage: For tools, the amount of wear they have suffered. The maximum durability of the tool (for example, 33 for golden tools) means undamaged. When the Damage reaches 0, it breaks and disappears.

      •  Score: The score of the player.

    •  RandomSeed: Random number providing the Random Seed for the terrain.

    •  SizeOnDisk: Estimated size of the entire world in bytes.

    •  SpawnX: X coordinate of the player's spawn position. Default is 0.

    •  SpawnY: Y coordinate of the player's spawn position. Default is 64.

    •  SpawnZ: Z coordinate of the player's spawn position. Default is 0.

    •  StorageVersion: Current version of Pocket Edition NBT. Currently 3.

    •  Time: Stores the current "time of day" in ticks. There are 20 ticks per real-life second, and 14400 ticks per Minecraft day/night cycle, making the full cycle length 12 minutes—8 minutes shorter than the standard 20 minute day/night cycle. 0 is the start of daytime, 7200 is the start of sunset, 8280 is the start of nighttime, 13320 is the start of sunrise, and 14400 is daytime again. The value stored in level.dat is always increasing and can be larger than 14400, but the "time of day" is always modulo 14400 of the "Time" field value.

See also[edit source]

[view | edit | history | purge]The above documentation is transcluded from Template:Nbt/doc.