minecraft-python 0.0.23a1

A project that seeks to recreate every old Minecraft version in Python using Pyglet and Cython.

Minecraft: Python Edition

Minecraft: Python Edition is a project that strives to recreate each and every old Minecraft version in Python 3 using the Pyglet multimedia library and Cython for performance.

This project is currently recreating the Multiplayer Classic versions of Minecraft. The latest version is Classic 0.0.23a_01 as released on July 11, 2009.

Learn more about this version here.

Or the server version here.

This project is organized so that every commit is strictly the finished Python version of the Java game of the same version number. This means that you can go back into this repository's commit history and see only the source code changes between versions of Minecraft, or you can compare branches and see the changes made between them. For any version this project covers, you can play it just by specifying the Minecraft version you want to play in the pip install command as demonstrated below.

General Usage

Pyglet, Cython, Pillow, and PyOgg are required dependencies and can easily be installed with pip. Use the versions specified in requirements.txt.

This version features block sounds and music, and for audio to work you need either PyOgg which is recommended, or FFmpeg which is installed on the system. GStreamer is also supported on Linux through the gst-python library. PyOgg requires that your system have one of the Opus, FLAC, or Vorbis codecs. OpenAL is required.

To easily install this version of Minecraft: Python Edition, just run python -m pip install minecraft-python==0.0.23a_01.

Alternatively, for a manual Cython build, run python setup.py build_ext --inplace.

Run python -m mc.net.minecraft.Minecraft to launch the game. Minecraft: Python Edition should be compatible with any modern platform that supports OpenGL and Cython.

Run with the argument -fullscreen to open the window in fullscreen mode.

Gameplay

This version features multiplayer, chat, caves, beaches, hill terrain, infinite liquid tiles, level saving, options, and human mobs.

Press B to open the inventory menu, G to spawn a human mob. Press Esc to pause and see other controls.

Multiplayer

To launch the multiplayer game, run python -m mc.net.minecraft.Minecraft -server <host:port> -user <username> -mppass [password].

Press Tab in-game to view connected players.

To host a server, follow the instructions in the README.TXT file in the server directory. Make sure verify-names is set to false in the server properties.

Additional Notes

The mc.resources directory contains all of the textures and sounds that this version uses. However, the textures are only there for convenience, as all of the texture buffers are already preloaded in the mc.Resources module.

The server directory contains the unmodified, original Minecraft server build for this version.

This would have been much more challenging to work on without the great tools provided by RetroMCP-Java.