MinecraftTurtle¶

The Minecraft Turtle is a recreation of the classic graphics turtle for Minecraft. The key difference is that you can draw in 3 dimensions not just 2.

$a fractal tree in minecraft$

Example:

from mcpi.minecraft import Minecraft
from mcpi import block
from minecraftstuff import MinecraftTurtle

mc = minecraft.Minecraft.create()
pos = mc.player.getTilePos()

# create minecraft turtle
steve = MinecraftTurtle(mc, pos)

# draw a pentagon
steve.forward(5)
steve.right(72)
steve.forward(5)
steve.right(72)
steve.forward(5)
steve.right(72)
steve.forward(5)
steve.right(72)
steve.forward(5)

MinecraftTurtle¶

class minecraftstuff.MinecraftTurtle(mc, position=<MagicMock name='mock()' id='139984989718456'>)¶

MinecraftTurle - a graphics turtle, which can be used to create ‘things’ in Minecraft by controlling its position, angles and direction

Parameters:	mc (mcpi.minecraft.Minecraft) – A Minecraft object which is connected to a world. position (mcpi.minecraft.Vec3) – The position where the shape should be created, defaults to `0,0,0`.

backward(distance)¶

move the turtle backward

Parameters:	distance (int) – the number of blocks to move.

down(angle)¶

rotate the turtle down

Parameters:	angle (float) – the angle in degrees to rotate.

fly()¶: sets the turtle to ‘fly’, i.e. not have to move along the ground.

forward(distance)¶

move the turtle forward

Parameters:	distance (int) – the number of blocks to move.

home()¶: reset the turtle’s position

isdown()¶: returns True if the pen is down

left(angle)¶

rotate the turtle left

Parameters:	angle (float) – the angle in degrees to rotate.

penblock(blockId, blockData=0)¶

set the block the turtle uses as its pen.

Parameters:	blockType (int) – The block id. blockData (int) – The block data value, defaults to `0`.

pendown()¶: put the turtles pen down, show it will draw

penup()¶: put the turtles pen up, show it wont draw

right(angle)¶

rotate the turtle right

Parameters:	angle (float) – the angle in degrees to rotate.

setheading(angle)¶

set the turtle’s horizontal heading

Parameters:	angle (float) – the angle in degrees.

setposition(x, y, z)¶

set the turtle’s position

Parameters:	x (int) – the x position. y (int) – the y position. z (int) – the z position.

setverticalheading(angle)¶

set the turtle’s verticle heading

Parameters:	angle (float) – the angle in degrees.

setx(x)¶

set the turtle’s x position

Parameters:	x (int) – the x position.

sety(y)¶

set the turtle’s y position

Parameters:	y (int) – the y position.

setz(z)¶

set the turtle’s z position

Parameters:	z (int) – the z position.

speed(turtlespeed)¶

set the turtle’s speed.

Parameters:	turtlespeed (int) – `1` - `10`, 1 being the slowest, 10 being the fastest, defaults to `6`. When set to `0` the turtle draws instantaneously.

up(angle)¶

rotate the turtle up

Parameters:	angle (float) – the angle in degrees to rotate.

walk()¶: sets the turtle to ‘walk’, i.e. it has to move along the ground.