Python minecraft client library
Python Shell



Minecraft Python Client Library!

This projects aims to be a modern, Python3-compatible, well-documented library for communication with a MineCraft server.

Detailed information for developers can be found here: is a basic example of a headless client using the library Use --help for the options.

Python version

We aim to be compatible with the following python versions:

  • Python 2.7
  • Python 3.3
  • Python 3.4
  • Python 3.5
  • PyPy


The requirements are also stored in requirements.txt

See the installation instructions for the cryptography library here: but essentially pip install -r requirements.txt should cover everything.


This project currently has 2 main developers, Ammar Askar and Jeppe Klitgaard.


The preferred method of communication is via this GitHub page.


We can be contacted by mail:


We can often be found on the minecraftdev IRC on

We go by the names of ammar2 and dkkline.