raids.dat format

This feature is exclusive to Java Edition.
 

The raids.dat file located in the data folder of every Minecraft level is used to store information about the raids in the level. It is stored as a gzip compressed NBT file.

Additional file raids_end.dat is stored in the data folder of end dimension folders, allowing for raids in other dimensions for villages in those dimensions.

Folder Structure

  • (world save directory)
    • data
      • raids.dat
    • DIM-1
      • data
        • raids.dat
    • DIM1
      • data
        • raids_end.dat

NBT Structure

  • [NBT Compound / JSON Object]: The root tag.
    • [Int] NextAvailableID: The ID for the next raid to occur.
    • [NBT List / JSON Array] Raids: List of compound tags including raid information.
      • [NBT Compound / JSON Object]: A raid.
        • [Byte] Active: 1 or 0 (true/false). Whether the raid functionality is active.
        • [Int] BadOmenLevel: The level of bad omen for the raid. Affects raider enchantments and the extra wave.
        • [Int] CX: The x position of the center of the raid, where raiders try to move to.
        • [Int] CY: The y position of the center of the raid, where raiders try to move to.
        • [Int] CZ: The z position of the center of the raid, where raiders try to move to.
        • [Int] GroupsSpawned: The number of waves that have spawned in the raid.
        • [NBT List / JSON Array] HeroesOfTheVillage: A list of players who have killed raiders in the raid. Each of these players receives the hero of the village effect when the raid ends in a victory status.
        • [Int] Id: The ID of the raid.
        • [Int] NumGroups: The total number of waves in this raid.
        • [Int] PreRaidTicks: The timespan, in ticks, until the initial spawning of raiders.
        • [Int] PostRaidTicks: The timespan, in ticks, after all the waves are cleared.
        • [Byte] Started: 1 or 0 (true/false). True if the raid has ever spawned a wave.
        • [String] Status: The status of the raid.
        • [Long] TicksActive: The timespan, in ticks, the raid has been going on for.
        • [Float] TotalHealth: The sum of maximum health of all the raiders in the current wave.
    • [Int] Tick: Internal clock.

History

Java Edition
1.1418w47aAdded raid data for all dimensions.
19w13aAdded HeroesOfTheVillage list.
1.161.16-pre3The data file for the nether, raids_nether.dat was renamed to raids.dat.

Navigation