This article is about the format of villages.dat, which stores information on village doors, player reputation, etc. For the format of Village.dat, which stores information on village generation, see Generated structures data file format.
This page describes content that exists only in outdated versions of Java Edition.
As of 19w11a, this file is no longer generated or used.
The villages.dat file located in the data folder of every Minecraft level is used to store information about the villages in the level. It is stored as a GZip'd NBT file.
Additional files villages_nether.dat and villages_end.dat are stored, allowing for villages in other dimensions should the player build them.
Villages are "forgotten" and not saved in this file when their chunks are unloaded, likely since the villagers are not loaded to continue to "see" the doors.
NBT Structure[]
- : The root tag.
- data
- Tick: Internal clock.
- Villages: List of Byte tags when empty, list of Compound tags otherwise.
- : A village.
- ACX: Aggregate of the x-coordinates of all houses.
- ACY: Aggregate of the y-coordinates of all houses.
- ACZ: Aggregate of the z-coordinates of all houses.
- CX: X coordinate of the village center.
- CY: Y coordinate of the village center.
- CZ: Z coordinate of the village center.
- Golems: The number of Iron Golems.
- MTick: Last time a villager was killed by a mob, or by a damage source that's not related to an entity while a player was nearby.
- PopSize: The number of Villagers.
- Radius: Radius of the village.
- Stable: Last time a house was added to the village.
- Tick: Internal clock.
- Doors: The doors in the village.
- : A door.
- IDX: Specifies the inside direction along x.
- IDZ: Specifies the inside direction along z.
- TS: Last time a villager was nearby.
- X: X coordinate.
- Y: Y coordinate.
- Z: Z coordinate.
- : A door.
- Players: List of Byte tags when empty, list of Compound tags otherwise.
- : A player who has traded or harmed villagers.
- UUID: The UUID of the player.
- S: The social rank of the player. Can be negative. Goes up with trading and down with harming villagers.
- : A player who has traded or harmed villagers.
- : A village.
- data
History[]
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.4.2 | 12w32a | Overworld village data is saved. | |||
| 1.8 | 14w02a | Village data is saved for the Nether and the End. | |||
| 1.14 | 19w11a | Village data has been removed and replaced by points of interest system. | |||
See also[]
| Versions | |||
|---|---|---|---|
| Development |
| ||
| Technical |
| ||
| Multiplayer | |||
| Game customization | |||
