https://github.com/gilesknap/mciwb

Minecraft Interactive world builder
https://github.com/gilesknap/mciwb

docker learn-to-code learning-python minecraft minecraft-server python

Last synced: about 1 year ago
JSON representation

Minecraft Interactive world builder

• Host: GitHub
• URL: https://github.com/gilesknap/mciwb
• Owner: gilesknap
• License: apache-2.0
• Created: 2021-10-24T17:09:16.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-03-11T10:04:59.000Z (over 1 year ago)
• Last Synced: 2025-04-07T21:12:39.101Z (about 1 year ago)
• Topics: docker, learn-to-code, learning-python, minecraft, minecraft-server, python
• Language: Python
• Homepage:
• Size: 57.4 MB
• Stars: 302
• Watchers: 6
• Forks: 6
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![CI](https://github.com/gilesknap/mciwb/actions/workflows/ci.yml/badge.svg)](https://github.com/gilesknap/mciwb/actions/workflows/ci.yml)

[![Coverage](https://codecov.io/gh/gilesknap/mciwb/branch/main/graph/badge.svg)](https://codecov.io/gh/gilesknap/mciwb)

[![PyPI](https://img.shields.io/pypi/v/mciwb.svg)](https://pypi.org/project/mciwb)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

# mciwb

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.

Source          | 

:---:           | :---:

PyPI            | pip install mciwb

Documentation   | 

Releases        | 

Quick Start

-----------

To get started learning Python, see

[Introduction](https://gilesknap.github.io/mciwb/main/user/tutorials/00-prereq.html)

For existing Python developers, see

[API documentation](https://gilesknap.github.io/mciwb/main/user/reference/api.html)

Example Build

-------------

The pagoda and castle with working portcullis were all created programmatically

with Python and the current version of MCIWB.

https://github.com/gilesknap/mciwb/assets/964827/026b3551-f514-403a-bebe-8d168c7170b0

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](https://github.com/conqp/mcipc/),

which provides the client library for Minecraft RCON.

See https://gilesknap.github.io/mciwb for more detailed documentation.