Player.datフォーマット

提供: Minecraft Wiki
移動先: 案内検索
この記事の内容は翻訳されていません。
あなたが内容を翻訳してみませんか?

<player>.dat files are used by servers to store the state of individual players. The format is also used within level.dat files to store the state of the singleplayer player, which overrides any <player>.dat files with the same name as the singleplayer player. These files are in NBT format.

NBT structure[編集 | ソースを編集]

  • Nbtsheet.png The root tag. In level.dat files, this tag is called "Player".
    • All tags from Entities except the id, CustomName, and CustomNameVisible tags.
    • All tags from Mobs except HandItems, ArmorItems, DropChances, CanPickUpLoot, PersistenceRequired, Leashed, and Leash.
    • Nbtsheet.png DataVersion: Version of the player NBT structure.
    • Nbtsheet.png Dimension: The dimension the player is in. -1 is the Nether, 0 is the Overworld, 1 is the End. Other values are interpreted as 0.
    • Nbtsheet.png playerGameType: The game mode of the player. 0 is Survival, 1 is Creative, 2 is Adventure and 3 is Spectator.
    • Nbtsheet.png Score: The Score displayed upon death.
    • Nbtsheet.png SelectedItemSlot: The selected hotbar slot of the player.
    • Nbtsheet.png SelectedItem: Data of the item currently being held by the player, excluding the Slot tag.
    • Nbtsheet.png SpawnX: See below.
    • Nbtsheet.png SpawnY: May not exist. The coordinates of the player's bed. These tags are only removed if the player attempts to respawn with no valid bed to spawn at at these coordinates. They are unaffected by breaking beds at these coordinates, and are unaffected by the player's death.
    • Nbtsheet.png SpawnZ: See above.
    • Nbtsheet.png SpawnForced: 1 or 0 (true/false) - True if the player should spawn at the above coordinates even if no bed can be found.
    • Nbtsheet.png Sleeping: 1 or 0 (true/false) - true if the player was in a bed; has no effect on whether the player is in a bed when they log in.
    • Nbtsheet.png SleepTimer: The number of ticks the player had been in bed. No effect.
    • Nbtsheet.png foodLevel: The value of the hunger bar; 20 is full. See Hunger.
    • Nbtsheet.png foodExhaustionLevel: See Hunger.
    • Nbtsheet.png foodSaturationLevel: See Hunger.
    • Nbtsheet.png foodTickTimer: See Hunger.
    • Nbtsheet.png XpLevel: The level shown on the XP bar.
    • Nbtsheet.png XpP: The progress/percent across the XP bar to the next level.
    • Nbtsheet.png XpTotal: The total amount of XP the player has collected over time; used for the Score upon death.
    • Nbtsheet.png XpSeed: The seed used for the next enchantment in enchantment tables.
    • Nbtsheet.png Inventory: Each compound tag in this list is an item in the player's inventory. (Note: when empty, list type may have unexpected value.
    • Nbtsheet.png EnderItems: Each compound tag in this list is an item in the player's 27-slot ender chest inventory. (Note: when empty, list type may have unexpected value.)
      • Nbtsheet.png An item in the inventory, includes the Slot tag - slots are numbered 0 to 26, inclusive.
    • Nbtsheet.png abilities: The abilities this player has.
      • Nbtsheet.png walkSpeed: The walking speed, always 0.1.
      • Nbtsheet.png flySpeed: The flying speed, always 0.05.
      • Nbtsheet.png mayfly: 1 or 0 (true/false) - true if the player can fly.
      • Nbtsheet.png flying: 1 or 0 (true/false) - true if the player is currently flying.
      • Nbtsheet.png invulnerable: 1 or 0 (true/false) - true if the player is immune to all damage and harmful effects except for void damage. (damage caused by the /kill command is void damage)
      • Nbtsheet.png mayBuild: 1 or 0 (true/false) - true if the player can place and destroy blocks.
      • Nbtsheet.png instabuild: 1 or 0 (true/false) - true if the player can instantly destroy blocks.
    • Nbtsheet.png RootVehicle: The root entity that the player is riding.
      • Nbtsheet.png AttachLeast: The UUIDLeast of the entity the player is riding.
      • Nbtsheet.png AttachMost: The UUIDMost of the entity the player is riding.
      • Nbtsheet.png Entity: The NBT data of the root vehicle.
    • Nbtsheet.png ShoulderEntityLeft: The entity that is on the player's left shoulder. Will always display as a parrot.
    • Nbtsheet.png ShoulderEntityRight: The entity that is on the player's right shoulder. Will always display as a parrot.
    • Nbtsheet.png seenCredits: 1 or 0 (true/false) - true if the player has traveled to the Overworld via an End portal.
    • Nbtsheet.png recipeBook: Contains a JSON object detailing recipes the player has unlocked.

Item structure[編集 | ソースを編集]

Items are used both in the player's inventory and Ender inventory, and in chest tile entities, dropped item entities, furnace tile entities, brewing stand tile entities, and Villager trading recipes. Sometimes a Slot tag is used to specify the slot the item is in, such as with chests; other times there is no Slot tag, such as with dropped items.

  • Nbtsheet.png The item's root tag. Some instances may give this tag a name, other times it is nameless because it is in a list.
    • Nbtsheet.png Count: Number of items stacked in this inventory slot. Any item can be stacked, including tools, armor, and vehicles. Range is -128 to 127. Values of 1 are not displayed in-game. Values below 1 are displayed in red.[note 1]
    • Nbtsheet.png Slot: May not exist. The inventory slot the item is in.
    • Nbtsheet.png Damage: The data value for this item. The name "Damage" comes from when only tools used this value, now many other items use this value for other purposes. For blocks, it is the 4-bit "block data" tag that determines a variant of the block. Defaults to 0.
    • Nbtsheet.png id: Item/Block ID (This is a Short tag prior to 1.8.) If not specified, Minecraft changes the item to stone (setting ID to 1 and Damage to 0, and ignoring any existing Damage value) when loading the chunk or summoning the item .
    • Nbtsheet.png tag: Additional information about the item, discussed in the below sections. This tag is optional for most items.

General Tags[編集 | ソースを編集]

Items with durability can be made unbreakable and will never lose any durability. Additionally, items can have specifications for Adventure mode to describe which blocks may be broken with them.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png Unbreakable: 1 or 0 (true/false) - if true, the item doesn't lose durability when used.
    • Nbtsheet.png CanDestroy: The only blocks this item may break when used by a player in adventure mode.
      • Nbtsheet.png: The block ID.

Block Tags[編集 | ソースを編集]

Blocks can be given tags to specify what blocks they may be placed against in Adventure mode, and to specify what Tile Entity NBT tags to apply to them when placed.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png CanPlaceOn: Determines which blocks that blocks with this tag can be placed against in adventure mode.
      • Nbtsheet.png: The block ID.
    • Nbtsheet.png BlockEntityTag: Block entity NBT tags which are applied when this block is placed.[1] Used to store data on banners and shields or on blocks obtained in creative by holding ctrl (or ⌘ Cmd on mac) and pressing pick block on a block containing a block entity.

Enchantments[編集 | ソースを編集]

There are two ways enchantments are associated with items; the first way is that the item is actually enchanted and the enchantment affects the behavior of the item, and the second way is that the item is an enchanted book which simply stores the enchantments without actually affecting the behavior of the item. There is also the RepairCost tag which tracks anvil usage for items, making them more costly with every use of the anvil.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png ench: Contains enchantments on this item that affect the way the item works.
      • Nbtsheet.png: A single enchantment.
        • Nbtsheet.png id: ID of the enchantment.
        • Nbtsheet.png lvl: Level of the enchantment, where 1 is level 1.
    • Nbtsheet.png StoredEnchantments: Contains enchantments for enchanted books.
      • Nbtsheet.png: A stored enchantment, identical structure to each enchantment in ench.
    • Nbtsheet.png RepairCost: Number of enchantment levels to add to the base level cost when repairing, combining, or renaming this item with an Anvil.

StoredEnchantments tooltips will not be displayed if edited onto an item other than an enchanted book. Enchantments stored in ench, however, will always be displayed in the tooltip and will cause the item to glow, even if they cannot have any effect.

Attribute Modifiers[編集 | ソースを編集]

All items can be given Modifiers which affect various Attributes of the player/mob which wears or holds them. Note that if an item has vanilla default AttributeModifiers, these will cease to exist if this tag is added (e.g. a Diamond Sword given an empty AttributeModifiers list will no longer provide a boost to damage). Also note that the default vanilla AttributeModifiers do not actually use this tag, and as such, it will not appear on a natural item.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png AttributeModifiers: Contains Attribute Modifiers on this item which modify Attributes of the wearer or holder (if the item is not in the hand or armor slots, it will have no effect).
      • Nbtsheet.png: A single Attribute Modifier.
        • Nbtsheet.png AttributeName: The name of the Attribute this Modifier is to act upon.
        • Nbtsheet.png Name: Name of the Modifier
        • Nbtsheet.png Slot: Slot the item must be in for the modifier to take effect. "mainhand", "offhand", "feet", "legs", "chest", or "head".
        • Nbtsheet.png Operation: Modifier Operation. See Attribute Modifiers for info.
        • Nbtsheet.png Amount: Amount of change from the modifier.
        • Nbtsheet.png UUIDMost: Uppermost bits of the modifier's UUID.
        • Nbtsheet.png UUIDLeast: Lowermost bits of the modifier's UUID.

Potion Effects[編集 | ソースを編集]

Potions, splash potions, lingering potions and tipped arrows can have multiple, customized effects via the CustomPotionEffects tag. These effects are added to the default effect under the Potion tag if present. In addition the color can be overridden with the CustomPotionColor tag.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png CustomPotionEffects: The custom Potion effects this potion has.
      • Nbtsheet.png One of these for each effect.
        • Nbtsheet.png Id: The ID of the effect.
        • Nbtsheet.png Amplifier: The amplifier of the effect, with 0 being level 1.
        • Nbtsheet.png Duration: The duration of the effect in ticks.
        • Nbtsheet.png Ambient: 1 or 0 (true/false) - whether or not this is an effect provided by a beacon and therefore should be less intrusive on the screen. This tag is optional and defaults to 0. Due to a bug, it has no effect on splash potions.
        • Nbtsheet.png ShowParticles: 1 or 0 (true/false) - whether or not this effect produces particles. This tag is optional and defaults to 1. Due to a bug, it has no effect on splash potions.
    • Nbtsheet.png Potion: The name of the default potion effect. This name differs from the potion effect name. For example, the value for an "Instant Health II" potion is "minecraft:strong_healing".
    • Nbtsheet.png CustomPotionColor: The overrides the color of the potion, to be the prescribed color (same format as leather armor colors below).

Display Properties[編集 | ソースを編集]

Leather armor can be colored, and all items can have custom display names and lore. Various tooltips can also be hidden.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png display: Display properties.
      • Nbtsheet.png color: The color of the leather armor. The tooltip will display "Dyed" if advanced tooltips are disabled or will otherwise display the hexadecimal color value. Color codes are calculated from the Red, Green and Blue components using this formula:
        Red<<16 + Green<<8 + Blue[note 2]
      • Nbtsheet.png Name: The name to display for an item.
      • Nbtsheet.png LocName: A localization string to translate (e.g. gui.toTitle).
      • Nbtsheet.png Lore: List of strings to display as lore for the item.[2]
        • Nbtsheet.png A line of text for the lore of an item.
    • Nbtsheet.png HideFlags: Bit field determining which parts of the tooltip to hide on an item. 1 for "ench", 2 for "AttributeModifiers", 4 for "Unbreakable", 8 for "CanDestroy", 16 for "CanPlaceOn", and 32 for various other information (including potion effects, "StoredEnchantments", written book "generation" and "author", "Explosion", "Fireworks", and map tooltips). For example, setting to 3 would hide both "ench" and "AttributeModifiers" tags, and setting to 63 would hide everything.

Written Books[編集 | ソースを編集]

Both book and quill and written book use the tag tag to store information about the book. Only written books store the title, author, and generation of the book; pages is stored in both varieties.

Player Heads[編集 | ソースを編集]

Heads of the player variety can be associated with a specific username to take on the skin of that player when placed. The hand-held item is also updated with the new skin. Within this section, the "owner" of a head means the player whose head it is a copy of, and a player whose inventory contains a head is called the "holder".

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png SkullOwner (deprecated since 1.8): The username of the player this is a skull of for pre-1.8. Note that SkullOwner is for the item in inventories, whereas ExtraType is for skull blocks placed on the ground.[3]
    • Nbtsheet.png SkullOwner: definition for the skull's owner. Note that Owner is used for skulls placed on the ground.
      • Nbtsheet.png Id: UUID of owner. Optional. Used to update the other tags when the chunk loads or the holder logs in, in case the owner's name has changed.
      • Nbtsheet.png Name: Username of owner. If missing or empty, the head will appear as a Steve head. Otherwise, used to store or retrieve the downloaded skin in the cache. Need not be a valid player name, but must not be all spaces.
      • Nbtsheet.png Properties
        • Nbtsheet.png textures
          • Nbtsheet.png: An individual texture.
            • Nbtsheet.png Signature: Optional.
            • Nbtsheet.png Value: A Base64-encoded JSON object.[4]
              • Nbtsheet.png timestamp: Optional: Unix time in milliseconds.
              • Nbtsheet.png profileId: Optional: Player UUID without hyphens.
              • Nbtsheet.png profileName: Optional: Player name.
              • Nbtsheet.png isPublic: Optional.
              • Nbtsheet.png textures
                • Nbtsheet.png SKIN
                  • Nbtsheet.png url: URL of a player skin on textures.minecraft.net.[note 3]
                • Nbtsheet.png CAPE: Optional.
                  • Nbtsheet.png url: URL of a player cape (64x32 PNG).

Fireworks[編集 | ソースを編集]

Fireworks use the tag tag to store information about their effects.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png Explosion: One of these may appear on a firework star.
      • Nbtsheet.png Flicker: 1 or 0 (true/false) - true if this explosion will have the Twinkle effect (glowstone dust). May be absent.
      • Nbtsheet.png Trail: 1 or 0 (true/false) - true if this explosion will have the Trail effect (diamond). May be absent.
      • Nbtsheet.png Type: The shape of this firework's explosion. 0 = Small Ball, 1 = Large Ball, 2 = Star-shaped, 3 = Creeper-shaped, 4 = Burst. Other values will be named "Unknown Shape" and render as Small Ball.
      • Nbtsheet.png Colors: Array of integer values corresponding to the primary colors of this firework's explosion. If custom color codes are used, the game will render it as "Custom" in the tooltip, but the proper color will be used in the explosion. Custom colors are integers in the same format as the color tag from Display Properties.
      • Nbtsheet.png FadeColors: Array of integer values corresponding to the fading colors of this firework's explosion. Same handling of custom colors as Colors. May be absent.
    • Nbtsheet.png Fireworks: One of these may appear on a firework rocket.
      • Nbtsheet.png Flight: Indicates the flight duration of the firework (equals the amount of gunpowder used in crafting the rocket). While this value can be anything from -128 to 127, values of -2 and under almost never detonate at all.
      • Nbtsheet.png Explosions: List of compounds representing each explosion this firework will cause.
        • Nbtsheet.png Same format as 'Explosion' compound on a firework star, as described above.

Armor stands and spawn eggs[編集 | ソースを編集]

Armor stands and spawn eggs may contain potential entity data.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png EntityTag: Stores entity data that is applied to the armor stand when placed or entity when spawned.

Maps[編集 | ソースを編集]

Maps may be scaled.

  • Nbtsheet.png tag: The tag tag.
    • Nbtsheet.png map_scale_direction: Only internally used when scaling a map, after that directly removed: The amount to increase the current map scale by when crafting. Always 1.
    • Nbtsheet.png map_tracking_position: Only internally used when scaling a map, after that directly removed: 1 or 0 (true/false) - whether or not player markers should be added and updated. Currently unused.
    • Nbtsheet.png Decorations: A list of optional decorations. It will display defined symbols on the map
      • Nbtsheet.png An individual Decoration
        • Nbtsheet.png id: Identifier of the symbols
        • Nbtsheet.png type: Type of the symbol (see textures/map/map_icons.png)
        • Nbtsheet.png x: X position
        • Nbtsheet.png z: Z position
        • Nbtsheet.png rot: Rotation of the symbol, value from 0.0 to 360.0. The value 0 rotates the symbol to the bottom end of the map. The symbol is rotated clock-wise.
    • Nbtsheet.png display: The display tag.
      • Nbtsheet.png MapColor: The color of the markings on the item's texture.

Notes[編集 | ソースを編集]


Inventory slot numbers[編集 | ソースを編集]

This shows the numbers used to specify the slot in the inventory while editing with an NBT editor.

The off-hand slot is #−106.

History[編集 | ソースを編集]

正式版
1.8 14w06a Added CanDestroy for tools.
Added HideFlags to items.
14w07a Added BlockEntityTag for all blocks.
14w10a Added a 5th bit (value of 32) to HideFlags that hides potion effects.
14w33a Added SelectedItem for all items.

References[編集 | ソースを編集]

  1. Assuming the block is of a type that creates a block entity at all. If not, BlockEntityTag has no effect.
  2. https://www.reddit.com/r/Minecraft/comments/10xlod/minecraft_snapshot_12w40a/c6hinjw?context=1
  3. https://www.reddit.com/r/Minecraft/comments/zxn7u/its_apparently_my_cakeday_so_lets_cash_in_this/
  4. FVBico and Steven W.d.V.'s comments on MC-51003.



引用エラー: 「note」という名前のグループの <ref> タグがありますが、対応する <references group="note"/> タグが見つからない、または閉じる </ref> タグがありません