Minecraft-client networking library in Python
Go to file
Ammar Askar ba70a169e3 Just buffer data when reading packets.
As of this commit, the rewrite is complete and pyCraft is back to a usable state
2015-03-22 17:39:15 +05:00
authentication Documentation with sphinx 2015-03-22 03:08:44 +05:00
docs Update arbitrary request example to follow better practices 2015-03-22 03:44:45 +05:00
network Just buffer data when reading packets. 2015-03-22 17:39:15 +05:00
.gitignore Documentation with sphinx 2015-03-22 03:08:44 +05:00
LICENSE Licensed under Apache License, Version 2.0 2012-10-10 14:29:32 +05:00
README.md readthedocs link in README 2015-03-22 03:22:36 +05:00
requirements.txt Significant headway on the rewrite. 2015-03-17 22:15:27 +05:00
start.py Significant headway on the rewrite. 2015-03-17 22:15:27 +05:00

pyCraft

Minecraft Python Client!

http://pycraft.readthedocs.org/en/latest/

When running start.py, make sure you duck.

#Requirements

  • pyCrypto 2.5 (Also in requirements.txt)

##PyCrypto on Windows Systems (32 bit) If you use Python 2.7 with win32 you're in luck, theres an installer right here for pyCrypto 2.5 otherwise you're gonna need to compile it, followed by some fancy instructions on how to install pyCrypto over here


On linux you'll need the build-essential and python-dev packages after which running pip install -r requirements.txt, should pull everything in.

Eventually we'll put some run instructions here but start.py --help should cover everything for now

#Writing Plugins for pyCraft pyCraft has some basic plugin support, as a developer making plugins is a simple process. In the plugins folder, simply create a .py file with your plugin's name as the file name. In your plugin.py file define a single class with the exact same spellings as your plugin file name. Now within your plugin class you'll be notified using certain methods when things happen in the minecraft world. See the PacketDumper plugin as an example. Currently these methods are used:

onEnable(self, parser, pluginloader) This fires when your plugin is loaded and passes the option parser as an argument allowing you to add custom command line options

onDisable(self) This fires when pyCraft is exited cleanly, use it for cleaning up

optionsParsed(self, parsedOptions) This fires when command line options have been parsed allowing you to get information from any parameters you may have added in onEnable

packetReceive(self, packetID, receivedPacket) This fires when pyCraft's networking core receives a packet