Skip to content
MCEdit, Minecraft World Editor 1.0 - no longer developed. See website for version 2.0
Branch: master
Clone or download
Latest commit 8dcbd4f Aug 25, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
albow Added scrollable menus to albow, and set them as a default for Choice… Apr 25, 2013
doc/images Initial open source release. Feb 14, 2012
filters Update - Thanks to reddit user `luci999` Oct 8, 2013
pymclevel @ 8bf7b3d
stock-schematics Initial open source release. Feb 14, 2012
.gitignore Ignore ENV32, virtualenv for 32-bit python on 64-bit windows Jan 1, 2013
.gitmodules Changed submodule to point to /mcedit/pymclevel Feb 16, 2012
LICENSE.txt Initial open source release. Feb 14, 2012
README.html Update README.html Apr 7, 2013
code i love you Aug 23, 2015
favicon.png Initial open source release. Feb 14, 2012 pep8 compliance: E302 expected 2 blank lines Feb 20, 2012 Added a compass. Oct 7, 2013
gui.png Added a compass. Oct 7, 2013
mcedit.icns Added OS X app icon. Mar 13, 2012
mcedit.ico Initial open source release. Feb 14, 2012 Suppress unicode error in squash_python (due to formatting os.environ… May 22, 2013 Added a compass. Oct 7, 2013 Normalized line endings Oct 25, 2012 Minor transparency update Feb 21, 2014
requirements.txt OpenGL: Take advantage of PyOpenGL 3.0.2 Nov 20, 2012
terrain-classic.png Initial open source release. Feb 14, 2012
terrain-pocket.png Pocket: New terrain.png Mar 11, 2014


MCEdit is an open-source, BSD-licenced world editor for the viral indie hit Minecraft. For downloads and update info, visit the official website at The rest of this file is intended for computer programmers and Linux users.

Running from source

MCEdit is written in Python using a variety of open source modules. When developing it is recommended to use virtualenv to keep dependencies sane and for easy deployment. You'll need Python 2.7 and easy_install/pip at a minimum before getting started. This quick guide assumes a unix-y OS.

Clone MCEdit:

git clone --recursive

Or, if you've already cloned MCEdit in the past and need to update, go to the existing source folder:

git pull --recurse-submodules

Optionally (but highly recommended), setup and activate virtualenv. virtualenv will simplify development by creating an isolated and barebones Python environment. Anything you install while virtualenv is active won't affect your system-wide Python installation, for example.

cd mcedit
easy_install virtualenv
virtualenv ENV
. ENV/bin/activate

Install various dependencies. This may take a bit (especially numpy). If installing pygame errors, try installing from a binary packages or following one of the guides from that page to install from source. On Windows, easy_install is preferred because it installs prebuilt binary packages. On Linux and Mac OS X, you may want to use pip install instead.

easy_install PyOpenGL
easy_install numpy
easy_install pygame
easy_install pyyaml

Ubuntu Linux users can install the following packages via apt-get to grab all the dependencies easily and install them into the system python. This also downloads all libraries required to build these modules using pip install

apt-get install python-opengl python-pygame python-yaml python-numpy

You should now be able to run MCEdit with python assuming you've installed all the dependencies correctly.

You can’t perform that action at this time.