Code CI Docs CI Test Coverage Latest PyPI version Apache License

Minecraft Interactive World Builder#

This project is intended as a fun way to learn the Python Programming Language.

Experienced Python programmers can also use this library to create Minecraft worlds with interactive Python features.

Quick Start#

To get started learning Python, see Introduction

For existing Python developers, see API documentation

Example Build#

The pagoda and castle with working portcullis were all created programmatically with Python and the current version of MCIWB.

castle

Example Build#

Goals#

Minecraft Interactive World Builder’s goals are:

  • Use Python to create anything inside of Minecraft worlds.

  • Call Python code when events occur inside the world.

  • Use an iPython prompt to interact with the world by typing Python commands

  • Have your player inside the world execute Python code by placing command signs or activating switches/levers with Python actions.

All instructions on how to set up a Minecraft Server and the Python developer environment are included. There are step by step tutorials to introduce Python Programming and the features of Minecraft Interactive World Builder.

Note

This is a work in progress. There are now enough tutorials to learn the fundamentals of Python and enough functionality to have some fun interacting with Minecraft from Python code.

I will continue to expand the tutorials and add more features to the library.

Credits#

This project would not be possible without mcipc, which provides the client library for Minecraft RCON.

How the documentation is structured#

The documentation is split into 2 sections:

The User Guide contains documentation on how to install and use mciwb.

The Developer Guide contains documentation on how to develop and contribute changes back to mciwb.