Difference between revisions of "Turtle Tutorial"

From ComputerCraft Wiki
Jump to: navigation, search
(Turtle)
m (The Program)
 
(13 intermediate revisions by 7 users not shown)
Line 7: Line 7:
 
[[Turtle (API)|Here is a list of the complete Turtle API]]
 
[[Turtle (API)|Here is a list of the complete Turtle API]]
  
For our program, we will use turtle.detectDown(), turtle.digDown(), turtle.down() and turtle.forward(). It is recommended that you learn what method does what before messing with Turtles.
+
For our program, we will use turtle.refuel(),turtle.detectDown(), turtle.digDown(), turtle.down(), turtle.forward(), and turtle.placeDown(). It is recommended that you learn what these method do before messing with Turtles.
  
 
== The Program ==
 
== The Program ==
 
So, for you to make the Turtle program, first craft a Turtle.
 
So, for you to make the Turtle program, first craft a Turtle.
  
{{Crafting grid
+
{{Crafting
  |A1=iron_ingot |B1=iron_ingot    |C1=iron_ingot
+
  |A1=iron ingot |B1=iron ingot |C1=iron ingot
  |A2=iron_ingot |B2=console      |C2=iron_ingot
+
  |A2=iron ingot |B2=Computer  |C2=iron ingot
  |A3=iron_ingot |B3=chest         |C3=iron_ingot
+
  |A3=iron ingot |B3=chest     |C3=iron ingot
 
  |Output=turtle
 
  |Output=turtle
 
  }}
 
  }}
Line 21: Line 21:
 
Then make a Mining Turtle.
 
Then make a Mining Turtle.
  
{{Crafting grid
+
{{Crafting
  |A2=turtle |B2=diamond_pickaxe
+
  |A2=turtle |B2=diamond pickaxe
  |Output=mining_turtle
+
  |Output=mining turtle
 +
|Output-link=Turtle
 
  }}
 
  }}
  
  
 
Then, place it anywhere you want. Right click it and type 'edit MyFirstTurtleProgram'. You don't have to call it 'MyFirstTurtleProgram'; It can be whatever you want.
 
Then, place it anywhere you want. Right click it and type 'edit MyFirstTurtleProgram'. You don't have to call it 'MyFirstTurtleProgram'; It can be whatever you want.
So, inside the file, type:
+
So, inside the file, type
 +
turtle.refuel()
 +
print("Refueled turtle!")
 
  while turtle.detectDown() do
 
  while turtle.detectDown() do
print("Digging down!")
+
    print("Digging down!")
turtle.digDown()
+
    turtle.digDown()
print("Going down!")
+
    print("Going down!")
turtle.down()
+
    turtle.down()
print("Digging forward!")
+
    print("Digging forward!")
turtle.dig()
+
    turtle.dig()
print("Going forward!")
+
    print("Going forward!")
turtle.forward()
+
    turtle.forward()
 
  end
 
  end
  
Line 43: Line 46:
  
 
If you want a spiral drill formation that allows you to be able to retrieve the turtle after its done mining, do the same as above but when editing the program type:
 
If you want a spiral drill formation that allows you to be able to retrieve the turtle after its done mining, do the same as above but when editing the program type:
 +
turtle.refuel()
 
  while turtle.detectDown() do
 
  while turtle.detectDown() do
turtle.dig()
+
    turtle.dig()
turtle.digDown()
+
    turtle.digDown()
turtle.down()
+
    turtle.down()
turtle.dig()
+
    turtle.dig()
turtle.forward()
+
    turtle.forward()
turtle.turnLeft()
+
    turtle.turnLeft()
 
  end
 
  end
  
 
== Explanation ==
 
== Explanation ==
 +
 +
The line turtle.refuel() refuels the Turtle so that it can move.
  
 
The line while turtle.detectDown() do makes the program run until there is no block underneath the Turtle.
 
The line while turtle.detectDown() do makes the program run until there is no block underneath the Turtle.

Latest revision as of 06:19, 4 August 2020

This tutorial will teach you the functions of the Turtle API, and also will teach you how to make your first turtle program.

Turtle

The Turtle API is used to work with your Turtles. Here is a list of the complete Turtle API

For our program, we will use turtle.refuel(),turtle.detectDown(), turtle.digDown(), turtle.down(), turtle.forward(), and turtle.placeDown(). It is recommended that you learn what these method do before messing with Turtles.

The Program

So, for you to make the Turtle program, first craft a 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

Then make a Mining Turtle.

Empty-crafting-table.png
Grid turtle.png
Grid diamond pickaxe.png
Grid mining turtle.png


Then, place it anywhere you want. Right click it and type 'edit MyFirstTurtleProgram'. You don't have to call it 'MyFirstTurtleProgram'; It can be whatever you want. So, inside the file, type

turtle.refuel()
print("Refueled turtle!")
while turtle.detectDown() do
    print("Digging down!")
    turtle.digDown()
    print("Going down!")
    turtle.down()
    print("Digging forward!")
    turtle.dig()
    print("Going forward!")
    turtle.forward()
end

To save the program, press CTRL and select SAVE with the Arrow Keys. After that, type MyFirstTurtleProgram (or whatever you called your program).

If you want a spiral drill formation that allows you to be able to retrieve the turtle after its done mining, do the same as above but when editing the program type:

turtle.refuel()
while turtle.detectDown() do
    turtle.dig()
    turtle.digDown()
    turtle.down()
    turtle.dig()
    turtle.forward()
    turtle.turnLeft()
end

Explanation

The line turtle.refuel() refuels the Turtle so that it can move.

The line while turtle.detectDown() do makes the program run until there is no block underneath the Turtle.

The turtle.digDown() will make the Turtle dig down.

The part where it says turtle.forward() will make the Turtle go forward.

The line that says turtle.dig() will make the Turtle dig forward.


NOTE: this should be running on a mining turtle, or it wont work!