Villages.dat format

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.

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.
        •  Players: List of Byte tags when empty, list of Compound tags otherwise.
          • : A player who has traded or harmed villagers.
            •  Name: The name of the player.
            •  S: The social rank of the player. Can be negative. Goes up with trading and down with harming villagers.