2015-04-01 18:44:21 +02:00
|
|
|
pyCraft
|
|
|
|
|
=======
|
2021-12-16 19:39:13 +01:00
|
|
|
.. image:: https://app.travis-ci.com/ammaraskar/pyCraft.svg?branch=master
|
|
|
|
|
:target: https://app.travis-ci.com/github/ammaraskar/pyCraft
|
2015-04-03 01:58:26 +02:00
|
|
|
.. image:: https://readthedocs.org/projects/pycraft/badge/?version=latest
|
|
|
|
|
:target: https://pycraft.readthedocs.org/en/latest
|
2015-04-03 01:02:06 +02:00
|
|
|
.. image:: https://coveralls.io/repos/ammaraskar/pyCraft/badge.svg?branch=master
|
|
|
|
|
:target: https://coveralls.io/r/ammaraskar/pyCraft?branch=master
|
2015-04-03 00:31:58 +02:00
|
|
|
|
|
|
|
|
|
2015-04-01 18:44:21 +02:00
|
|
|
Minecraft Python Client Library!
|
|
|
|
|
|
2015-04-05 22:32:17 +02:00
|
|
|
This projects aims to be a modern, Python3-compatible, well-documented library for
|
|
|
|
|
communication with a MineCraft server.
|
|
|
|
|
|
2015-04-01 18:44:21 +02:00
|
|
|
Detailed information for developers can be found here:
|
2015-04-05 22:32:17 +02:00
|
|
|
`<http://pycraft.readthedocs.org/en/latest/>`_.
|
2015-04-01 18:44:21 +02:00
|
|
|
|
|
|
|
|
``start.py`` is a basic example of a headless client using the library
|
2015-04-05 22:32:17 +02:00
|
|
|
Use ``start.py --help`` for the options.
|
|
|
|
|
|
2017-04-16 06:06:12 +02:00
|
|
|
Supported Minecraft versions
|
|
|
|
|
----------------------------
|
|
|
|
|
pyCraft is compatible with the following Minecraft releases:
|
|
|
|
|
|
2018-01-13 02:03:04 +01:00
|
|
|
* 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
|
2017-04-16 06:06:12 +02:00
|
|
|
* 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
|
2017-09-20 00:30:51 +02:00
|
|
|
* 1.12, 1.12.1, 1.12.2
|
2018-10-26 20:46:13 +02:00
|
|
|
* 1.13, 1.13.1, 1.13.2
|
2019-07-26 09:09:47 +02:00
|
|
|
* 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4
|
2020-01-23 18:02:10 +01:00
|
|
|
* 1.15, 1.15.1, 1.15.2
|
2021-12-16 19:39:13 +01:00
|
|
|
* 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5
|
|
|
|
|
* 1.17, 1.17.1
|
|
|
|
|
* 1.18, 1.18.1
|
2017-04-16 06:06:12 +02:00
|
|
|
|
|
|
|
|
In addition, some development snapshots and pre-release versions are supported:
|
|
|
|
|
`<minecraft/__init__.py>`_ 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.
|
|
|
|
|
|
2018-05-26 21:49:01 +02:00
|
|
|
Developers wishing to use other functionality with pyCraft can contribute by
|
|
|
|
|
implementing packet classes for the desired packets, adding them under
|
|
|
|
|
`<minecraft/networking/packets>`_, and sending a pull request.
|
2017-04-16 06:06:12 +02:00
|
|
|
|
|
|
|
|
Supported Python versions
|
|
|
|
|
-------------------------
|
2017-04-17 12:07:22 +02:00
|
|
|
pyCraft is compatible with (at least) the following Python implementations:
|
2015-04-05 22:32:17 +02:00
|
|
|
|
2016-06-18 20:23:30 +02:00
|
|
|
* Python 3.5
|
2017-03-31 14:16:35 +02:00
|
|
|
* Python 3.6
|
2020-01-08 15:54:45 +01:00
|
|
|
* Python 3.7
|
|
|
|
|
* Python 3.8
|
2021-12-16 19:39:13 +01:00
|
|
|
* Python 3.9
|
2015-04-05 22:32:17 +02:00
|
|
|
* PyPy
|
2015-04-01 18:44:21 +02:00
|
|
|
|
|
|
|
|
Requirements
|
|
|
|
|
------------
|
2018-05-26 21:49:01 +02:00
|
|
|
- `cryptography <https://github.com/pyca/cryptography#cryptography>`_
|
2015-04-07 19:08:09 +02:00
|
|
|
- `requests <http://docs.python-requests.org/en/latest/>`_
|
2020-08-17 11:31:02 +02:00
|
|
|
- `PyNBT <https://github.com/TkTech/PyNBT>`_
|
2015-04-07 19:08:09 +02:00
|
|
|
|
2020-02-18 16:22:31 +01:00
|
|
|
The requirements are also stored in ``setup.py``
|
2015-04-01 18:44:21 +02:00
|
|
|
|
|
|
|
|
See the installation instructions for the cryptography library here: `<https://cryptography.io/en/latest/installation/>`_
|
2015-04-03 00:31:58 +02:00
|
|
|
but essentially ``pip install -r requirements.txt`` should cover everything.
|
2015-04-05 22:32:17 +02:00
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
* Ammar Askar `ammar@ammaraskar.com <mailto:ammar@ammaraskar.com>`_
|
|
|
|
|
* Jeppe Klitgaard `jeppe@dapj.dk <mailto:jeppe@dapj.dk>`_
|
|
|
|
|
|
|
|
|
|
IRC
|
|
|
|
|
^^^
|
|
|
|
|
We can often be found on the ``minecraftdev`` IRC on
|
|
|
|
|
`irc.esper.net <https://www.esper.net/>`_
|
|
|
|
|
|
|
|
|
|
We go by the names of ``ammar2`` and ``dkkline``.
|
