minecraft-pi is a low-level interface to the Minecraft Pi Edition API for Ruby. It covers the known API, and should map directly to the documentation included with MCPI (minus the bits that are python-specific).

• All methods have Contracts defined, and conform to them.
• Where appropriate, most methods have automatic retry behaviour.
• The undocumented Entity API is supported, making it easier to work with multiplayer sessions.

minecraft-pi is tested with the official 0.1.1 release, and the unofficial 0.6.1 patches.

gem install minecraft-pi

The following code will set the block at the host player’s feet to pink wool:

require 'minecraft-pi'

mc = MinecraftPi::Client.new

x, y, z = mc.player.getPos

mc.world.setBlockWithData x, y-1, z, 35, 6

See the documentation for more information.

• EventsBlock#hits has been observed to cause crashes with some patched versions of MCPI. This has been observed on a client with community-provided patches applied, enabling surivival mode and fullscreen support. This does not occur with the official 0.1.1 release.

The minecraft-pi gem is available under the MIT License. See LICENSE.txt for the full text.

• Chris Olstrom | e-mail | Twitter