villages.dat format

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.
BlockSprite rose.png: Sprite image for rose in Minecraft
This page describes content that has been removed and was only present in earlier 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.

NBT Structure

  • [NBT Compound / JSON Object]: The root tag.
    • [NBT Compound / JSON Object] data
      • [Int] Tick: Internal clock.
      • [NBT List / JSON Array] Villages: List of Byte tags when empty, list of Compound tags otherwise.
        • [NBT Compound / JSON Object]: A village.
          • [Int] ACX: Aggregate of the x-coordinates of all houses.
          • [Int] ACY: Aggregate of the y-coordinates of all houses.
          • [Int] ACZ: Aggregate of the z-coordinates of all houses.
          • [Int] CX: X coordinate of the village center.
          • [Int] CY: Y coordinate of the village center.
          • [Int] CZ: Z coordinate of the village center.
          • [Int] Golems: The number of Iron Golems.
          • [Int] 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.
          • [Int] PopSize: The number of Villagers.
          • [Int] Radius: Radius of the village.
          • [Int] Stable: Last time a house was added to the village.
          • [Int] Tick: Internal clock.
          • [NBT List / JSON Array] Doors: The doors in the village.
            • [NBT Compound / JSON Object]: A door.
              • [Int] IDX: Specifies the inside direction along x.
              • [Int] IDZ: Specifies the inside direction along z.
              • [Int] TS: Last time a villager was nearby.
              • [Int] X: X coordinate.
              • [Int] Y: Y coordinate.
              • [Int] Z: Z coordinate.
          • [NBT List / JSON Array] Players: List of Byte tags when empty, list of Compound tags otherwise.
            • [NBT Compound / JSON Object]: A player who has traded or harmed villagers.
              • [String] UUID: The UUID of the player.
              • [Int] S: The social rank of the player. Can be negative. Goes up with trading and down with harming villagers.

History

Java Edition
1.4.212w32aOverworld village data is saved.
1.814w02aVillage data is saved for the Nether and the End.
1.1419w11aVillage data has been removed and replaced by points of interest system.

See also

Navigation

  • v
  • t
  • e
Java Edition technical
General
Concepts
General format
World
Level format
Legacy
.minecraft
Tools
Sound
Commands

All commands

Launching
Legacy
Protocol
Server
Legacy
This article is issued from Minecraft Wiki. The text is available under CC BY-NC-SA 3.0 unless otherwise noted. Additional terms may apply for the media files.