Need help with pyCraft?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

ammaraskar
517 Stars 151 Forks Other 464 Commits 54 Opened issues

Description

Minecraft-client networking library in Python

Services available

!
?

Need anything else?

Contributors list

pyCraft

.. image:: https://travis-ci.org/ammaraskar/pyCraft.svg?branch=master :target: https://travis-ci.org/ammaraskar/pyCraft .. image:: https://readthedocs.org/projects/pycraft/badge/?version=latest :target: https://pycraft.readthedocs.org/en/latest .. image:: https://coveralls.io/repos/ammaraskar/pyCraft/badge.svg?branch=master :target: https://coveralls.io/r/ammaraskar/pyCraft?branch=master

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:

_.

start.py
is a basic example of a headless client using the library Use
start.py --help
for the options.

Supported Minecraft versions

pyCraft is compatible with the following Minecraft releases:

  • 1.8, 1.8.1, 1.8.2, 1.8.3, 1.8.4, 1.8.5, 1.8.6, 1.8.7, 1.8.8, 1.8.9
  • 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4
  • 1.10, 1.10.1, 1.10.2
  • 1.11, 1.11.1, 1.11.2
  • 1.12, 1.12.1, 1.12.2
  • 1.13, 1.13.1, 1.13.2
  • 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4
  • 1.15, 1.15.1, 1.15.2
  • 1.16, 1.16.1, 1.16.2

In addition, some development snapshots and pre-release versions are supported:

_ contains a full list of supported Minecraft versions
and corresponding protocol version numbers.

Supported functionality

Although pyCraft is compatible any supported server, only a subset of all packets are currently decoded or encoded by the library: those necessary to remain connected to the server, those used for chat, and some others.

Developers wishing to use other functionality with pyCraft can contribute by implementing packet classes for the desired packets, adding them under

_, and sending a pull request.

Supported Python versions

pyCraft is compatible with (at least) the following Python implementations:

  • Python 3.5
  • Python 3.6
  • Python 3.7
  • Python 3.8
  • PyPy

Requirements

  • cryptography 
    _
  • requests 
    _
  • PyNBT 
    _

The requirements are also stored in

setup.py

See the installation instructions for the cryptography library here:

_
but essentially 
pip install -r requirements.txt
should cover everything.

Contact

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

GitHub ^^^^^^ The preferred method of communication is via this GitHub page.

Mail ^^^^ We can be contacted by mail:

IRC ^^^ We can often be found on the

minecraftdev
IRC on
irc.esper.net 
_

We go by the names of

ammar2
and
dkkline
.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.