Skip to content
Python library that implements the Minecraft network protocol and data types
Python Shell
Branch: master
Clone or download
barneygale Merge pull request #73 from LavaPower/master
Bug Fix : Y is not used in position packing
Latest commit 51f6036 Oct 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
ci Add bitstring to travis install script. Sep 23, 2019
docs Update docs Sep 29, 2019
examples Fix some broken examples Apr 25, 2019
quarry Bug Fix : Y is not used in position packing Oct 21, 2019
tests Further revise chunk implementation. Sep 29, 2019
.gitignore Update .gitignore Mar 9, 2019
CHANGES.rst Update changelog Oct 3, 2019
COPYING.txt Add Aug 1, 2015 Identify packets by name, rather than number. Aug 5, 2015
README.rst Drop support for Python 3.4 Sep 24, 2019
requirements.txt Add requirements.txt Apr 22, 2017 Rework `BlockArray` to use `bitstring.BitArray` Sep 23, 2019


Quarry: a Minecraft protocol library

Latest version released on PyPi Documentation Travis CI current build results

Quarry is a Python library that implements the Minecraft protocol. It allows you to write special purpose clients, servers and proxies.


Use pip to install quarry:

$ pip install quarry


  • Supports Minecraft versions 1.7 through 1.14.4
  • Supports Python 2.7 and 3.5+
  • Built upon twisted and cryptography
  • Exposes base classes and hooks for implementing your own client, server or proxy
  • Implements many Minecraft data types, such as NBT, Anvil, chunk sections, command graphs and entity metadata
  • Implements the design of the protocol - packet headers, modes, compression, encryption, login/session, etc.
  • Implements all packets in "init", "status" and "login" modes
  • Does not implement most packets in "play" mode - it is left up to you to hook and implement the packets you're interested in
You can’t perform that action at this time.