martinohanlon / CanaryRaspberryJuice

A canarymod plugin to replicate the minecraft: pi edition api

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

This repository and project has now been archived and is no longer supported. The code will remain available for reference and information.


Raspberry Juice for Canarymod Martin O'Hanlon (martin@ohanlonweb.com) http://www.stuffaboutcode.com

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

Migrated from the RaspberryJuice bukkit plugin. Original work by zhuowei

https://github.com/zhuowei/RaspberryJuice

http://dev.bukkit.org/bukkit-plugins/raspberryjuice/

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

About

A canarymod plugin to replicate the minecraft: pi edition api

License:MIT License


Languages

Language:HTML 70.8%Language:Java 14.3%Language:Python 12.6%Language:CSS 2.3%