View source for Minecraft:Player.dat format

{{lowercase title}}
{{redirect|player.dat|the file that stores player data in Pocket Edition v0.1.0 alpha|Bedrock Edition level format/v0.1.0 alpha#player.dat}}
{{exclusive|java}}

'''<player>.dat''' files are used by [[Minecraft:server]]s to store the state of individual [[Minecraft:player]]s. The format is also used within [[Minecraft:Java Edition level format#level.dat format|level.dat]] files to store the state of the [[Minecraft:singleplayer]] player, which overrides any <player>.dat files with the same name as the singleplayer player. These files are in [[Minecraft:NBT format]].

== NBT structure ==

{{:Player/ED}}

{{Calculator|playerUuid}}

== Item structure ==
{{Main|Data component format}}

Items are used both in the player's inventory and ender chest.

== Inventory slot numbers ==

The image below shows the slot numbers of the player's inventory slots as of [[Minecraft:Java Edition 1.21.5]].

In versions prior to [[Minecraft:Java Edition 25w03a|25w03a]] (including [[Minecraft:Java Edition 1.21.4|1.21.4]]), the head, chest, legs, feet, and offhand slots were stored in the Inventory tag. In 1.21.4 and most prior versions these slots are numbered 103, 102, 101, 100 and -106 respectively.

[[File:Items slot number.png|alt=The player's inventory slot numbers as of 1.21.5.]]

== History ==
{{Missing information|section|history prior to 1.19|type=old}}

{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.7.6-pre1|Player data files are now named by UUID instead of by Username.}}
|{{HistoryLine||1.8|dev=14w33a|Added <code>SelectedItem</code> for all items.}}
|{{HistoryLine||1.12|dev=17w13a|Added {{cd|d=and|ShoulderEntityLeft|ShoulderEntityRight}}, which contain entity data about the entity on the player's shoulders.
|Added {{cd|seenCredits}} to indicate whether the player has entered the exit portal at least once.
|Added {{cd|recipeBook}}, which contain various information about the recipes the player has unlocked.}}
|{{HistoryLine|||dev=pre1|Added <code>enteredNetherPosition</code> to players, for use with the <code>[[Minecraft:Advancements#minecraft:nether_travel|minecraft:nether_travel]]</code> advancement trigger.}}
|{{HistoryLine||1.16|dev=Pre-release 6|Added {{cd|previousPlayerGameType}} to store the previous game mode of the player.}}
|{{HistoryLine||1.19|dev=22w14a|Added {{cd|LastDeathLocation}}, together with the [[Minecraft:recovery compass]].}}
|{{HistoryLine||1.20.5|dev=24w11a|Added {{cd|spawn_extra_particles_on_fall}}.}}
|{{HistoryLine||1.21|dev=Pre-release 4|Added {{cd|current_explosion_impact_pos}} and {{cd|ignore_fall_damage_from_current_explosion}} to store the [[Minecraft:wind charge]]'s fall damage reduction.}}
}}

== Trivia ==
* Pre-1.7.10 player data files were named as the player's username rather than their UUID, this meant if the server was running on Windows and the player had a reserved filename as a player name they would not have their player data saved. List of Reserved Windows Filenames:
** <code>AUX</code>
** <code>COM<n></code> where n is a digit from 1-9 (inclusive)
** <code>CON</code>
** <code>LPT<n></code> where n is a digit from 1-9 (inclusive)
** <code>NUL</code>
** <code>PRN</code>

== Navigation ==
{{Navbox Java Edition technical|general}}

[[Category:Development]]

[[Minecraft:de:Spielerdaten]]
[[Minecraft:fr:Format player.dat]]
[[Minecraft:ja:Player.datフォーマット]]
[[Minecraft:nl:Player.dat formaat]]
[[Minecraft:pt:Formato Player.dat]]
[[Minecraft:ru:Player.dat]]
[[Minecraft:zh:玩家数据格式]]