Find file
Fetching contributors…
Cannot retrieve contributors at this time
41 lines (28 sloc) 1.41 KB


Burger is a "framework" for automatically extracting data from the Minecraft game for the purpose of writing the protocol specification, interoperability, and other neat uses.

The Idea

Burger is made up of toppings, which can provide and satisfy simple dependencies, and which can be run all-together or just a few specifically. Each topping is then aggregated by into the whole and output as a JSON dictionary.


The simplest way to use Burger is to pass the -d or --download flag, which will download the minecraft client for you.

$ python --download

Alternatively, you can specify the client JAR by passing it as an argument.

$ python 1.8.jar

You can redirect the output from the default stdout by passing -o <path> or --output <path>.

$ python -d --output output.json

You can see what toppings are available by passing -l or --list.

$ python --list

You can also run specific toppings by passing a comma-delimited list to -t or --toppings. If a topping cannot be used because it's missing a dependency, it will output an error telling you what also needs to be included. Toppings will generally automatically load their dependencies, however.

$ python -d --toppings language,stats

The above example would only extract the language information, as well as the stats and achievements (both part of stats).