Name Turtle
Source Mod ComputerCraft
ID Name
Type Block
Stackable Yes (64)
Blast Resistance 12.5
Hardness 2.5
Solid Yes
Transparent No
Affected by Gravity No
Emits Light No
Flammable No
Required Tool Iron Pickaxe

The Turtle is a block added by the ComputerCraft mod. It is essentially a robot with the ability to move around, detect, place blocks and pick-up or drop items. The programs it run are stored in its internal memory or on a Floppy Disk. The Turtle can be equipped with peripherals and tools, which will make it into an utility machine such as the Mining Turtle. The Turtle is submersible and Lava proof, this makes it particularly useful for retrieving valuable resources where lava pools can prevent access. The Turtle doesn't keep the chunk loaded, this means that the Player has to stay within the same chunk as the Turtle or use a Dimensional Anchor or Chunk Loader. Leaving the chunk or shutting down the game (or a server reboot) while a Turtle is running will cause it to forget its task.

The Turtle's programming is written in Lua an easy to learn code language, given some interest and a good resource. Turtle actions are defined by its API, a set of specific action commands to put the turtle in motion. Simple programs may be written to make the Turtle execute a task such as build stairs, bridges or structures, the possibilities of use are endless. We hope the Player will enjoy this remarkable utility companion. Have Fun!


GUI Crafting Table.png
Iron Ingot
Iron Ingot
Iron Ingot

Iron Ingot
Iron Ingot

Iron Ingot
Iron Ingot


Getting Started[edit]

Prompt display in Turtle interface.

Upon placing the Turtle, access its User interface by 'Right-clicking' it. The command prompt window is where the Player types [1] commands and edit programs. It is recommended to name the Turtle using the command: label set name. With the label set, the name displays above the Turtle (while pointing at it), this means that it can be removed safely and retain its memory and fuel. A folder [2] is created in the game folder, containing any files edited with the Turtle.

On the right of the Players inventory is a 4 by 4 grid [3], which is the Turtle inventory, where it stores the items harvested and picked up. Items to be placed or equipped by the Turtle are also placed in this inventory. At any time the Player may type: help for a list of help subjects. Adding the name of a program or command will give a summary of its use.

Built-in Command and Programs[edit]

To view a list of built-in commands and programs, at the prompt type: programs. To run a program, simply type the name of the program or command followed by any parameters it requires. The Turtle can be programmed to execute a task automatically upon starting the game, at the prompt enter this simple code:

edit startup
shell.run "nameOfTask"

where nameOfTask is one of the built-in programs, commands [4] or a Player writen task. Press the Control key (Ctrl) and choose Save (using arrow keys) then Ctrl again to Exit


Turtles require fuel. They accept combustible items (any item that burns in a vanilla furnace) and numerous items that store MJ or EU. The command to refuel a turtle is turtle.refuel(). For example turtle.refuel(64) will refuel the turtle with 64 items. The command refuel all may also be used to tell the turtle to consume all the fuel in its inventory [5]. The fuel values for combustible items is burn time × 5 / 100, where burn time is the number of ticks a fuel burns in a normal furnace. Some examples of fuel [6] values for items are shown below:

Item Movement gained Added by
Scrap 17 IndustrialCraft
Coalfuel Cell 1520 IndustrialCraft
Wooden Scaffolding 15 IndustrialCraft
Peat 80 Forestry
Wooden Tools 10 Vanilla
Lava 1000 Vanilla
Blaze Rod 120 Vanilla
Wood Blocks 15 Vanilla
Sticks 5 Vanilla
Coal/Charcoal 80 Vanilla
Mushroom Blocks 15 Vanilla
Coal Coke 160 Railcraft

Optional Unlimited Fuel Mode[edit]

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 the line turtleNeedsFuel=false in the config/ComputerCraft.cfg file.

Floppy Disk[edit]

A Turtle's memory can be transfered to a Floppy Disk using a Disk Drive place beside it. However, if the Turtle is equipped with a Wireless Modem, the Disk Drive (and other peripherals) must be placed on the opposite side.


Turtle can be used to craft the following items:

Tutorial and Resource[edit]


  1. One line of text copied to the clipboard may be pasted at the prompt in the Turtle's interface.
  2. The Turtle folder is named with a number corresponding to the number of Turtles labelled. The typical folder path is: FTB <Modpack name>/minecraft/saves/world/computer/1. A file codded with an editor such as Notepad++ can be saved as an existing Turtle file (User created program) in this folder and executed with the Turtle in-game. Once labelled the Turtle will no longer stack with other Turtles.
  3. The numbering of the inventory slots goes from left to right and top to bottom, from 1 to 16.
  4. The names of the programs and commands are case sensitive.
  5. By default, when the Turtle runs out of fuel it will scan its inventory and use any combustible items stored or harvested as fuel. To avoid the Turtle consuming resources harvested the Player can make sure the Turtle has enough fuel for the task at hand. Use the command turtle.getFuelLevel().
  6. Another way to fuel turtles is by using the Charge Station from Misc Peripherals.