UNMAINTAINED: Reverse-engineered Minecraft stuff. Worked with 1.4.x protocol
Bravo is a elegant, speedy, and extensible implementation of the Minecraft Alpha/Beta/"Modern" protocol. Only the server side is implemented. Bravo also has a few tools useful for examining the wire protocols and disk formats in Minecraft.
IP ban list
Bravo currently requires Python 2.6 or any newer Python 2.x. It is known to work on CPython and PyPy.
Bravo ships with a standard setup.py. You will need setuptools/distribute, but most distributions already provide it for you. Bravo depends on the following external libraries from PyPI:
If installing modular Twisted, Twisted Conch is required.
For IRC support, Twisted Words is required; it is usually called python-twisted-words or twisted-words in package managers.
For web service support, Twisted Web must be installed; it is generally called python-twisted-web or twisted-web.
Windows is no longer directly supported. Though if python and dependencies are installed, it should work just fine. Due note, as of this writing, Twisted only supports Win32 so make sure to only use Win32 python packages.
Debian and its derivatives, like Ubuntu, have Twisted in their package managers.
$ sudo aptitude install python-twisted
If you are tight on space, you can install only part of Twisted.
$ sudo aptitude install python-twisted-core python-twisted-bin python-twisted-conch
A Note about Ubuntu ^^^^^^^^^^^^^^^^^^^
If you are using Ubuntu 10.04 LTS, you will need a more recent Twisted than Ubuntu provides. There is a PPA at http://launchpad.net/~twisted-dev/+archive/ppa which provides recent versions of all Twisted packages.
Twisted can be installed from the standard Fedora repository.
$ sudo yum install python-twisted python-twisted-conch
Gentoo does carry a Construct new enough for Bravo, but it does have to be unmasked.
# emerge twisted twisted-conch
If, for some reason, you are installing to a very raw or unmanaged place, and you want to ensure that everything is built from the latest source available on PyPI, we highly recommend pip for installing Bravo, since it handles all dependencies for you.
$ pip install Bravo
Bravo can also optionally use Ampoule to offload some of its inner calculations to a separate process, improving server response times. Ampoule will be automatically detected and is completely optional.
$ pip install ampoule
Bravo includes a twistd plugin, so it's quite easy to run. Just copy bravo.ini.example to bravo.ini, and put it in one of these locations:
And then run the Twisted plugin:
$ twistd -n bravo
Contributing is easy! Just send me your code. Diffs are appreciated, in git format; Github pull requests are excellent.
Things to consider:
The FAQ moved to readthedocs; see http://bravo.readthedocs.org/en/latest/introduction.html#q-a.
Bravo is MIT/X11-licensed. See the LICENSE file for the actual text of the license.