Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A Minecraft anvil file format parser

Project description


Simple parser for the Minecraft anvil file format


This project is available on PyPI and can be installed with pip

pip install anvil-parser

or directly from github

pip install git+



import anvil

region = anvil.Region.from_file('r.0.0.mca')

# You can also provide the region file name instead of the object
chunk = anvil.Chunk.from_region(region, 0, 0)

# If `section` is not provided, will get it from the y coords
# and assume it's global
block = chunk.get_block(0, 0, 0)

print(block) # <Block(minecraft:air)>
print( # air
print( # {}

Making own regions

import anvil
from random import choice

# Create a new region with the `EmptyRegion` class at 0, 0 (in region coords)
region = anvil.EmptyRegion(0, 0)

# Create `Block` objects that are used to set blocks
stone = anvil.Block('minecraft', 'stone')
dirt = anvil.Block('minecraft', 'dirt')

# Make a 16x16x16 cube of either stone or dirt blocks
for y in range(16):
    for z in range(16):
        for x in range(16):
            region.set_block(choice((stone, dirt)), x, y, z)

# Save to a file'r.0.0.mca')


May contains some bugs, testing done with saves from 1.14.4, and in DataVersion 1976

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for anvil-parser, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size anvil_parser-0.1.1-py3-none-any.whl (12.0 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size anvil-parser-0.1.1.tar.gz (9.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page