A canarymod plugin to replicate the minecraft: pi edition api
HTML Java Python CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Raspberry Juice for Canarymod Martin O'Hanlon (martin@ohanlonweb.com)


RaspberryJuice - A Canarymod plugin which implements the Minecraft Pi Socket API.

Migrated from the RaspberryJuice bukkit plugin. Original work by zhuowei



Features currently supported:

  • world.get/setBlock
  • world.getBlockWithData
  • world.setBlocks
  • world.getPlayerIds
  • world.getBlocks
  • chat.post
  • events.clear
  • events.block.hits
  • player.getTile
  • player.setTile
  • player.getPos
  • player.setPos
  • world.getHeight
  • entity.getTile
  • entity.setTile
  • entity.getPos
  • entity.setPos

Features that can't be supported:

  • Camera angles

Extra features(**):

  • getBlocks(x1,y1,z1,x2,y2,z2) has been implemented
  • getDirection, getRotation, getPitch functions - get the 'direction' players and entities are facing
  • getPlayerId(playerName) - get the entity of a player by name
  • pollChatPosts() - get events back for posts to the chat
  • multiplayer support
    • name added as an option parameter to player.
    • modded minecraft.py in python api library so player "name" can be passed on Minecraft.create(ip, port, name)
    • this change does not stop standard python api library being used
  • the default tcp port can be changed in config/CanaryRaspberryJuicePlugin/CanaryRaspberryJuicePlugin.cfg

** to use the extra features an modded version of the java and python libraries that were originally supplied by Mojang with the Pi is required, https://github.com/martinohanlon/CanaryRaspberryJuice/tree/master/resources/mcpi. You only need the modded libraries to use the extra features, the original libraries still work, you just wont be able to use the extra features

** please note extra features are NOT guaranteed to be maintained in future releases, particularly if updates are made to the original Pi API which replace the functionality

Version history

  • 0.1 - Initial stable version
  • 1.0 - First release. Tested extensively with Canarymod 1.7.10-1.1.2
  • 1.0.1 - Minor bug fix
  • 1.0.2 - Recreated with Java 1.6
  • 1.1 - Implemented entity functions
  • 1.2 - added getPlayerId(playerName), getDirection, getRotation, getPitch
  • 1.3 - added pollChatPosts() & block update performance improvements