This repository has been archived on 2024-06-13. You can view files and clone it, but cannot push or open issues or pull requests.

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.

Read mclevel.py to get started.




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:
       mce <world> clone <sourcePoint> <sourceSize> <destPoint>
       mce <world> fill <blockType> <destPoint> <destSize>
       mce <world> replace <blockType> [with] <withBlockType> <destPoint> <destS
ize>
       
       mce <world> export <filename> <sourcePoint> <sourceSize>
       mce <world> import <filename> <destPoint>
       
       mce <world> player <player> <point>
       mce <world> spawn <point>
       
       mce <world> createChunks <startChunk> <chunkSize>
       mce <world> deleteChunks <startChunk> <chunkSize>
       mce <world> prune <startChunk> <chunkSize>
       mce <world> relight <startChunk> <chunkSize>
       
    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 to specify a point. 
    Use the keyword 'delta' to specify a point near a player. e.g.
    
       mce clone codewarrior 5 5 5 codewarrior delta 10 0 0
    
    In this command:
       'codewarrior' is the source point, 
       '5 5 5' is the size of the source box, and 
       'codewarrior delta 10 0 0' means 10 blocks south of me.
       
       
    
Please enter world number or path to world folder: 3
Identifying  C:\Users\Rio\AppData\Roaming\.minecraft\saves\World3\level.dat
Detected Infdev level.dat
Saved 0 chunks
Scanning for chunks...
World3> fill 20 Player delta -10 0 -10 20 20 20

Filled 8000 blocks.
World3> player Player

Player Player: [-1.7053128706213856, 62.620000004768372, 88.666301260713084]

World3> player Player Player delta 0 25 0

Moved player Player to (-1.7053128706213856, 87.620000004768372, 88.666301260713
084)
World3> save

Saved 6 chunks
World3> 

Description
Minecraft Levels for Python
Readme 10 MiB
Languages
MAXScript 80.1%
Python 19.1%
Cython 0.8%