2015-04-01 18:44:21 +02:00
|
|
|
pyCraft
|
|
|
|
|
=======
|
2015-04-15 22:09:42 +02:00
|
|
|
.. image:: https://travis-ci.org/ammaraskar/pyCraft.svg?branch=master
|
2015-04-03 00:53:13 +02:00
|
|
|
:target: https://travis-ci.org/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:
|
|
|
|
|
|
|
|
|
|
* 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.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
|
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.
|
|
|
|
|
|
|
|
|
|
Developers wishing to use other functionality with pyCraft can contribute
|
|
|
|
|
by implementing the desired packets in `<minecraft/networking/packets.py>`_
|
|
|
|
|
and sending a pull request.
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
* Python 2.7
|
|
|
|
|
* Python 3.3
|
|
|
|
|
* Python 3.4
|
2016-06-18 20:23:30 +02:00
|
|
|
* Python 3.5
|
2017-03-31 14:16:35 +02:00
|
|
|
* Python 3.6
|
2015-04-05 22:32:17 +02:00
|
|
|
* PyPy
|
2015-04-01 18:44:21 +02:00
|
|
|
|
|
|
|
|
Requirements
|
|
|
|
|
------------
|
2015-04-07 19:08:09 +02:00
|
|
|
- `cryptography <https://github.com/pyca/cryptography#cryptography>`_
|
|
|
|
|
- `requests <http://docs.python-requests.org/en/latest/>`_
|
2016-06-17 14:54:24 +02:00
|
|
|
- `future <http://python-future.org/>`_
|
2015-04-07 19:08:09 +02:00
|
|
|
|
|
|
|
|
The requirements are also stored in ``requirements.txt``
|
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``.
|
