An easy-to-use, pure Python Minecraft protocol library, allowing you to connect to a server, encode & send, receive & decode packets.

For now it is not a work-in-progress, so it will frequently break and have breaking changes to its API. This is why it is not suitable for production use, and is not published on PyPi.

• Clone the repository: git clone https://github.com/EnzoPB/mc-protocol
• Navigate into the folder: cd mc-protocol
• Install the dependencies: pip install -r requirements.txt
• Clone the minecraft-data repository: git clone https://github.com/PrismarineJS/minecraft-data
  • Note: You will have to pull this repository for every new Minecraft version
• Start the example script: python main.py <username> <host> <port>

This package is using minecraft-data, so it should automatically be compatible with every version from 1.8, except:

• 1.19.1 and 1.19.2 because of some weird encryption protocol
• Since 1.20.2, because Mojang has made some big changes to the protocol (see the changelog, sections Network Optimization and Network Protocol). It will be implemented soon

These features are listed here because they will be implemented at one point

• Encryption
• Authentication
• Full type support
• 1.20.2+ protocol support

• The wiki.vg contributors, for all the very detailed documentation on the Minecraft protocol
• ammaraskar, for the pyCraft package, which helped me implement some types and functions in Python
• The PrismarineJS team, for the minecraft-data project
• SpockBotMC, for the python-minecraft-data package (see my fork here!)

MIT license