{"id":1717,"date":"2013-07-28T18:33:05","date_gmt":"2013-07-28T18:33:05","guid":{"rendered":"http:\/\/davstott.me.uk\/?p=1717"},"modified":"2014-04-19T19:07:51","modified_gmt":"2014-04-19T19:07:51","slug":"raspberry-pi-drawing-maps-inside-minecraft","status":"publish","type":"post","link":"https:\/\/davstott.me.uk\/index.php\/2013\/07\/28\/raspberry-pi-drawing-maps-inside-minecraft\/","title":{"rendered":"Raspberry Pi – drawing maps inside Minecraft"},"content":{"rendered":"

A python Ordnance Survey map viewer, drawn inside Minecraft, on a Raspberry Pi. Just what the world needs… This will also work for Minecraft drawing pretty much any small image, such as a mugshot from a webcam.<\/p>\n

\"Ordnance<\/a>

Ordnance Survey map inside Minecraft Pi edition<\/p><\/div>\n

<\/p>\n

This idea came to me after I attended the excellent Raspberry Jam in York the other month, a great presentation from Martin O’Hanlon<\/a> and after a chance remark from @charwarz<\/a> about drawing a rainbow inside Minecraft, Pi edition (hereafter MCPI). It’s really not all that complicated to do (although I might turn it into a full WMS viewer in the future) and it’s a good catalyst for illustrating how to interact with MCPI from Python and also a bit about image handling. It’s just taken me 6 weeks to find the time to write it up..<\/p>\n

The first step is to get your Raspberry Pi set up with Minecraft and the Python API to it. This is as straightforward as following the instructions at http:\/\/pi.minecraft.net\/<\/a> to download and extract the tarball. It’s worth noting that this does need X windows, so you’ll need to either plug in a display to your PI or set up a remote X server.<\/p>\n

Minecraft and Python API<\/h2>\n

MCPI has an easy to use protocol that listens on TCP socket 4711 by default, but we’ll be using the Python API to it because it saves us writing some not terribly interesting code.<\/p>\n

The API’s capabilities are defined in mcpi\/api\/spec\/mcpi_protocol_spec.txt, including a link to http:\/\/www.minecraftwiki.net\/wiki\/Data_values_(Pocket_Edition)<\/a> for the values for blockType and blockData (more on this later). It’s worth noting that the PI coordinate system is cartesian, but uses X and Z for its ground plane and Y is the vector towards the sky. The origin (0,0,0) is the spawn point. <\/p>\n

Once minecraft-pi is running in a window, we can open up a terminal window, run python, and make it do our bidding. To do that, fire up a terminal window and type:<\/p>\n

\r\n  pi@raspberrypi:~\/$ cd mcpi\/api\/python\r\n  pi@raspberrypi:~\/$ python\r\n  >>> import mcpi.minecraft\r\n  >>> # open the connection to minecraft\r\n  >>> mc = mcpi.minecraft.Minecraft.create()\r\n  >>> # make some text display in the chat log\r\n  >>> mc.postToChat(\"Hello World!\")\r\n  >>> # get the player's current position\r\n  >>> mc.player.getPos()\r\n  >>> # set the block at position (1,1,1) to stone\r\n  >>> mc.setBlock(1, 1, 1, 1) \r\n<\/pre>\n
This is only some of the API’s capabilities, but we can do an awful lot with just this, such as drawing and animating real objects, making games or making glass tiles appear at the player’s feet, allowing them to free run through mid-air.<\/p>\n
Image Quantising<\/h2>\n
This is the image we’re about to draw inside Minecraft. It’s from the Ordnance Survey’s 1:250,000 raster map<\/a>, which is licensed under the OS Opendata licence<\/a>. From a human point of view, this is a section of a map showing the North East of the city of York, but from a computer’s point of view, it’s a 200 pixel square collection of numbers that can be drawn as colours on a screen.<\/p>\n
\"OS<\/a>
OS 1:250,000 map of North East York.
Contains Ordnance Survey data \u00c2\u00a9 Crown copyright and database right 2013<\/p><\/div>\n
According to the GIMP, this image contains 6902 unique colours, which is going to be difficult to represent within Minecraft because it doesn’t have blocks that come in 6902 different colours. It does, however, come with a set of wool blocks that come in 16 unique colours, which should do the job nicely. <\/p>\n
To transform one into the other, we need the Python Imaging Library (PIL) to do some work for us, quantising the RGB image down to match our wool blocks.  To do this, it needs to have a palette defined to match each block to its RGB colour.<\/p>\n
One way of working out the exact colour value for, say, the Lime Green wool block (TileData 5) would be to fish out its sprite from mcpi\/data\/images\/terrain.png and then take an average of all the pixels in it. That’s a fair amount of leg work, but luckily some generous people at http:\/\/teaminterrobang.com\/showthread.php?35959-Minecraft-wool-color-Photoshop-ACO-file<\/a> have already done it for us, so we can describe our palette in python like this:<\/p>\n