Manipulate Minecraft on the Raspberry Pi from Julia
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Control a Minecraft world on the Minecraft: Pi or Java edition from Julia

Installation and Usage

Get Minecraft

  • The Minecraft: Pi edition is pre-installed on all Rasbian since September 2014. Launch it by navigating to Menu > Games or typing minecraft-pi in the terminal. However, if you are running an older version of Raspbian get it here.
  • Get the Minecraft: Java edition(MacOS, Linux and Windows) here.

Get RaspberryJuice or RaspberryJamMod (for Minecraft: Java edition)

Officially the ability to communicate with the Minecraft world is only available for the Minecraft: Pi edition. To get this to work on the Java edition we need to install a Mod.

  • "RaspberryJamMod" is a Forge Mod, if you wish to use this along with other Forge mods then this is recommended. Installation instructions are available here.
  • "RaspberryJuice" is a Bukkit server plugin, recommended if you wish to work on a Bukkit Minecraft server. Get it here.

Get Julia

Download the appropriate Julia version for your system from here.

Install the PiCraft packge



Documentation for this package can be accessed at

Quick Start Guide

Load the PiCraft package on the Julia console:

using PiCraft

On load, the library will attempt to connect to a running Minecraft world on localhost. If Minecraft is not running, an error message will be printed. Subsequently, once Minecraft has been started, a connection can be forced by calling connectToWorld()

You can save and restore your progress using the commands:

  1. Save: save()
  2. Load last savepoint: restore()

A 3-D coordinate system is used to describe the Minecraft world. Throughout this package we describe a set of coordinates using a Tuple of numbers, for example (3.5, 19, 7) describes a position in the Minecraft World. The 2nd attribute of the Tuple describes the y-axis or height. When in game it is convenient to find the player's coordinates by opening the debug menu.


You can find and set your player's location:

  1. Find Player position: getPos()
    • Returns a Tuple{Float64, Float64, Float64} which contains the player's current coordinates.
  2. Set Player position: setPos(pos::Tuple{Float64, Float64, Float64})
    • Teleports the player to the specified coordinates.


Blocks are the heart of Minecraft. The package provides the ability to modify blocks at specified coordinates. Block is an immutable datatype defined in src/blocks.jl.

immutable Block

The id defines the type of block (like cobblestone, wool, wood,.etc) and the data attribute defines additional characteristics of the block, on default every block has it data set to 0. For example, Wool's block id is 35, Block(35,0) refers to a block of white wool. Different wool colors can be accessed by changing the data attribute. Red Wool is Block(35, 14), Pink Wool is Block(35,6) and so on. A complete reference can be found in the documentation.

  1. Place Block: setBlock(Tuple{Int,Int,Int}, block::Picraft.Block)
    • Place the specified Block at the specified coordinates.
  2. Place Blocks: setBlocks(pos::Tuple{UnitRange{Int}, UnitRange{Int}, UnitRange{Int}}, block::PiCraft.Block)
    • Place the specified block in the entire region described by the unit range.
  3. Get Block information: getBlock(Tuple{Int,Int,Int})
    • Returns the block present at the specified coordinates.

While the getBlock and setBlock functions will accept Float64 as arguments these will be rounded and set to Int as a block cannot be placed on non-integer coordinates.


getBlock(Tuple{Int,Int,Int}) # retrive a Block object at the specified coordinates
setBlock(Tuple{Int,Int,Int}, block::Picraft.Block) #set the specified Block to these coordinates
setBlocks(pos::Tuple{UnitRange{Int}, UnitRange{Int}, UnitRange{Int}}, block::PiCraft.Block) #set a block to an entire region
getHeight(x::Int, z::Int) #Get the height of the world at the specified `x` and `z` coordinates.
getPlayerIds() # Return an array of all Player Id's connected to the server.
setting(name, status) #Change a setting
save() #save the current world state
restore() #restore the world to the previouly saved world state
post(s::string) #send string s to chat
getTile() # return a tuple of integers (x, y, z),  for the tile on which the player is placed
setTile(pos::Tuple{Real, Real, Real}) # move the player to the tile specified by the integer coordinates
getPos() # return a tuple of floats (x, y, z) with the player's position
setPos(pos::Tuple{Real, Real, Real}) # move the player to the specified coordinates
pollBlockHits() #Return an Array of hit events. ((x,y,z), faceId, entityId)