Skip to content
Minecraft Levels for Python
Python Shell
Find file
Failed to load latest commit information.
regression_test added regression test for heightmap Jan 6, 2011
schematics .NET gzip output doesn't always get read correctly by python's gzip Sep 28, 2010
test Fixed: Off-by-one error in schematic export with extended IDs. Feb 1, 2013
testfiles TileEntity.copyWithOffset now adjusts the coordinates of teleport com… Jan 8, 2013
.gitattributes Add .gitattributes with core.autocrlf Oct 27, 2012
.gitignore Add built docs to gitignore Jan 26, 2013
.travis.yml Add cython to travis install command Oct 13, 2013
LICENSE.txt added licensing terms Sep 25, 2010
README.txt Formally depend on pyyaml instead of pasting it in. This way pyyaml g… Feb 13, 2012
__init__.py Rename java.py -> javalevel.py Nov 23, 2013
_nbt.pyx NBT: TAG_List now accepts item assignment using slices. Oct 31, 2012
biome_types.py Added: New biome types Oct 26, 2013
block_copy.py Added: Biomes are now exported into schematic files. Jan 11, 2013
block_fill.py Fixed: import statement automatically inserted by PyCharm was relativ… Jan 24, 2013
blockrotation.py Added: Block rotation for several new blocks. Mar 24, 2013
box.py Add Vector.intfloor Jan 10, 2013
cachefunc.py pyflakes helped fixes: cachefunc.py: resolve function redefinition Mar 4, 2012
classic.yaml fix stone step graphics, change "Grey" spelling to "Gray" as it is in… Oct 29, 2011
entity.py Revert "Fixed: TileEntity.copyWithOffset adjusts mob position data fo… May 15, 2013
faces.py add faces.py Sep 29, 2011
gprof2dot.py pyflakes result fix: local variable is assigned to but never used Feb 26, 2012
indev.py Refactor: Change log statements to use `log.info()` instead of `info=… Oct 31, 2012
indev.yaml Blocktypes: Include classic blocks in indev.yaml instead of loading c… Nov 3, 2012
infiniteworld.py Flush and sync lock file when acquiring session lock Oct 13, 2013
items.py update for Minecraft 1.6.2 Aug 14, 2013
javalevel.py Rename java.py -> javalevel.py Nov 24, 2013
level.py Cleanup: Check whether a point is in the level's bounds using `in sel… Nov 14, 2012
materials.py Debug: Block YAML parsing errors are now fatal. Mar 4, 2014
mce.py mce.py: dumpsigns: Don't decode sign text now that TAG_String automat… Mar 9, 2013
mclevel.py Rename java.py -> javalevel.py Nov 24, 2013
mclevelbase.py Cleanup: Finding directories in mclevelbase.py Dec 2, 2012
minecraft.yaml Syntax Fixes Mar 9, 2014
minecraft_server.py Server Generator: Combine stdout and stderr to be compatible with pos… Oct 26, 2013
nbt.py Fixed: Remove self from TAG_Compound's key not found error message Jan 10, 2013
nbt_util.py Clean up NBT modules. Oct 10, 2012
pocket.py Debug: Change loggers to use __name__ instead of __file__ Feb 11, 2013
pocket.yaml Pocket: Fixed water, sandstone, quartz textures Mar 10, 2014
profimg.sh add profiling scripts Jul 30, 2011
regionfile.py Raise a ChunkTooBig error when trying to save a chunk that exceeds re… Oct 6, 2013
requirements.txt Formally depend on pyyaml instead of pasting it in. This way pyyaml g… Feb 14, 2012
requirements_test.txt Try to get travis-ci going Oct 13, 2013
run_nbt_tests.sh Tests now import pymclevel modules relative to pymclevel. This remove… Jan 7, 2013
run_regression_test.py Tests: run_regression_test.py now uses testfiles/AnvilWorld instead o… Dec 2, 2012
schematic.py Fixed: Schematic entities have wrong positions after rotating. Feb 15, 2013
setup.cfg Added distutils setup script written by user:sixohsix. Sep 15, 2011
setup.py Build: Merge setup_nbt.py into setup.py. Oct 29, 2012
setupnbt64.bat add setup_nbt.py and setupnbt64.bat. try to import _nbt without using… Nov 29, 2011

README.txt

Python library for reading Minecraft levels.

Can read Alpha levels, Indev levels, and Creative levels (with help).

Includes a command-line client (mce.py)

Requires numpy and PyYaml.

Read mclevel.py to get started.

See LICENSE.txt for licensing terms.



mce.py is a command-line editor for SMP maps. It can be used interactively from a terminal, accept editing commands on standard input, or run a single editing command from the shell.

Sample usage:

$ python mce.py

    Usage:

    Block commands:
        clone <sourcePoint> <sourceSize> <destPoint>
        fill <blockType> [ <point> <size> ]
        replace <blockType> [with] <newBlockType> [ <point> <size> ]

        export <filename> <sourcePoint> <sourceSize>
        import <filename> <destPoint>

        analyze

    Player commands:
        player [ <player> [ <point> ] ]
        spawn [ <point> ]

    Entity commands:
        removeEntities [ <EntityID> ]

    Chunk commands:
        createChunks <point> <size>
        deleteChunks <point> <size>
        prune <point> <size>
        relight [ <point> <size> ]

    World commands:
        degrief

    Editor commands:
        save
        reload
        load <filename> | <world number>
        quit

    Informational:
        blocks [ <block name> | <block ID> ]
        help [ <command> ]

    Points and sizes are space-separated triplets of numbers ordered X Y Z.
    X is position north-south, increasing southward.
    Y is position up-down, increasing upward.
    Z is position east-west, increasing westward.

    A player's name can be used as a point - it will use the
    position of the player's head. Use the keyword 'delta' after
    the name to specify a point near the player.

    Example:
       codewarrior delta 0 5 0

    This refers to a point 5 blocks above codewarrior's head.


Please enter world number or path to world folder: 4
INFO:Identifying C:\Users\Rio\AppData\Roaming\.minecraft\saves\World4\level.dat
INFO:Detected Infdev level.dat
INFO:Saved 0 chunks
INFO:Scanning for chunks...
INFO:Found 6288 chunks.
World4> fill 20 Player delta -10 0 -10 20 20 20

Filling with Glass
Filled 8000 blocks.
World4> player Player

Player Player: [87.658381289724858, 54.620000004768372, 358.64257283335115]
World4> player Player Player delta 0 25 0

Moved player Player to (87.658381289724858, 79.620000004768372, 358.642572833351
15)
World4> save

INFO:Asked to light 6 chunks
INFO:Batch 1/1
INFO:Lighting 20 chunks
INFO:Dispersing light...
INFO:BlockLight Pass 0: 20 chunks
INFO:BlockLight Pass 1: 2 chunks
INFO:BlockLight Pass 2: 0 chunks
INFO:BlockLight Pass 3: 0 chunks
INFO:BlockLight Pass 4: 0 chunks
INFO:BlockLight Pass 5: 0 chunks
INFO:BlockLight Pass 6: 0 chunks
INFO:BlockLight Pass 7: 0 chunks
INFO:BlockLight Pass 8: 0 chunks
INFO:BlockLight Pass 9: 0 chunks
INFO:BlockLight Pass 10: 0 chunks
INFO:BlockLight Pass 11: 0 chunks
INFO:BlockLight Pass 12: 0 chunks
INFO:BlockLight Pass 13: 0 chunks
INFO:SkyLight Pass 0: 20 chunks
INFO:SkyLight Pass 1: 22 chunks
INFO:SkyLight Pass 2: 17 chunks
INFO:SkyLight Pass 3: 9 chunks
INFO:SkyLight Pass 4: 7 chunks
INFO:SkyLight Pass 5: 2 chunks
INFO:SkyLight Pass 6: 0 chunks
INFO:SkyLight Pass 7: 0 chunks
INFO:SkyLight Pass 8: 0 chunks
INFO:SkyLight Pass 9: 0 chunks
INFO:SkyLight Pass 10: 0 chunks
INFO:SkyLight Pass 11: 0 chunks
INFO:SkyLight Pass 12: 0 chunks
INFO:SkyLight Pass 13: 0 chunks
INFO:Completed in 0:00:02.024000, 0:00:00.337333 per chunk
INFO:Saved 20 chunks
World4>
Something went wrong with that request. Please try again.