Anvil file format

Anvil^[1] is a file storage format. It brings a list of changes and improvements over from the previous file format, Region. It was implemented in snapshot 12w07a for release in Java Edition 1.2.1.

Changes from MCRegion[]

The only changes from MCRegion to Anvil were in the Chunk format; the Region file format is still used, but labeled as Anvil. The Anvil format introduced these changes to the Chunk format:

• Maximum build height has been increased to 256 (from 128).
• Empty sections of the world are not loaded into memory or saved to disk.
• The maximum Block ID has been increased to 4096 (was 256) by adding a 4-bit data layer (similar to how meta data is stored). The rest of Minecraft's code was not prepared to take advantage of this until terrain.png was removed and resource locations were added.
• Block ordering has been changed from XZY to YZX in order to improve compression.
• Packets for sending chunks have been optimized (a chunk without air is smaller than in the same chunk in the old format, and a chunk with lots of air is even smaller).
• Biomes are saved per X,Z column, rather than being calculated on the fly, which means they can be altered by tools; this is useful for map makers. It also prevents bugs where features don't match the biome after changing the terrain algorithm. (Also known as "Biome Shifting")

Further information[]

Versions from 12w07a to 1.17.1 automatically convert worlds to the new format, but a copy of the world files is created in the previous formats for compatibility with older game versions. The world generator has not been changed, so there is an additional 128 blocks of air above the usual terrain, making 192 blocks from sea level to the height limit.

• The 16×128×16 "Blocks", "Data", "SkyLight" and "BlockLight" tags were moved and repurposed. (see below)
• A "Sections" List tag containing Compound tags has been added with up to 16 Compound tags.
• Each section has 16×16×16 "Blocks", "Data", "SkyLight" and "BlockLight" tags.
• Each section has a "Y" Byte tag saying which section it is (note that some Y positions can be skipped). 0 is at the bottom of the world and 15 is the topmost section.
• Each section also has an optional "Add" tag, which is a DataLayer byte array just like "Data". The "Add" tag is not included in the converter since the old format never had block ids above 255. This extra tag is created whenever a block requires it, so the getTile() method needs to check if the array exists and then combine it with the default block data. In other words, blockId = (add << 8) + baseId.
• Each chunk has a 16×16 byte array with biome IDs called "Biomes". If this array is missing it is filled when the game starts, as well any -1 values in the array. The converter source provided for developers doesn't include any biome sources, however.
• Note that the old format is XZY ((x * 16 + z) * 16 + y) and the new format is YZX ((y * 16 + z) * 16 + x) (see the difference between DataLayer and OldDataLayer).
• The new format uses the extension ".mca" instead of ".mcr" (the old format is kept for safety, with the level.dat backed up as "level.dat_mcr").
• A new NBT tag type called IntArray was added to the NBT Format (With ID 11) and is used by the "Heightmap" tag.

Additional information may be found on the Chunk format page.

World size reduction post-conversion[]

Anvil world data uses a .mca file extension, while McRegion uses .mcr. The game leaves the old McRegion files after converting a world to Anvil, despite the game never using them again. To reduce the file size of backups, the old McRegion files may be deleted. To do this, perform the following steps:

• Windows:
  1. Open the command prompt (press ⊞ Win and R together, type cmd, and press ↵ Enter)
  2. Run the following command: del /f /q "[path to world folder]\region\*.mcr"

• Linux and macOS:
  1. Open the terminal
  2. Run the following command: rm -f "[path to world folder]"/region/*.mcr

History[]

Java Edition
1.2.1		12w07a			Added the Anvil File Format.
1.16		20w14a			Files in this format are now opened in synchronous mode to prevent data loss and corruption after crash.

See also[]

• Java Edition level format
• Chunk format
• Region file format

References[]

Minecraft: Java Edition
Versions	Demo Locations PC Gamer Demo (Beta 1.3)
Development	Version history Pre-Classic Classic Early Classic Creative Multiplayer Test Survival Test Late Classic Creative Indev Infdev Alpha Beta Full Release Development versions Removed features Blocks Items Unused features Exclusive features Mentioned features Sky dimension Planned versions
Technical	Known bugs Minecraft Launcher Hardware requirements al_version Block entity Commands Functions Crashes Data values Classic Indev Pre-flattening Data version Debug screen Formatting codes Heightmap Key codes Minecraft Launcher Protocol version Resource location Screenshot Seed Statistics Tick Spawn chunk Coordinates .minecraft client.jar client.json launcher_profiles.json options.txt Development resources Anvil file format Chunk format Command storage format Entity format Generated structures format Level format Loot tables Map item format Model NBT format Obfuscation map Player format raids.dat format Raw JSON text format Region file format Structure block file format Schematic file format Scoreboard format Server list format sounds.json Subtitles villages.dat format Legacy development resources Classic level format Classic server protocol Indev level format Alpha level format Infdev 20100624 level format server_level.dat
Multiplayer	Server Minecraft Realms Server list server.properties Server requirements
Game customization	Skins Capes Resource packs Data packs