Mineuniverse
Log in Register

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…

2 min read Updated 4 views
Removed features Villager mechanics Java Edition technical Development
Advertisement Remove ads with Premium →
Contents (3)
  1. NBT Structure
  2. History
  3. See also
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 from 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.212w32a Overworld village data is saved.
1.814w02a Village data is saved for the Nether and the End.
1.1419w11a Village data has been removed and replaced by points of interest system.

See also

Advertisement Remove ads with Premium →

More in Villager mechanics

View all 12 →
LyingLyingLying is a position that happens to a player or certain mobs under different circumstances.Mob conversionMob conversionMob conversion is a game mechanic where under specific circumstances certain mobs can convert to mobs of a different type, or to a different variant of…Point of InterestPoint of interest refers to particularly important blocks in the game. In the game, there is a dedicated space that saves only the location of points of…RaidRaidA raid is an ominous event in which waves of illagers, witches, and ravagers spawn and attack a village. It is triggered when a player with the Raid Omen…TradingTradingTrading is a gameplay mechanic that allows players to exchange emeralds for items, and vice versa, with villagers and wandering traders. Trading can allow…Village mechanicsThis page describes mechanics relating to village and villagers.WorkstationA workstation is any block that a player can use to produce items or that functions as job site block for a villager.Zombie siegeZombie siegeZombie sieges are in-game events in which many zombies spawn and attack a village.
Explore the Minecraft Wiki
Blocks, items, mobs, biomes and game mechanics — all in one place.
Wiki home