Turtle Tutorial

2012-02-25T00:45:53Z

Rockymc:

[[Category:Tutorials]]
This tutorial will teach you the functions of the Turtle API, and also will teach you how to make your first turtle program.
by: rockymc

== Turtle ==

The Turtle API is used to work with your Turtles. Here is a list of the complete Turtle API.
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|turtle.forward()
|Let the Turtle move forward
|-
|turtle.back()
|Let the Turtle move back
|-
|turtle.up()
|Let the Turtle move up
|-
|turtle.down()
|Let the Turtle move down
|-
|turtle.turnLeft()
|The Turtle turns left
|-
|turtle.turnRight()
|The Turtle turns right
|-
|turtle.select( slotNum )
|The Turtle selects the given Slot (1 is top left, 9 is bottom right)
|-
|turtle.getItemCount( slotNum )
|Counts how many items are in the given Slot
|-
|turtle.getItemSpace( slotNum )
|Counts how many items you need to fill the stack in the given Slot
|-
|turtle.dig()
|Breaks the Block in front
|-
|turtle.digUp()
|Breaks the Block above
|-
|turtle.digDown()
|Breaks the Block below
|-
|turtle.place()
|Places a Block of the selected Slot in front
|-
|turtle.placeUp()
|Places a Block of the selected Slot above
|-
|turtle.placeDown()
|Places a Block of the selected Slot below
|-
|turtle.detect()
|Detects if there is a Block in front
|-
|turtle.detectUp()
|Detects if there is a Block above
|-
|turtle.detectDown()
|Detects if there is a Block below
|-
|turtle.drop()
|Drops everything of the selected Slot
|}

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 up with Turtles.

== The Program ==
So, for you to make the Turtle program, first craft a Turtle.

[[File:Turtle-craft.png]]

Then make a Mining Turtle.

[[File:Turtle-craft2.png]]

Then, place it anywhere you want. Run 'edit MyFirstTurtleProgram', where MyFirstTurtleProgram can be whatever you want.
So, inside the file, type:
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).

== Explanation ==

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!

== Author ==
[[User:Rockymc|rockymc]]

Turtle Tutorial

2012-02-25T00:43:55Z

Rockymc: Created page with "Category:Tutorials This tutorial will teach you the functions of the Turtle API, and also will teach you how to make your first turtle program. by: rockymc == Turtle == ..."

[[Category:Tutorials]]
This tutorial will teach you the functions of the Turtle API, and also will teach you how to make your first turtle program.
by: rockymc

== Turtle ==

The Turtle API is used to work with your Turtles. Here is a list of the complete Turtle API.
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|turtle.forward()
|Let the Turtle move forward
|-
|turtle.back()
|Let the Turtle move back
|-
|turtle.up()
|Let the Turtle move up
|-
|turtle.down()
|Let the Turtle move down
|-
|turtle.turnLeft()
|The Turtle turns left
|-
|turtle.turnRight()
|The Turtle turns right
|-
|turtle.select( slotNum )
|The Turtle selects the given Slot (1 is top left, 9 is bottom right)
|-
|turtle.getItemCount( slotNum )
|Counts how many items are in the given Slot
|-
|turtle.getItemSpace( slotNum )
|Counts how many items you need to fill the stack in the given Slot
|-
|turtle.dig()
|Breaks the Block in front
|-
|turtle.digUp()
|Breaks the Block above
|-
|turtle.digDown()
|Breaks the Block below
|-
|turtle.place()
|Places a Block of the selected Slot in front
|-
|turtle.placeUp()
|Places a Block of the selected Slot above
|-
|turtle.placeDown()
|Places a Block of the selected Slot below
|-
|turtle.detect()
|Detects if there is a Block in front
|-
|turtle.detectUp()
|Detects if there is a Block above
|-
|turtle.detectDown()
|Detects if there is a Block below
|-
|turtle.drop()
|Drops everything of the selected Slot
|}

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 up with Turtles.

== The Program ==
So, for you to make the Turtle program, first craft a Turtle.

[[File:Turtle-craft.png]]

Then make a Mining Turtle.

[[File:Turtle-craft2.png]]

Then, place it anywhere you want. Run 'edit MyFirstTurtleProgram', where MyFirstTurtleProgram can be whatever you want.
So, inside the file, type:
while turtle.detectDown() do
print("Digging down!")
turtle.digDown()
print("Going forward!")
turtle.forward()
print("Digging forward!")
turtle.dig()
end

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

== Explanation ==

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!

== Author ==
[[User:Rockymc|rockymc]]

ComputerCraft Wiki - User contributions [en]

Turtle Tutorial

Turtle Tutorial