mirror of
https://github.com/ammaraskar/pyCraft.git
synced 2024-11-21 17:56:30 +01:00
Minecraft-client networking library in Python
55ff270f16
Removed unused import (SerializationError) We now check if Datatype.SIZE is a number using ABC. Added 2 decorators for raising serialized and deserialized data exceptions. Datatype.SIZE can now be either a number or a sequence. If sequence, first value is MIN_SIZE and second value is MAX_SIZE VarInt.serialize now raises ValueError instead of SerializationError when number is too big to serialize. |
||
|---|---|---|
| bin | ||
| docs | ||
| minecraft | ||
| tests | ||
| .gitignore | ||
| .travis.yml | ||
| LICENSE | ||
| MANIFEST.in | ||
| pylintrc | ||
| README.rst | ||
| requirements.txt | ||
| setup.py | ||
| start.py | ||
| tox.ini | ||
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:
`<http://pycraft.readthedocs.org/en/latest/>`_.
``start.py`` is a basic example of a headless client using the library
Use ``start.py --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
* PyPy
Requirements
------------
- `cryptography <https://github.com/pyca/cryptography#cryptography>`_
- `requests <http://docs.python-requests.org/en/latest/>`_
The requirements are also stored in ``requirements.txt``
See the installation instructions for the cryptography library here: `<https://cryptography.io/en/latest/installation/>`_
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:
* 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``.