Turtle

From ComputerCraft Wiki
Jump to: navigation, search
Grid workbench.png   Turtle
Grid turtle.png
Item ID
Damage Value
Peripheral? No


Is this the page you were looking for?
This is for the turtle block/item. For the API, visit Turtle (API).
Normal Turtle (left) and Advanced Turtle (right).

Turtles and Advanced Turtles are essentially robots, and were added in the 1.3 update. They have the ability to place, break and detect blocks, move around and drop items in their inventory via their access to the Turtle API. The programs they run are stored in their internal memory, or on floppy disks.

The 1.4 update was focused on turtles, and expanded their ability to use tools. Turtles are capable of using pickaxes, hoes, axes, shovels and swords. The update added "Crafty Turtles", which have the ability to craft using their inventory - and part of this upgrade saw the number of inventory slots in the Turtle raised to 16 from the previous 9 slot inventory. The 1.4 update also included a new fuel system for the turtles.

The 1.55 update added Advanced Turtles - made of gold, are able to display color, and have mouse input available through their display. Their exterior appearance is also of gold. They're just like Advanced Computers, but with a smaller screen.

Prior to 1.6, turtles had to have tools manually attached via crafting. As of that update, they are now also able to swap tools in and out of their inventory at will. That build also brought in caps to the arbitrarily large fuel values turtles could previously store - by default, they are now 20,000 units for regular turtles and 100,000 for advanced.

Turtles are submersible and lavaproof. As such, they are extremely useful for mining near bedrock, where heavy lava flows can prevent access to diamonds and other rare finds.

If you would like to know more about how to program them, have a look at the Turtle API.

Keep in mind that when turtles are 'mined', picked up, and placed somewhere else, they will not keep their programs unless they have been given a label. To do so, you simply need to type in "label set <labelName>" at the shell prompt.


Floppy Disks and Peripherals

Turtles do not have a built-in Disk Drive. As such, they need a Disk Drive placed beside them to access Floppy Disks. However, if the Turtle is of the Wireless family, the Disk Drive (and other peripherals) must be placed on a side other than the side the wireless modem is on. Any other peripherals, such as Monitors and Printers can be interacted using the peripheral API.

Power source

Turtles require fuel to operate - this means Turtles must be powered from any item that works in a regular furnace, like coal and lava. The turtle gains 0.6 "movement" per half second the fuel would have burnt in a furnace. The Turtle can move 1 block for each fuel count it has, for example, coal yields 80 block movements.

Optional Non-fuel mode

In this mode, Turtles use their internal Redstone Engine, and as such, they do not need to be re-charged, or receive any other form of external power. This is because Redstone continuously emits low levels of energy, and the Turtle's engine is very efficient. This mode can be turned on by editing ComputerCraft.cfg and setting turtleNeedsFuel to false.

Dyeing

As of ComputerCraft 1.63 Turtles can be dyed using Dyes. It supports all 16 different colors, so you can have a green Farming Turtle harvesting some melons and a gray Mining Turtle gathering materials and mining ores.

Farming

Turtles equipped with a diamond hoe can till dirt so it can later be used for Farming. An example of a use for this would be using it to till, plant, and harvest your wheat farm and dropping any product in a chest for you.

Mining

Turtles crafted with a diamond pickaxe, diamond axe, or diamond shovel, can break blocks, chop wood, mine stone and ores, and even break dirt and gravel (depending on the tool you used on it). The tools equipped on the Turtle have no durability, and so can be used indefinitely without the need for any additional materials. When a Turtle breaks the block, the Turtle receives the item directly into it's inventory. Different tools yield different drops - for example, an axe can break anything, but it won't drop ores.

Crafting

Turtles with a Crafting Table can craft items if they have the correct materials to do so, and all other slots outside the crafting-zone are empty.

Melee

Turtles equipped with a diamond sword can attack players and mobs. When a Turtle kills a mob it will leave the experience orbs on the ground, but add the loot to its inventory. Turtles can also attack with any tool, where the diamond axe is the second best after the diamond sword.

Inventory Interaction

Turtles can interact with blocks that have inventories. This includes chests, furnaces, Printers and even blocks with inventories in other mods. (This means a turtle cannot interact with a player's inventory, unless you use a third party peripheral). Turtles can interact with such inventories by using turtle.suck, turtle.suckDown, turtle.suckUp (To retrieve the first item in the inventory. The turtle finds the first item by scanning the first row from left to right, then the second row from left to right, etc). Turtles can also place items inside inventories, by using turtle.drop, turtle.dropUp, turtle.dropDown, which places items on the first item slot available (Using the same system as the one described for retrieving items).

In special inventories, with just a few slots on the top or bottom - for example furnaces - you can specify which slot to place an item in by positioning the turtle in the corresponding location to the front face of the inventory. For example in a furnace, you would use a turtle at the bottom of the furnace for it to place fuel in the furnace, a turtle at the top to place objects to smelt, and a turtle to the right to retrieve the smelted objects (Note that you can do this with just 1 turtle moving around).

Peripheral functions

Just like a Computer, a Turtle can be used as a peripheral. You can find all Turtle peripheral functions here.

Crafting

Crafting ingredients
Turtle
Empty-crafting-table.png
Grid iron ingot.png
Grid iron ingot.png
Grid iron ingot.png
Grid iron ingot.png
Grid Computer.png
Grid iron ingot.png
Grid turtle.png
Grid iron ingot.png
Grid chest.png
Grid iron ingot.png
Advanced Turtle
Empty-crafting-table.png
Grid Gold Ingot.png
Grid Gold Ingot.png
Grid Gold Ingot.png
Grid Gold Ingot.png
Grid Advanced Computer.png
Grid Gold Ingot.png
Grid Advanced Turtle.png
Grid Gold Ingot.png
Grid chest.png
Grid Gold Ingot.png

Note: NEI has been known to present the recipe for an advanced turtle as requiring a normal computer, somehow ignoring the actual recipe.

Turtles can be equipped with different peripherals and tools. A turtle can be crafted with any combination of tools and peripherals. Turtles may later use turtle.equipLeft() / turtle.equipRight() to add, remove or exchange tools in any combination.
The following tools can be equipped to a turtles: diamond pickaxe, diamond axe, diamond shovel, diamond hoe and diamond sword
The following peripherals can be equipped to a turtles: wireless modems, ender modems and crafting tables.
Diamond tools must be unused (i.e. not have a durability bar showing) an unenchanted to combine with a turtle.

Turtle recipe and examples for equipping a turtle with tools and peripherals (Note that any variants of the turtle can also be crafted with the Advanced Turtle):

None Crafty Wireless
None
Empty-crafting-table.png
Grid turtle.png
Grid turtle.png
Empty-crafting-table.png
Grid workbench.png
Grid turtle.png
Grid Crafty Turtle.png
Empty-crafting-table.png
Grid Modem.png
Grid turtle.png
Grid wireless turtle.png
Mining
Empty-crafting-table.png
Grid turtle.png
Grid diamond pickaxe.png
Grid mining turtle.png
Empty-crafting-table.png
Grid workbench.png
Grid turtle.png
Grid diamond pickaxe.png
Grid Crafty Mining Turtle.png
Empty-crafting-table.png
Grid Modem.png
Grid turtle.png
Grid diamond pickaxe.png
Grid wireless mining turtle.png
Farming
Empty-crafting-table.png
Grid turtle.png
Grid diamond hoe.png
Grid Farming Turtle.png
Empty-crafting-table.png
Grid workbench.png
Grid turtle.png
Grid diamond hoe.png
Grid Crafty Farming Turtle.png
Empty-crafting-table.png
Grid Modem.png
Grid turtle.png
Grid diamond hoe.png
Grid Wireless Farming Turtle.png
Melee
Empty-crafting-table.png
Grid turtle.png
Grid diamond sword.png
Grid Melee Turtle.png
Empty-crafting-table.png
Grid workbench.png
Grid turtle.png
Grid diamond sword.png
Grid Crafty Melee Turtle.png
Empty-crafting-table.png
Grid Modem.png
Grid turtle.png
Grid diamond sword.png
Grid Wireless Melee Turtle.png
Felling
Empty-crafting-table.png
Grid turtle.png
Grid diamond axe.png
Grid Felling Turtle.png
Empty-crafting-table.png
Grid workbench.png
Grid turtle.png
Grid diamond axe.png
Grid Crafty Felling Turtle.png
Empty-crafting-table.png
Grid Modem.png
Grid turtle.png
Grid diamond axe.png
Grid Wireless Felling Turtle.png
Digging
Empty-crafting-table.png
Grid turtle.png
Grid diamond shovel.png
Grid Digging Turtle.png
Empty-crafting-table.png
Grid workbench.png
Grid turtle.png
Grid diamond shovel.png
Grid Crafty Digging Turtle.png
Empty-crafting-table.png
Grid Modem.png
Grid turtle.png
Grid diamond shovel.png
Grid Wireless Digging Turtle.png
Crafty See Above N/A
Empty-crafting-table.png
Grid Modem.png
Grid turtle.png
Grid workbench.png
Grid Wireless Crafty Turtle.png

History

1.3Added Turtles.
1.4Added Farming Turtles, Felling Turtles, Digging Turtles, Melee Turtles and Crafty Turtles.
Added 14 new Turtle combinations accessible by combining the turtle upgrades.
Added a “Turtle Upgrade API” for mod developers to create their own tools and peripherals for Turtles.
Turtles now optionally require fuel items to move, and can refuel themselves.
The size of the the Turtle inventory has been increased to 16 slots.
The size of the Turtle screen has been increased.
Added optional Floppy Disk and Hard Drive space limits.
Can no longer be destroyed by tree leaves or walking off the edge of the loaded map.
1.42Wireless Crafty Turtles can now be crafted.
1.43Labelled Turtles now keep their fuel when broken.
1.48Now get slightly less movement from fuel.
Can now push items.
1.51No longer drop items in creative mode, except they are labled.
Fixed Turtles sometimes placing blocks with incorrect orientations.
1.55Added Advanced Turtles.
1.6Turtles can now swap out their tools and peripherals at runtime.
Turtles can now carry two tools or peripherals at once in any combination.
Turtles can now be labelled using Name Tags and Anvils.
1.63Turtles can now be painted with dyes, and cleaned with water buckets.
Turtle label nameplates now only show when the Turtle is moused-over.
1.74Turtles can now push players and entities.
Turtles now respect server spawn protection.
1.77/1.78Can be mounted in Disk Drives.
Grid Redstone.pngComputerCraft Blocks and Items
Grid paper.png  Blocks
 Iso Computer.png  Computer Iso Advanced Computer.png  Advanced Computer Iso Command Computer.png  Command Computer Iso DiskDrive.png  Disk Drive
 Iso Monitor.png  Monitor Iso Advanced Monitor.png  Advanced Monitor Iso Printer.png  Printer Grid turtle.png  Turtle
 Grid Modem.png  Wireless Modem Grid Ender Modem.png  Ender Modem Grid Wired Modem.png  Wired Modem Grid Networking Cable.png  Networking Cable
Grid paper.png  Items
 Grid Pocket Computer.png  Pocket Computer Grid Advanced Pocket Computer.png  Advanced Pocket Computer Grid disk.png  Floppy Disk Grid printed page.png  Printed Page
 Grid printed pages.png  Printed Pages Grid printed book .png  Printed Book