Technic Pack Wiki
Register
Advertisement
Logo CC 40 Turtle contains information about the ComputerCraft mod.

This article is about the item in Computercraft. For the animal in Mo' Creatures, see Turtles.

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.

Crafting[]

First, you need the standard turtle:

Crafting GUI

Iron Ingot

Iron Ingot

Iron Ingot

Iron Ingot

Computer

Chest

Iron Ingot

Iron Ingot

Iron Ingot

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:]

Crafting GUI

Turtle

Diamond Pickaxe

Mining Turtle


This can you now equip with a wireless modem:

Crafting GUI

Mining Turtle

Wireless Modem

Wireless Mining Turtle


OR with a Crafting Table:


NOTE: You can also first add the Wireless Modem or the Crafting Table and add after this the tool.

Special features[]

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).

Fuel Usage[]

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
Fuel Can (Filled) with Biofuel Cells 624 IndustrialCraft
Scrap 18 IndustrialCraft
Fuel Can (Filled) with Coalfuel Cells 1824 IndustrialCraft
Wooden Tools 12 Vanilla
Lava 1000 Vanilla
Blaze Rod 144 Vanilla
Wood Blocks 18 Vanilla
Sticks 6 Vanilla
Sugar Cane 0 Vanilla
Coal/Charcoal 96 Vanilla
Mushroom Blocks 18 Vanilla
Peat 96 Forestry

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

Built-in programs[]

"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 turtle[]

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 available functions of the standard Turtle API. NOTE:. If You need a special 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)

Screenshots[]

More Info[]

You can find more info and detailed descriptions for all commands and examples about them in the official ComputerCraft-Wiki.

Advertisement