A turtle is similar to a Computer but it has movement capabilities. This is not particularly useful but its main appeal is that you can upgrade it to a much more useful turtles. After upgrading it to a turtle like the Mining Turtle, you can write programs or even use the build-in programms (see below) to let it, for example, mine a tunnel.
First, you need the standard turtle:
You can now equip the turtle with a pickaxe (= mining turtle), a shovel (= digging turtle), an axe (= felling turtle), a hoe (= farming turtle) or a sword (= melee turtle). The tools must be diamond, however they will never break in the hands of your turtle. NOTE: Once you equip a turtle with a tool, there is currently no way to get the tool back! NOTE: You can equip Turtles only with one tool. [The recipe shows as a representation the pickaxe:]
This can you now equip with a wireless modem:
OR with a Crafting Table:
NOTE: You can also first add the Wireless Modem or the Crafting Table and add after this the tool.
|Added Item||Gained feature|
|Pickaxe/Shovel/Axe/Hoe||The turtle can now break blocks in front of it. Depending on what tool you crafted it with, it will take a different amount of time to mine the blocks (minimal change).|
|Any tool||The turtle can now attack enemies and players (yes, even its owner).|
|Crafting Table||The turtle can now craft items by itself.|
|Wireless Modem||The turtle can now be controlled from a Computer within 50 blocks of the Wireless Mining Turtle. (The Computer must have a Wireless Modem attached to it for this to work).|
Turtles need fuel to move. Below you can see how far your turtle can move after a refuel with the specific fuel:
|Item||Movement gained (Blocks)||Added by|
However, can you activate their internal Redstone Engine, and as such, they do not need to be re-charged, or receive any other form of external power. This mode can be turned on by editing the turtle config file (config/mod_CCTurtle.cfg) as followed:
turtleNeedsFuel = 0
"excavate" mines a certain area down, such as excavate 3 will mine a 3x3 block going down.
"tunnel" mines a 3 wide, 2 high tunnel
"Dance" Causes the turtle to start moving from side to side, up and down, in a circle. The turtle begins to dance.
Programming a turtleEdit
Programs can be written into the turtle to make a more complex series of commands and movements possible. For a few programs, see here.
Here can you see the avaiable functions of the standart Turtle API. NOTE:. If You need a specila component, it is listed in the two last columns.
|Return-Value||Command Name||Description||Needs tool||Needs newer CC version|
|bool success||turtle.craft( quantity )||Craft items using ingredients anywhere in the Turtle's inventory and place results in the active slot. If a quantity is specified, it will craft only up to that many items, otherwise, it will craft as many of the items as possible.||Workbench|
|bool success||turtle.forward()||Let the Turtle move forward|
|bool success||turtle.back()||Let the Turtle move back|
|bool success||turtle.up()||Let the Turtle move up|
|bool success||turtle.down()||Let the Turtle move down|
|true||turtle.turnLeft()||The Turtle turns left|
|true||turtle.turnRight()||The Turtle turns right|
|bool success||turtle.select(slotNum)||The Turtle selects the given Slot (1 is top left, 16 is bottom right)|
|int result||turtle.getItemCount(slotNum)||Counts how many items are in the given Slot|
|int result||turtle.getItemSpace(slotNum)||Counts how many remaining items you need to fill the stack in the given Slot|
|bool success||turtle.attack()||Attacks in front of the turtle.||Any tool|
|bool success||turtle.attackUp()||Attacks over the turtle.||Any tool|
|bool success||turtle.attackDown()||Attacks under the turtle.||Any tool|
|bool success||turtle.dig()||Breaks the Block in front. With hoe: tills the dirt in front of it.||Pickaxe/Shovel/Axe/Hoe|
|boolsuccess||turtle.digUp()||Breaks the Block above. With hoe: tills the dirt above it.||Pickaxe/Shovel/Axe/Hoe|
|bool success||turtle.digDown()||Breaks the Block below. With hoe: tills the dirt below it.||Pickaxe/Shovel/Axe/Hoe|
|bool success||turtle.place(signText)||Places a Block of the selected slot in front. Engrave signText on signs if provided.|
|bool success||turtle.placeUp()||Places a Block of the selected slot above|
|bool success||turtle.placeDown()||Places a Block of the selected slot below|
|bool result||turtle.detect()||Detects if there is a Block in front. Does not detect mobs.|
|bool result||turtle.detectUp()||Detects if there is a Block above|
|bool result||turtle.detectDown()||Detects if there is a Block below|
|bool result||turtle.compare()||Detects if the block in front is the same as the one in the currently selected slot|
|bool result||turtle.compareUp()||Detects if the block above is the same as the one in the currently selected slot|
|bool result||turtle.compareDown()||Detects if the block below is the same as the one in the currently selected slot|
|bool result||turtle.compareTo(slot)||Compare the current selected slot and the given slot to see if the items are the same, yields true if they are the same, and false if not.|
|bool success||turtle.drop(count)||Drops all items in the selected slot, or if count is specified, drops that many items. If there is a inventory on the side (i.e in front of the turtle) it will try to place into the inventory, returning false if the inventory is full.|
|bool success||turtle.dropUp(count)||Drops all items in the selected slot, or if count is specified, drops that many items. If there is a inventory on the side (i.e above the turtle) it will try to place into the inventory, returning false if the inventory is full. If below a furnace, will place item in the bottom slot.|
|bool success||turtle.dropDown(count)||Drops all items in the selected slot, or if count is specified, drops that many items. If there is a inventory on the side (i.e below the turtle) it will try to place into the inventory, returning false if the inventory is full. If above a furnace, will place item in the top slot.|
|bool success||turtle.suck()||Picks up an item stack of any number, from the ground or an inventory in front of the turtle. If the turtle can't pick up the item, the function yields false.|
|bool success||turtle.suckUp()||Picks up an item stack of any number, from the ground or an inventory above the turtle. If the turtle can't pick up the item, the function yields false.|
|bool success||turtle.suckDown()||Picks up an item stack of any number, from the ground or an inventory below the turtle. If the turtle can't pick up the item, the function yields false.|
|bool success||turtle.refuel(quantity)||If the current selected slot contains a fuel item, it will consume it to give the turtle the ability to move.|
Added in 1.4 and is only needed in needfuel mode. If the current slot doesn't contain a fuel item, it yields false. Fuel values for different items can be found above. If a quantity is specified, it will refuel only up to that many items, otherwise, it will consume all the items in the slot.
|int fuel||turtle.getFuelLevel()||Returns the current fuel level of the turtle, this is the number of blocks the turtle can move.|
If turtleNeedFuel = 0 then it yields "unlimited".
|bool success||turtle.transferTo(slot, quantity)||Transfers items from the selected slot to the specified slot in the [quantity] inputted.||Yes (1.45)|
You can find more info and detailed descriptions for all commands and examples about them in the official ComputerCraft-Wiki.