ComputerCraft Wiki - User contributions [en]

Advanced Computer

2013-07-12T21:47:36Z

1lann: Paint? Exclusive? xD

{{Block
|name=Advanced Computer
|image=Iso_Advanced_Computer.png
|id=4095
|damage-value=The ID of the Computer.
|is-peripheral=Yes
}}
The Advanced Computer is a [[computer]] that has mouse and colour API support. More exclusive features may be added in another update. They resemble the traditional computer console, but are golden coloured to match their crafting [[recipes|recipe]].
==Recipe==
{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Redstone |C2=Gold_Ingot
|A3=Gold_Ingot |B3=glass_pane |C3=Gold_Ingot
|Output=Advanced_Computer
}}

==Exclusive Functions==
[[File:AdvancedComputerPaint.png|frame|right|An advanced computer running Paint, a built-in program]]
[[Advanced Computer|Advanced Computers]] and [[Advanced Monitor|Advanced Monitors]] both have access to color-setting functions in the [[Term (API)]]. In contrast, the standard [[Computer|Computers]] and [[Monitor|Monitors]] do not have access to color-setting functions. Also, advanced computers are able to detect mouse clicks, drags, and scrolls, while the standard [[Computer|Computers]] and [[Monitor|Monitors]] can not. Note that [[Advanced Monitor|Advanced Monitors]] can only detect touch.

==Exclusive Programs & APIs==
*[[Paint]]
*[[paintutils (API)]]

== Peripheral Functions ==
'''''computer'' stands for the variable you wrapped the computer to.'''
''Example:'' computer = peripheral.wrap( "top" )

{| class="wikitable"
!style="background:#EEE" width="210px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[computer.turnOn()]]
|Turns on the Computer or Turtle.
|-
|[[computer.shutdown()]]
|Shuts off the Computer or Turtle.
|-
|[[computer.reboot()]]
|Reboots the Computer or Turtle.
|-
|[[computer.getID()]]
|Gets the ID of the Computer or Turtle.
|}

{{BlocksItemsList}}
[[Category:Blocks]][[Category:Consoles]]

Turtle

2013-07-12T21:46:36Z

1lann: Added mention of exterior and a notice to edit the recipe if I got it incorrect :-/

'''Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS, like the [[Computer|Computers]], named [[TurtleOS]]. They have the ability to place, break and detect blocks, move around and drop items in their inventory. The programs they run are stored on its internal memory or [[Floppy Disk|floppy disks]].

The 1.4 update was focused on turtles, and expanded the turtle's 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 - over 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. Advanced Turtles are made of gold and are able to display color and have mouse input on their display. Their exterior looks are also gold. They're just like [[Advanced Computer|Advanced Computers]].

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)|Turtle API]].

Keep in mind, that turtles will not keep their programs unless they are labelled. To do so, you simply need to type in "label set labelName". This will label your turtle with the specified label, in this case "labelName".

==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 Disk|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|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|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 96 block movements. For more information, go to the [[Turtle.refuel]] page.

=== 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 the turtle config file (config/mod_CCTurtle.cfg) and setting <var>turtleNeedsFuel</var> to <var>0</var>.

==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 [http://www.minecraftwiki.net/wiki/Crafting_Table 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, [[Printer|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.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.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)

==Recipes==

{|
|+'''Crafting ingredients'''
|-
|Turtle
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle |Output-link=turtle
}}
|Advanced Turtle (Edit if incorrect :-/)
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=advanced_turtle |Output-link=turtle
}}
|}
Turtles can be equipped with different peripherals and tools. A turtle can only have one tool and one peripheral, however the crafting table can act as a tool, or peripheral.
<br>The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
<br>The following peripherals can be equipped to a turtles: [[Wireless Modem|wireless modem]] and [[Workbench|crafting tables]].
<br>Diamond tools must be unused (i.e. not have a durability bar showing) to combine with a turtle.
<br><br>'''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).'''
{| class="wikitable"
! !! None !! Crafty !! Wireless
|-
! scope="row"| None
|{{Crafting grid
|B2=turtle
|Output=turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=workbench
|Output=Crafty_Turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=Modem
|Output=wireless_turtle |Output-link=turtle
}}
|-
! scope="row"| Mining
|{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_pickaxe
|Output=Crafty_Mining_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_pickaxe
|Output=wireless_mining_turtle |Output-link=turtle
}}
|-
! scope="row"| Farming
|{{Crafting grid
|B2=turtle |C2=diamond_hoe
|Output=Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_hoe
|Output=Crafty_Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_hoe
|Output=Wireless_Farming_Turtle |Output-link=turtle
}}
|-
! scope="row"| Melee
|{{Crafting grid
|B2=turtle |C2=diamond_sword
|Output=Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_sword
|Output=Crafty_Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_sword
|Output=Wireless_Melee_Turtle |Output-link=turtle
}}
|-
! scope="row"| Felling
|{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_axe
|Output=Crafty_Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_axe
|Output=Wireless_Felling_Turtle |Output-link=turtle
}}
|-
! scope="row"| Digging
|{{Crafting grid
|B2=turtle |C2=diamond_shovel
|Output=Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_shovel
|Output=Crafty_Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_shovel
|Output=Wireless_Digging_Turtle |Output-link=turtle
}}
|-
! scope="row"| Crafty
|See Above
|N/A
|{{Crafting grid
|A2=Modem |B2=turtle |C2=workbench
|Output=Wireless_Crafty_Turtle |Output-link=turtle
}}
|}

{{BlocksItemsList}}
[[Category:Blocks]]

Turtle

2013-07-12T21:39:21Z

1lann: (accidentally hit save instead of preview) Added Advanced turtles. (Though we need an icon)

'''Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS, like the [[Computer|Computers]], named [[TurtleOS]]. They have the ability to place, break and detect blocks, move around and drop items in their inventory. The programs they run are stored on its internal memory or [[Floppy Disk|floppy disks]].

The 1.4 update was focused on turtles, and expanded the turtle's 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 - over 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. Advanced Turtles are able to display color and have mouse input on their display. Just like [[Advanced Computer|Advanced Computers]].

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)|Turtle API]].

Keep in mind, that turtles will not keep their programs unless they are labelled. To do so, you simply need to type in "label set labelName". This will label your turtle with the specified label, in this case "labelName".

==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 Disk|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|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|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 96 block movements. For more information, go to the [[Turtle.refuel]] page.

=== 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 the turtle config file (config/mod_CCTurtle.cfg) and setting <var>turtleNeedsFuel</var> to <var>0</var>.

==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 [http://www.minecraftwiki.net/wiki/Crafting_Table 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, [[Printer|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.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.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)

==Recipes==

{|
|+'''Crafting ingredients'''
|-
|Turtle
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle |Output-link=turtle
}}
|Advanced Turtle
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=advanced_turtle |Output-link=turtle
}}
|}
Turtles can be equipped with different peripherals and tools. A turtle can only have one tool and one peripheral, however the crafting table can act as a tool, or peripheral.
<br>The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
<br>The following peripherals can be equipped to a turtles: [[Wireless Modem|wireless modem]] and [[Workbench|crafting tables]].
<br>Diamond tools must be unused (i.e. not have a durability bar showing) to combine with a turtle.
<br><br>'''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).'''
{| class="wikitable"
! !! None !! Crafty !! Wireless
|-
! scope="row"| None
|{{Crafting grid
|B2=turtle
|Output=turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=workbench
|Output=Crafty_Turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=Modem
|Output=wireless_turtle |Output-link=turtle
}}
|-
! scope="row"| Mining
|{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_pickaxe
|Output=Crafty_Mining_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_pickaxe
|Output=wireless_mining_turtle |Output-link=turtle
}}
|-
! scope="row"| Farming
|{{Crafting grid
|B2=turtle |C2=diamond_hoe
|Output=Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_hoe
|Output=Crafty_Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_hoe
|Output=Wireless_Farming_Turtle |Output-link=turtle
}}
|-
! scope="row"| Melee
|{{Crafting grid
|B2=turtle |C2=diamond_sword
|Output=Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_sword
|Output=Crafty_Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_sword
|Output=Wireless_Melee_Turtle |Output-link=turtle
}}
|-
! scope="row"| Felling
|{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_axe
|Output=Crafty_Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_axe
|Output=Wireless_Felling_Turtle |Output-link=turtle
}}
|-
! scope="row"| Digging
|{{Crafting grid
|B2=turtle |C2=diamond_shovel
|Output=Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_shovel
|Output=Crafty_Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_shovel
|Output=Wireless_Digging_Turtle |Output-link=turtle
}}
|-
! scope="row"| Crafty
|See Above
|N/A
|{{Crafting grid
|A2=Modem |B2=turtle |C2=workbench
|Output=Wireless_Crafty_Turtle |Output-link=turtle
}}
|}

{{BlocksItemsList}}
[[Category:Blocks]]

Turtle

2013-07-12T21:37:59Z

1lann:

'''Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS, like the [[Computer|Computers]], named [[TurtleOS]]. They have the ability to place, break and detect blocks, move around and drop items in their inventory. The programs they run are stored on its internal memory or [[Floppy Disk|floppy disks]].

The 1.4 update was focused on turtles, and expanded the turtle's 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 - over 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. Advanced Turtles are able to display color and have mouse input on their display. Just like [[Advanced Computer||Advanced Computers]].

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)|Turtle API]].

Keep in mind, that turtles will not keep their programs unless they are labelled. To do so, you simply need to type in "label set labelName". This will label your turtle with the specified label, in this case "labelName".

==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 Disk|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|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|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 96 block movements. For more information, go to the [[Turtle.refuel]] page.

=== 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 the turtle config file (config/mod_CCTurtle.cfg) and setting <var>turtleNeedsFuel</var> to <var>0</var>.

==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 [http://www.minecraftwiki.net/wiki/Crafting_Table 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, [[Printer|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.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.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)

==Recipes==

{|
|+'''Crafting ingredients'''
|-
|Turtle
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle |Output-link=turtle
}}
|Advanced Turtle
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=turtle |Output-link=turtle
}}
|}
Turtles can be equipped with different peripherals and tools. A turtle can only have one tool and one peripheral, however the crafting table can act as a tool, or peripheral.
<br>The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
<br>The following peripherals can be equipped to a turtles: [[Wireless Modem|wireless modem]] and [[Workbench|crafting tables]].
<br>Diamond tools must be unused (i.e. not have a durability bar showing) to combine with a turtle.
<br><br>'''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).'''
{| class="wikitable"
! !! None !! Crafty !! Wireless
|-
! scope="row"| None
|{{Crafting grid
|B2=turtle
|Output=turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=workbench
|Output=Crafty_Turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=Modem
|Output=wireless_turtle |Output-link=turtle
}}
|-
! scope="row"| Mining
|{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_pickaxe
|Output=Crafty_Mining_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_pickaxe
|Output=wireless_mining_turtle |Output-link=turtle
}}
|-
! scope="row"| Farming
|{{Crafting grid
|B2=turtle |C2=diamond_hoe
|Output=Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_hoe
|Output=Crafty_Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_hoe
|Output=Wireless_Farming_Turtle |Output-link=turtle
}}
|-
! scope="row"| Melee
|{{Crafting grid
|B2=turtle |C2=diamond_sword
|Output=Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_sword
|Output=Crafty_Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_sword
|Output=Wireless_Melee_Turtle |Output-link=turtle
}}
|-
! scope="row"| Felling
|{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_axe
|Output=Crafty_Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_axe
|Output=Wireless_Felling_Turtle |Output-link=turtle
}}
|-
! scope="row"| Digging
|{{Crafting grid
|B2=turtle |C2=diamond_shovel
|Output=Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_shovel
|Output=Crafty_Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_shovel
|Output=Wireless_Digging_Turtle |Output-link=turtle
}}
|-
! scope="row"| Crafty
|See Above
|N/A
|{{Crafting grid
|A2=Modem |B2=turtle |C2=workbench
|Output=Wireless_Crafty_Turtle |Output-link=turtle
}}
|}

{{BlocksItemsList}}
[[Category:Blocks]]

Paintutils.drawLine

2013-07-12T00:06:46Z

1lann: Small code fixes and changed colour to colours

{{lowercase}}
{{Function
|name=paintutils.drawLine
|args=[[int (type)|int]] startX, [[int (type)|int]] startY, [[int (type)|int]] endX, [[int (type)|int]] endY, [[colour (API)|colour]] colour
|api=paintutils
|returns=nil
|addon=ComputerCraft
|desc=Draw a line on the screen from (startX startY) to (endX endY)
|examples=
{{Example
|desc=This code will draw a red line from the position (1, 2) to the position (9, 10)
|code=[[paintutils.drawLine]](1, 2, 9, 10, [[colour (API)|colours]].red)
}}
}}

[[Category:API_Functions]]

Paintutils.drawPixel

2013-07-12T00:03:20Z

1lann: colours, not colour

{{lowercase}}
{{Function
|name=paintutils.drawPixel
|args=[[int (type)|int]] x, [[int (type)|int]] y, [[colour (API)|colour]] colour
|api=paintutils
|returns=nil
|addon=ComputerCraft
|desc=Draw a pixel on the screen
|examples=
{{Example
|desc=This code will draw a red pixel at the position (10, 8)
|code=image = [[paintutils.drawPixel]](10, 8, [[colour (API)|colours]].red)
}}
}}

[[Category:API_Functions]]

Terminate (event)

2013-06-10T20:23:28Z

1lann: Better description and mentions on how it indirectly calls error within the bios

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:13, 30 November 2012 (MSK)''}}

{{Event
|name=terminate
|desc=Fired when CTRL+T is held for at least 1 second. With an unmodified bios and os.pullEvent, it indirectly calls error().
}}
{{Example
|desc=The actual terminating part of CTRL+T is defined in the bios for os.pullEvent. This can however be overridden to catch terminate and modify it's effects, as shown below. Note that holding CTRL+T, and it firing the terminate event is independent of key events and is hard coded into ComputerCraft.
|code=function os.pullEvent(_sFilter)
local event = { os.pullEventRaw(_sFilter) }
if event[1] == "terminate" then
error("Terminate Event Found", 0)
end
return unpack(event)
end
}}

Paintutils.loadImage

2013-06-10T20:14:59Z

1lann: Grammatical fix

{{lowercase}}
{{Function
|name=paintutils.loadImage
|args=[[String_(type)|string]] path
|api=paintutils
|returns=[[Table_(type)|table]] containing image data on success, otherwise nil.
|addon=ComputerCraft
|desc=Loads an image (images created with the [[Paint|paint]] program)
|examples=
{{Example
|desc=The program loads the image 'bar' onto the variable 'image', and then draws it on the screen, starting at position {3, 5} by using [[paintutils.drawImage]].
|code=image = [[paintutils.loadImage|paintutils.loadImage("bar")]]
[[paintutils.drawImage|paintutils.drawImage(image, 3, 5)]]
}}
}}

[[Category:API_Functions]]

Paintutils.drawImage

2013-06-10T20:13:38Z

1lann: Fixes and clarifications

{{lowercase}}
{{Function
|name=paintutils.drawImage
|args=[[Table_(type)|table]] image handle, [[Int_(type)|int]] x-position, [[Int_(type)|int]] y-position
|api=paintutils
|returns=[[Boolean_(type)|boolean]] true on success, otherwise false.
|addon=ComputerCraft
|desc=Draws an image whose top left corner is at x and y (images created with the [[Paint|paint]] program, then loaded using [[paintutils.loadImage]]).
|examples=
{{Example
|desc=The program loads the image 'bar' (using [[paintutils.loadImage]]) onto the variable 'image', and then draws it on the screen, starting at position {3, 5}.
|code=image = [[paintutils.loadImage|paintutils.loadImage("bar")]]
[[paintutils.drawImage|paintutils.drawImage(image, 3, 5)]]
}}
}}

[[Category:API_Functions]]

Paintutils.loadImage

2013-06-10T20:10:09Z

1lann: Fixed incorrect information

{{lowercase}}
{{Function
|name=paintutils.loadImage
|args=[[String_(type)|string]] path
|api=paintutils
|returns=[[Table_(type)|table]] containing image data on success, otherwise nil.
|addon=ComputerCraft
|desc=Loads an image (images created with the [[Paint|paint]] program)
|examples=
{{Example
|desc=The program loads the image 'bar' onto the variable 'image', and then draws it on the screen starting at position {3, 5} by using [[paintutils.drawImage]].
|code=image = [[paintutils.loadImage|paintutils.loadImage("bar")]]
[[paintutils.drawImage|paintutils.drawImage(image, 3, 5)]]
}}
}}

[[Category:API_Functions]]

Os.pullEvent

2013-06-09T16:51:33Z

1lann: Missed ()

{{lowercase}}
{{Function
|name=os.pullEvent
|args=[<nowiki></nowiki>{{type|string}} filter]
|api=OS
|returns={{type|string}} event, variable parameters(see table below)
|addon=ComputerCraft
|desc=Waits (yields) until an event occurs
|examples=
{{Example
|desc=The program requires to wait for a keypress to do something:
|code=[[Function (type)|function]] clear()
[[term.clear]]()
[[term.setCursorPos]] (1,1)
end
while true do
clear()
[[print]] ("Press E to do something.")
local event, param1 = os.pullEvent ("char") -- limit os.pullEvent to the char event
if param1 == "e" then -- if the returned value was 'e'
clear()
[[write]] ("Name: ")
local name = [[read]]()
[[print]] (name)
break
else
clear()
[[print]] ("Wrong button!")
[[os.sleep|sleep]] (1.5) -- I don't like a whole 2 seconds but 1 second is too short
end
end
}}
{{Example
|desc=This script shows how the os.pullEvent function can be used as an iterator instead of using a while loop:
|code=for event, param1 in os.pullEvent() do --this will continuously fire an event without the use of a while loop
[[print]]("Event: "..event)
[[print]]("Param1: "..param1)
end
[[User:SuicidalSTDz|SuicidalSTDz]] 20:23, 29 March 2013 (MSK)
}}
}}

=== Common syntax ===

event, param1, param2, param3 = os.pullEvent()

Note: This is one of the most commonly used functions that can return multiple values.
It works like any other function call (such as "input = read()") except that you can get more than one piece of information back.

== How it works ==
When os.pullEvent() is called, the computer waits until an event occurs.
Events can be triggered by several different things, such as a key being pressed or a redstone input changing.
They are usually triggered by ComputerCraft itself, when it needs to notify the computer that something happened.
They can also be triggered by peripherals, or by your program calling [[os.queueEvent]].

More complicated input, such as "the user typing a line of text," does ''not'' correspond to an event.
[[read]] handles this inside itself by waiting for the user to press a key, then updating the screen, moving the cursor, etc.

Events have a type (which is a string) and 0-5 parameters (which are often but not always strings).
No built-in events use more than 3 parameters.

When an event occurs, the event type, followed by the parameters, will be returned. If you have:

event, button, x, y = os.pullEvent()

and the user clicks the mouse at coordinates 5,4 then:
* event will be set to "mouse_click" (the event type)
* button will be set to 0 (the first parameter)
* x will be set to 5 (the second parameter)
* y will be set to 4 (the third parameter)

Note that in this example, we didn't specify a filter. If you specify a filter, then all events of different types will be ignored.
If the user inserts a disk, instead of clicking the mouse, then event will be "disk", button will be the side the disk drive is on, and x and y will be nil.

If we wanted to only wait for mouse clicks we could use:

event, button, x, y = os.pullEvent("mouse_click")

which will ignore any events that are not mouse clicks.

If you assign more variables than necessary, the extra ones will be set to nil.
If you assign fewer variables than necessary, the extra parameters will be discarded.

==Event types==
{| class="wikitable" width="100%"
! rowspan="2" | Name
! rowspan="2" | Description
! colspan="3" | Parameters
|-
! 1 !! 2 !! 3
|-
! scope="row" | [[char (event)|char]]
|Fired when text is typed on the keyboard
| {{type|string}} the letter typed
|
|
|-
! scope="row" | [[key (event)|key]]
|Fired when a key is pressed on the keyboard
|{{type|number}} numerical keycode
|
|
|-
! scope="row" | [[timer (event)|timer]]
|Fired when a timeout started by [[os.startTimer]]() completes
|{{type|number}} Value of the timer as returned by os.startTimer()
|
|
|-
! scope="row" | [[alarm (event)|alarm]]
|Fired when a time passed to [[os.setAlarm]]() is reached
|{{type|number}} Value of the alarm as returned by os.setAlarm()
|
|
|-
! scope="row" | [[redstone (event)|redstone]]
|Fired when the state of any of the redstone inputs change
|
|
|
|-
! scope="row" | [[terminate (event)|terminate]]
|Fired when a combination of keys CTRL and T is pressed and held for three seconds.
You will not normally see this event, as it is handled inside os.pullEvent.
|
|
|
|-
! scope="row" | [[disk (event)|disk]]
|Fired when a disk is inserted into an adjacent disk drive
|{{type|string}} side
|
|
|-
! scope="row" | [[disk_eject (event)|disk_eject]]
|Fired when a disk is removed from an adjacent disk drive
|{{type|string}} side
|
|
|-
! scope="row" | [[peripheral (event)|peripheral]]
|Fired when peripheral is attached
|{{type|string}} side
|
|
|-
! scope="row" | [[peripheral_detach (event)| peripheral_detach]]
|Fired when peripheral is removed
|{{type|string}} side
|
|
|-
! scope="row" | [[rednet_message (event)|rednet_message]]
|Fired when a rednet message is received from the [[Rednet_(API)|rednet API]]
|{{type|number}} senderID
|{{type|string}} message
|{{type|number}} distance travelled
|-
! scope="row" | [[http_success (event)|http_success]]
|Fired when an attempt to receive text from / post text on a website is successful.
You will not normally see this event as it is handled inside http.get.
|{{type|string}} url of the site
|{{type|table}} text on the site
|
|-
! scope="row" | [[http_failure (event)|http_failure]]
|Fired when an attempt to receive text from / post text on a website is unsuccessful
You will not normally see this event as it is handled inside http.get.
|{{type|string}} url of the site
|
|
|-
! scope="row" | [[mouse_click (event)|mouse_click]]
|Fired when a mouse button is pressed
|{{type|number}} mouse button
|{{type|number}} x coordinate
|{{type|number}} y coordinate
|-
! scope="row" | [[mouse_scroll (event)|mouse_scroll]]
|Fired when a mousewheel is scrolled.
|{{type|number}} scroll direction (-1 for up, 1 for down)
|{{type|number}} x coordinate(in screen chars)
|{{type|number}} y coordinate(in screen chars)
|-
! scope="row" | [[mouse_drag (event)|mouse_drag]]
|Fired when the mouse is moved after clicking.
|{{type|number}} mouse button
|{{type|number}} x coordinate(in screen chars)
|{{type|number}} y coordinate(in screen chars)
|-
! scope="row" | [[monitor_touch (event)|monitor_touch]]
|Fired when a player right click on an advanced monitor connected.
|{{type|string}} side
|{{type|number}} x coordinate(in screen chars)
|{{type|number}} y coordinate(in screen chars)
|-
! scope="row" | [[monitor_resize (event)|monitor_resize]]
|Fired when a monitor resizes
|{{type|string}} side
|
|
|}

== Guides ==
[http://www.computercraft.info/forums2/index.php?/topic/1516-ospullevent-what-is-it-and-how-is-it-useful/page__view__findpost__p__11156 ''Onionnion's Guide on os.pullEvent()'']

[[Category:Lua_Core_Functions]]

Shell.programs

2013-04-20T05:36:18Z

1lann: Forgot to add a space at the front to declare it as code :-/

{{Stub}}
Shell.programs is a shell command used to list possible programs you can run, from programs that are in your current directory and programs that have an alias.

== Example ==
textutils.tabulate(shell.programs()) -- Would list all the programs like running the program "programs"
textutils.tabulate(shell.programs(true)) -- Would list all programs including hidden ones that have a . prefix

Shell.programs

2013-04-20T05:35:28Z

1lann: Fixed the example. Requires mention of what it returns and arguments, and visual fixes.

ComputerCraft IRC

2013-04-13T23:48:28Z

1lann: Added a tad more information

{{Stub}}
The ComputerCraft IRC is the official IRC. It's channel is #computercraft. If you are using an IRC client, the IP is: irc.esper.net:5555 A link to the webchat is [http://webchat.esper.net/?channels=#computercraft here.] Most development information is gained from this. The IRC is a great place to ask for help on any of your programs, talk live to other CC enthusiasts and moderators/administrators, on about ComputerCraft or anything.

[[Category:Lists]]

Turtle.craft

2013-04-13T12:54:02Z

1lann: Fixed link

{{lowercase}}
{{Function
|name=turtle.craft
|args=[[int (type)|number]] quantity ( if not supplied will craft as many as possible )
|returns=[[boolean (type)|boolean]] if an item was crafted
|api=turtle
|addon=ComputerCraft
|desc=Requires a [[Turtle|Crafty Turtle]].
Crafts an item if items in the turtle's inventory matches a valid recipe. The items can be placed anywhere as long as they are oriented properly with respect to one another.
Can craft a maximum of one stack of items at a time; for example, if you put three stacks of 64 reed in a line and craft them, only 63 paper will be crafted, and three piles of 43 reed will remain in the turtle.
Will not craft if there are any items in the turtle's inventory that are not part of the recipe, including in the slots not used for crafting.
The produced items will appear in the selected slot, if that slot is free. If not, it will try the next available slot.
A parameter can also be supplied to specify the quantity of items to craft.
|examples=
{{Example
|desc=Crafts as many items as possible
|code=print( turtle.craft() )
|output=prints a [[boolean (type)|boolean]] representing if an item was crafted
}}
{{Example
|desc=Crafts 5 items
|code=print(turtle.craft(5))
|output=prints a [[boolean (type)|boolean]] representing if items were crafted
}}
}}

[[Category:Lua_Core_Functions]]

Turtle

2013-04-13T12:05:12Z

1lann: Changed links from Modem to Wireless Modem

'''Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS, like the [[Computer|Computers]], named [[TurtleOS]]. They have the ability to place, break and detect blocks, move around and drop items in their inventory. The programs they run are stored on its internal memory or [[Floppy Disk|floppy disks]].

The 1.4 update was focused on turtles, and expanded the turtle's 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 - over the previous 9 slot inventory. The 1.4 update also included a new fuel system for the turtles.

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)|Turtle API]].

==Fake Player==
Turtles use a Fake Player when moving and placing block in the world, as well as attacking entities. Each Turtle has a fake player named <nowiki>[</nowiki>ComputerCraft:''<id>''<nowiki>]</nowiki>, where ID is the ID of the Turtle (obtainable by typing ''id'' into the Turtle). Turtles work and follow the permissions of all world protection and zone plugins if permissions are set for these fake players. '''All''' Turtles can be restricted by using the fake player <nowiki>[</nowiki>ComputerCraft<nowiki>]</nowiki>. Every turtle will attempt to identify as this fake player as well as <nowiki>[</nowiki>ComputerCraft:''<id>''<nowiki>]</nowiki>.

==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 Disk|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|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|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 96 block movements. For more information, go to the [[Turtle.refuel]] page.

=== 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 the turtle config file (config/mod_CCTurtle.cfg) and setting <var>turtleNeedsFuel</var> to <var>0</var>.

==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 [http://www.minecraftwiki.net/wiki/Crafting_Table 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, [[Printer|printers]] and even blocks with inventories in other mods. (This means a turtle cannot interact with a player's inventory). Turtles can interact with such inventories by using [[Turtle.suck|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, ect.) Turtles can also place items inside inventories, by using [[Turtle.drop|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)

==Recipes==

{|
|+'''Crafting ingredients'''
|-
|Turtle
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle |Output-link=turtle
}}
|}
Turtles can be equipped with different peripherals and tools. A turtle can only have one tool and one peripheral, however the crafting table can act as a tool, or peripheral.
<br>The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
<br>The following peripherals can be equipped to a turtles: [[Wireless Modem|wireless modem]] and [[Workbench|crafting tables]].
<br>Diamond tools must be unused (i.e. not have a durability bar showing) to combine with a turtle.
<br><br>'''Turtle recipe and examples for equipping a turtle with tools and peripherals.'''
{| class="wikitable"
! !! None !! Crafty !! Wireless
|-
! scope="row"| None
|{{Crafting grid
|B2=turtle
|Output=turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=workbench
|Output=Crafty_Turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=Modem
|Output=wireless_turtle |Output-link=turtle
}}
|-
! scope="row"| Mining
|{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_pickaxe
|Output=Crafty_Mining_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_pickaxe
|Output=wireless_mining_turtle |Output-link=turtle
}}
|-
! scope="row"| Farming
|{{Crafting grid
|B2=turtle |C2=diamond_hoe
|Output=Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_hoe
|Output=Crafty_Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_hoe
|Output=Wireless_Farming_Turtle |Output-link=turtle
}}
|-
! scope="row"| Melee
|{{Crafting grid
|B2=turtle |C2=diamond_sword
|Output=Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_sword
|Output=Crafty_Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_sword
|Output=Wireless_Melee_Turtle |Output-link=turtle
}}
|-
! scope="row"| Felling
|{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_axe
|Output=Crafty_Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_axe
|Output=Wireless_Felling_Turtle |Output-link=turtle
}}
|-
! scope="row"| Digging
|{{Crafting grid
|B2=turtle |C2=diamond_shovel
|Output=Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_shovel
|Output=Crafty_Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_shovel
|Output=Wireless_Digging_Turtle |Output-link=turtle
}}
|-
! scope="row"| Crafty
|See Above
|N/A
|{{Crafting grid
|A2=Modem |B2=turtle |C2=workbench
|Output=Wireless_Crafty_Turtle |Output-link=turtle
}}
|}
[[Category:Blocks]]

Rednet Tutorial

2013-04-13T12:02:17Z

1lann: Changed link to Modem to Wireless Modem

Rednet is an API that allows computers and turtles interact with each other wirelessly.

== Getting started ==

* Attach a [[Wireless Modem|wireless modem]] to your [[Computer|computer]].
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_torch |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=Modem
}}

A modem is made using 8 stone blocks surrounding a redstone torch.

== Rednet scripts ==
Rednet uses several methods to interact with other computers.

Here is a basic program that runs most of them. It requires 2 PCs.

PC1
[[Rednet_(API)|rednet]].[[Rednet.open|open]]("right") --enable the modem attached to the right side of the PC
[[Rednet_(API)|rednet]].[[Rednet.broadcast|broadcast]]("Hello world") --send "Hello world" over rednet to all PCs in range
[[print]]("PC1 - Hello world")
id,message = [[Rednet_(API)|rednet]].[[Rednet.receive|receive]]() --wait until something is received over rednet
if id == 2 and message == "Hello from pc2" then
[[write]]("PC2 -")
[[print]](message)
[[Rednet_(API)|rednet]].[[Rednet.send|send]](2,"How are you") --Send a message only to the PC with ID 2
[[print]]("PC1 - How are you")
id,message = [[Rednet_(API)|rednet]].[[Rednet.receive|receive]](10) --Wait until a message arrives or 10 seconds pass
if message == "Fine thanks" then
[[print]]("PC2 - Fine thanks")
end
end
[[print]]("disconnecting")
[[Rednet_(API)|rednet]].[[Rednet.close|close]]("right") --disable modem on the right side of the PC

PC2
[[Rednet_(API)|rednet]].[[Rednet.open|open]]("right") --enable modem on the right side of the PC
id,message = [[Rednet_(API)|rednet]].[[Rednet.receive|receive]]() --wait until a mesage is received
if id == 1 and message == "Hello world" then
[[Rednet_(API)|rednet]].[[Rednet.send|send]](1,"Hello from pc2") -- send a message to only the PC with ID 1
id,message = [[Rednet_(API)|rednet]].[[Rednet.receive|receive]]() -- Wait until a message is received
if message == "How are you" then
[[Rednet_(API)|rednet]].[[Rednet.broadcast|broadcast]]("Fine thanks") -- Send to all PCs in range
end
end
[[Rednet_(API)|rednet]].[[Rednet.close|close]]("right") -- disable modem on the right side of the PC

Open PC2 first after that open PC1 and then run the program

[[Category:Tutorials]]

Modem

2013-04-13T12:01:27Z

1lann: Wait nevermind what I did earlier... Changed redirect page to a normal page

Modems are a peripheral which allow computers to communicate with other computers

==Wireless Modems==
[[Wireless Modem|Wireless modems]] allows communication wirelessly between computers through channels
==Wired Modems==
[[Wired Modem|Wired modems]] allows communication through Networking Cables to other computers and peripherals

Modem

2013-04-13T11:53:09Z

1lann: Added reason

Networking Cable

2013-04-13T11:52:46Z

1lann: Added reason

Modem

2013-04-13T11:49:55Z

1lann: Sorry! Redirect page I created... Added delete tag.

Networking Cable

2013-04-13T11:49:42Z

1lann: Sorry! Redirect page I created... Added delete tag.

Alarm (event)

2013-04-13T02:05:49Z

1lann: Removed needs work box

{{Event
|name=alarm
|desc=Fired when an alarm has expired.
|return1=The alarm's numerical representation value (returned when [[os.setAlarm|os.setAlarm()]] is initially called).
|examples=
{{Example
|desc=Sets the alarm for 1 (in-game) hour, then waits for the event to fire
|code=local alarm = os.setAlarm(os.time()+01.00) -- Sets the Alarm for 1 hour after the current time<br>while true do<br> local _, id = os.pullEvent("alarm") -- Waits for the alarm event<br> if id == alarm then -- Checks to see if it's the alarm we created<br> print("The alarm has gone off!")<br> break -- Get out of the loop<br> end<br>end
}}
}}

Alarm (event)

2013-04-13T02:04:46Z

1lann: Added example

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:13, 30 November 2012 (MSK)''}}

{{Event
|name=alarm
|desc=Fired when an alarm has expired.
|return1=The alarm's numerical representation value (returned when [[os.setAlarm|os.setAlarm()]] is initially called).
|examples=
{{Example
|desc=Sets the alarm for 1 (in-game) hour, then waits for the event to fire
|code=local alarm = os.setAlarm(os.time()+01.00) -- Sets the Alarm for 1 hour after the current time<br>while true do<br> local _, id = os.pullEvent("alarm") -- Waits for the alarm event<br> if id == alarm then -- Checks to see if it's the alarm we created<br> print("The alarm has gone off!")<br> break -- Get out of the loop<br> end<br>end
}}
}}

Textutils (API)

2013-04-13T01:31:36Z

1lann: Whoops, fixed grammar and spelling

{{NeedsWork|Needs <s>5</s> 3 function pages, 1 function descriptions. ''[[User:AfterLifeLochie|AfterLifeLochie]] 02:40, 29 November 2012 (MSK)''}}
The Textutils API is used to format and manipulate strings easily.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Textutils (API)
</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.slowPrint]]([[string (type)|string]] text, [[int (type)|int]] rate)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Slowly prints the text. Only difference is, it leaves a new-line after it.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.slowWrite]]([[string (type)|string]] text, [[int (type)|int]] rate)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Slowly writes the text.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.formatTime]]([[int (type)|int]] time, [[boolean (type)|bool]] TwentyFourHour)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Put a time into it, and it spews it out in a different format. Example: print(textutils.formatTime(os.time(), false))</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.tabulate]]([[table (type)|table]] table, [[table (type)|table]] table2, ...)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Prints tables in an ordered form. Each table is a row, the column(s)' width is auto-adjusted.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.pagedTabulate]]([[table (type)|table]] table, [[table (type)|table]] table2, ...)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Prints tables in an ordered form, like [[textutils.tabulate]]. However, it waits for confirmation before scrolling down..</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.pagedPrint]]([[string (type)|string]] text, [[string (type)|string]] confirmation_lines)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Prints string ''text'' onto the screen, but waits for confirmation before scrolling down.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.serialize]]([[table (type)|table]] table)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a string representation of the table ''table'' for storage or transmission.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.unserialize]]([[string (type)|string]] text)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a table reassembled from the string ''text''.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.urlEncode]]([[string (type)|string]] text)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Makes a string safe to encode into a url. Spaces are replaced with +s. Unsafe characters such as '\', '£' and '}' are translated into ASCII code and preceded with a % for transmission. For reference visit: [http://www.blooberry.com/indexdot/html/topics/urlencoding.htm].</td></tr>
</table>

[[Category:APIs]]

Textutils (API)

2013-04-13T01:30:44Z

1lann: Added description for pagedTabulate

{{NeedsWork|Needs <s>5</s> 3 function pages, 1 function descriptions. ''[[User:AfterLifeLochie|AfterLifeLochie]] 02:40, 29 November 2012 (MSK)''}}
The Textutils API is used to format and manipulate strings easily.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Textutils (API)
</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.slowPrint]]([[string (type)|string]] text, [[int (type)|int]] rate)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Slowly prints the text. Only difference is, it leaves a new-line after it.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.slowWrite]]([[string (type)|string]] text, [[int (type)|int]] rate)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Slowly writes the text.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.formatTime]]([[int (type)|int]] time, [[boolean (type)|bool]] TwentyFourHour)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Put a time into it, and it spews it out in a different format. Example: print(textutils.formatTime(os.time(), false))</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.tabulate]]([[table (type)|table]] table, [[table (type)|table]] table2, ...)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Prints tables in an ordered form. Each table is a row, the column(s)' width is auto-adjusted.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.pagedTabulate]]([[table (type)|table]] table, [[table (type)|table]] table2, ...)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Prints tables in an ordered form, like [[textutils.tabulate]]. However it waits for conformation before scrolling down..</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.pagedPrint]]([[string (type)|string]] text, [[string (type)|string]] confirmation_lines)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Prints string ''text'' onto the screen, but waits for confirmation before scrolling down.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.serialize]]([[table (type)|table]] table)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a string representation of the table ''table'' for storage or transmission.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.unserialize]]([[string (type)|string]] text)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a table reassembled from the string ''text''.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[textutils.urlEncode]]([[string (type)|string]] text)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Makes a string safe to encode into a url. Spaces are replaced with +s. Unsafe characters such as '\', '£' and '}' are translated into ASCII code and preceded with a % for transmission. For reference visit: [http://www.blooberry.com/indexdot/html/topics/urlencoding.htm].</td></tr>
</table>

[[Category:APIs]]

Networking Cable

2013-04-11T01:14:44Z

1lann: Redirect to Wired Modem

#REDIRECT [[Wired_Modem]]

Turtle

2013-04-11T01:05:41Z

1lann: Added inventory interaction section and some other things

'''Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS, like the [[Computer|Computers]], named [[TurtleOS]]. They have the ability to place, break and detect blocks, move around and drop items in their inventory. The programs they run are stored on its internal memory or [[Floppy Disk|floppy disks]].

The 1.4 update was focused on turtles, and expanded the turtle's 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 - over the previous 9 slot inventory. The 1.4 update also included a new fuel system for the turtles.

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)|Turtle API]].

==Fake Player==
Turtles use a Fake Player when moving and placing block in the world, as well as attacking entities. Each Turtle has a fake player named <nowiki>[</nowiki>ComputerCraft:''<id>''<nowiki>]</nowiki>, where ID is the ID of the Turtle (obtainable by typing ''id'' into the Turtle). Turtles work and follow the permissions of all world protection and zone plugins if permissions are set for these fake players. '''All''' Turtles can be restricted by using the fake player <nowiki>[</nowiki>ComputerCraft<nowiki>]</nowiki>. Every turtle will attempt to identify as this fake player as well as <nowiki>[</nowiki>ComputerCraft:''<id>''<nowiki>]</nowiki>.

==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 Disk|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 [[Modem|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|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 96 block movements. For more information, go to the [[Turtle.refuel]] page.

=== 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 the turtle config file (config/mod_CCTurtle.cfg) and setting <var>turtleNeedsFuel</var> to <var>0</var>.

==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 [http://www.minecraftwiki.net/wiki/Crafting_Table 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, [[Printer|printers]] and even blocks with inventories in other mods. (This means a turtle cannot interact with a player's inventory). Turtles can interact with such inventories by using [[Turtle.suck|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, ect.) Turtles can also place items inside inventories, by using [[Turtle.drop|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)

==Recipes==

{|
|+'''Crafting ingredients'''
|-
|Turtle
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle
}}
|}
Turtles can be equipped with different peripherals and tools. A turtle can only have one tool and one peripheral, however the crafting table can act as a tool, or peripheral.
<br>The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
<br>The following peripherals can be equipped to a turtles: [[modem|wireless modem]] and [[Workbench|crafting tables]].
<br>Diamond tools must be unused (i.e. not have a durability bar showing) to combine with a turtle.
<br><br>'''Turtle recipe and examples for equipping a turtle with tools and peripherals.'''
{| class="wikitable"
! !! None !! Crafty !! Wireless
|-
! scope="row"| None
|{{Crafting grid
|B2=turtle
|Output=turtle
}}
|{{Crafting grid
|B2=turtle |A2=workbench
|Output=Crafty_Turtle
}}
|{{Crafting grid
|B2=turtle |A2=Modem
|Output=wireless_turtle
}}
|-
! scope="row"| Mining
|{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_pickaxe
|Output=Crafty_Mining_Turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_pickaxe
|Output=wireless_mining_turtle
}}
|-
! scope="row"| Farming
|{{Crafting grid
|B2=turtle |C2=diamond_hoe
|Output=Farming_Turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_hoe
|Output=Crafty_Farming_Turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_hoe
|Output=Wireless_Farming_Turtle
}}
|-
! scope="row"| Melee
|{{Crafting grid
|B2=turtle |C2=diamond_sword
|Output=Melee_Turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_sword
|Output=Crafty_Melee_Turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_sword
|Output=Wireless_Melee_Turtle
}}
|-
! scope="row"| Felling
|{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_axe
|Output=Crafty_Felling_Turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_axe
|Output=Wireless_Felling_Turtle
}}
|-
! scope="row"| Digging
|{{Crafting grid
|B2=turtle |C2=diamond_shovel
|Output=Digging_Turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_shovel
|Output=Crafty_Digging_Turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_shovel
|Output=Wireless_Digging_Turtle
}}
|-
! scope="row"| Crafty
|See Above
|N/A
|{{Crafting grid
|A2=Modem |B2=turtle |C2=workbench
|Output=Wireless_Crafty_Turtle
}}
|}
[[Category:Blocks]]

Rednet (API)

2013-04-11T00:26:04Z

1lann: Added a new line to make the box smaller.

{{msgbox
|title=Please Note
|text=As of ComputerCraft 1.5, the Rednet API is just a wrapper for [[Modem_(API)|modems and channels]], and no longer supports<br>transmitting data through Bundled Cables. However interacting with Bundled Cables is still available via the [[Redstone_(API)|Redstone API]]
}}

The Rednet API allows computers to communicate between themselves without using redstone wires. In order to send and receive data, a [[modem]] is required. The data is received immediately after sending it, but only by computers within a certain range. That range depends on the altitude of the sending computer increasing with higher altitudes to a max of 384.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Rednet (API)
</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.open]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tells the computer that the side can be used for networking.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.close]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tells the computer that the side can no longer be used for networking.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.announce]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Broadcasts an empty rednet message.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.send]](receiverID, message)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sends a message to the computer using the opened sides. The receiver ID is the ID (number, not string) of the computer you're sending the message to. ID as nil will do the same as a broadcast. The message must be a string to send across rednet, if you are wanting to send a table see [[textutils.serialize]]</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.broadcast]](message)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sends the message to ALL connected and open computers.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.receive]](timeout)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Waits until it received a rednet message or <var>timeout</var> has passed. Leave args empty to wait for a message forever.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.isOpen]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns true if the wireless modem is open.</td></tr>
</table>

==Events==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Event name
!style="background:#EEE" width="*"|Description
!style="background:#EEE" width="*"|Parameters
|-
|rednet_message
|Fired when a rednet message is received (can be used as alternative for rednet.receive())
|senderId, message, distance
|}

==History==
Before the creation of the in-game wireless networking API, the term "Rednet" referred to a system created by one of the ComputerCraft users based on bundled cables from a popular Minecraft mod - RedPower. It also allowed communication between computers, but the data was transferred slowly - every bit was converted to redstone signal, that lasted about 0,1 seconds. On the release of ComputerCraft 1.3, the system became useless, as the wireless networking was officially implemented to the mod.

[[Category:APIs]]

Rednet (API)

2013-04-11T00:23:13Z

1lann: Mention that the rednet API no longer supports bundled cables.

{{msgbox
|title=Please Note
|text=As of ComputerCraft 1.5, the Rednet API is just a wrapper for [[Modem_(API)|modems and channels]], and no longer supports transmitting data through Bundled Cables. However interacting with Bundled Cables is still available via the [[Redstone_(API)|Redstone API]]
}}

The Rednet API allows computers to communicate between themselves without using redstone wires. In order to send and receive data, a [[modem]] is required. The data is received immediately after sending it, but only by computers within a certain range. That range depends on the altitude of the sending computer increasing with higher altitudes to a max of 384.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Rednet (API)
</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.open]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tells the computer that the side can be used for networking.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.close]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tells the computer that the side can no longer be used for networking.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.announce]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Broadcasts an empty rednet message.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.send]](receiverID, message)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sends a message to the computer using the opened sides. The receiver ID is the ID (number, not string) of the computer you're sending the message to. ID as nil will do the same as a broadcast. The message must be a string to send across rednet, if you are wanting to send a table see [[textutils.serialize]]</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.broadcast]](message)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sends the message to ALL connected and open computers.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.receive]](timeout)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Waits until it received a rednet message or <var>timeout</var> has passed. Leave args empty to wait for a message forever.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.isOpen]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns true if the wireless modem is open.</td></tr>
</table>

==Events==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Event name
!style="background:#EEE" width="*"|Description
!style="background:#EEE" width="*"|Parameters
|-
|rednet_message
|Fired when a rednet message is received (can be used as alternative for rednet.receive())
|senderId, message, distance
|}

==History==
Before the creation of the in-game wireless networking API, the term "Rednet" referred to a system created by one of the ComputerCraft users based on bundled cables from a popular Minecraft mod - RedPower. It also allowed communication between computers, but the data was transferred slowly - every bit was converted to redstone signal, that lasted about 0,1 seconds. On the release of ComputerCraft 1.3, the system became useless, as the wireless networking was officially implemented to the mod.

[[Category:APIs]]

Monitor

2013-04-11T00:14:53Z

1lann: Mentioned the maximum size of a monitor.

{{Block
|name=Monitor
|image=Iso_Monitor.png
|id=4094
|damage-value=0
|is-peripheral=Yes
|peripheral-api=Term (API)
}}
The '''Monitor''' is a block that can display text on its front side. When several screen blocks are placed on the same plane, it will form a single monitor. The maximum size of a single monitor is 8 blocks wide and 6 blocks tall, and must be placed to be shaped as a rectangle, else it will separate into multiple parts. It is useful for displaying information at a server spawn, showing a program on the monitor, and even showing the status of an IC2 reactor! (provided you have [[CcSensors]] installed)

==Recipe==
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=glass_pane |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=Monitor
}}
[[Category:Blocks]]

==Redirecting Programs to a Monitor==
[[File:Computer_w_DiskDrive_w_Monitor.png|frame|428x241px|right|A 2x2 [[Monitor]], connected to a [[Computer]], with a [[Disk Drive]] connected.]]
From the CraftOS shell, type <tt>monitor [top|bottom|left|right|front|back] [a-program-name]</tt>. For example, typing <tt>monitor top hello</tt> would show "Hello world." on the top Monitor.

==Monitor as a Peripheral==
To use a Monitor, you need to either call a method directly using [[peripheral.call]](), or, wrap the monitor using the [[Peripheral_(API)|Peripheral API]]. Wrapped monitors provide all functions listed in the [[Term_(API)|Term API]], with the exception of [[Monitor.setTextScale|monitor.setTextScale(size)]], which is native to monitors only.

For this example, we have a Monitor connected to the top of our [[Computer]]:

-- Immediately invoke a method without wrapping
peripheral.call("top", "write", "Hello World!")

-- You can also "wrap" the peripheral side to a variable:
local monitor = peripheral.wrap("top")
monitor.write("Hello World!")

[[Category:Blocks]][[Category:Peripherals]]

Modem (API)

2013-04-11T00:07:38Z

1lann: Makes it clear that you can also do peripheral.call

:''This page is for the modem API. For the blocks, see [[Modem]].''

With the advent of ComputerCraft 1.5, the behavior of modems has changed somewhat drastically. Although the rednet api still has the same functionality, it is really just a wrapper for what is a completely different system underneath.

The major change introduced to modems in this version of ComputerCraft is channels: Channels are essentially open networks which can be opened, closed, and listened on by any computer within range. To interact with channels, one must wrap/interact directly with the peripheral as opposed to the previous interaction with the rednet API.

Here is a list of functions available from modems:
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Function
!style="background:#EEE" width="*"|Description
|-
|isOpen( [[int_(type)|int]] channel )
|Check to see if the specified channel is open
|-
|open( [[int_(type)|int]] channel )
|Opens the specified channel to allow for listening. The channel specified must be larger than 0 and less than 65535.
|-
|close( [[int_(type)|int]] channel )
|Closes an open channel to disallow listening
|-
|closeAll( )
|Closes all open channels
|-
|transmit( [[int_(type)|int]] channel, [[int_(type)|int]] replyChannel, [[string_(type)|string]] message )
|Transmits a message on the specified channel
|-
|isWireless( )
|Returns true if the modem is wireless; false if it is wired.
|}
==Sending Messages==
Sending messages is simple and does not require that you open any channels. Simply use the transmit function like so:
<span>
local modem = peripheral.wrap("right") --Wraps the modem on the right side.
modem.transmit(3, 1, "Hello world!")
peripheral.call("right", "transmit", 3, 1, "This will also work!")
</span>

What did that do? First I wrapped the peripheral in order to interact with it. Second, I used modem.transmit(channel, replyChannel, message) in order to send my message. In case you were wondering, the reply channel is captured by the listening computer and suggests which channel they should reply on.

==Receiving Messages==
Receiving messages requires that you be familiar with events. As of this moment, there is no api which cuts out events from the process. Here is an example of how to receive messages:
<span>
local modem = peripheral.wrap("left")
modem.open(3)--Open channel 3 so that we can listen on it
local event, modemSide, senderChannel,
replyChannel, message, senderDistance = os.pullEvent("modem_message")
print("I just received a message from: "..senderChannel)
print("I should apparently reply on: "..replyChannel)
print("The modem receiving this is located on the "..modemSide.." side")
print("The message was: "..message)
print("The sender is: "..senderDistance.." blocks away from me.")
</span>
So what did I do? Quite simply, I called os.pullEvent() with the string argument "modem_message", which blocks all other events from being returned. When the "modem_message" event is captured, it returns the arguments: event, modemSide, senderChannel, replyChannel, message, senderDistance. I captured these and then printed them out.

==Keep in Mind...==
* You can only open 128 channels at any given time.
* The max channel you can open is 65535.
* You can listen on more than one channel at a time. For example, if I have channel 3 and channel 5 open and somebody sends a message on channel 5, I will still receive it. If they send a message on channel 3, I will receive that.
* Sending messages does not require you to open any channels prior to sending it.
* If you aren't receiving a message when you think you should, check to make sure that you have opened the channel first!
* Modems and channels are not secure! If you are sending a message over rednet, it is available to any computer listening on the sent channel.

[[Category:APIs]]

Peripheral (API)

2013-04-11T00:04:14Z

1lann: Link to Category:Peripherals

The Peripheral API is for interacting with external [http://en.wikipedia.org/wiki/Peripheral peripherals], such as the [[Disk Drive]], the [[Advanced Monitor]] and [[Monitor]]. (More peripherals can be found under [[:Category:Peripherals|here]])<br />
[[Computer|Computers]] and [[Turtle|Turtles]] are also considered peripherals and you can interface two adjacent computers, although in a more limited fashion compared to [[Rednet (API)|rednet]]. Both Computers and Turtles provide the same methods: ''turnOn'', ''shutdown'', ''reboot'', ''getID''.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Peripheral (API)
</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[peripheral.isPresent]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns '''true''' if a peripheral is present on ''side''.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[peripheral.getType]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the type or peripheral present on ''side'', nothing returned if ''side'' is empty.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[peripheral.getMethods]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a table containing all methods for peripheral on ''side''.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[peripheral.call]](side, methodName, param1, param2, ...)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sends a function call to peripheral located on ''side''. Return values match those of called method.<br />'''Note:''' ''methodName'' is a string.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[peripheral.wrap]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a handle to the peripheral located on ''side''. If assigned to a variable, it can be used to call all methods available from that peripheral, as if calling '''peripheral.call()''', e.g.:<br />m = [[peripheral.wrap]]("left")<br />m.someMethod()<br />''- is the same as -''<br />[[peripheral.call]]("left","someMethod")</td></tr>

</table>

[[Category:APIs]]

==Remote Peripherals using Networking Cables==
Using Networking Cables, you can attach and use peripherals without having them directly touching the computer. To connect a peripheral in this way, place a Wired Modem on any side of your computer, as you would a [[Wireless Modem]], as well as all the peripherals you wish to connect, connecting all of them with Networking Cables. Then right click each of the wired modems. You should receive messages in your chat bar informing you of a successful connection. Don't forget to connect the [[Computer|computer]] too!

Finally, you need to wrap the wired modem on your [[Computer|computer]] using the methods above. As well as those outlined on the [[Modem_(API)| Modem API]] page, the following additional functions will then become available to you, where ''p'' is the variable the modem is wrapped to:

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">p.getNamesRemote()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the names of all connected peripherals. Peripheral names are the type of peripheral followed by an underscore and a unique number, e.g. ''"disk_0"''.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">p.isPresentRemote(peripheral name)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns '''true''' if the specified peripheral is connected; '''false''' otherwise. </td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">p.getTypeRemote(peripheral name)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the type of the specified peripheral.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">p.getMethodsRemote(peripheral name)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a table of all the methods for the specified peripheral. </td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">p.callRemote(peripheral name, peripheral method)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Calls the specified method for the specified peripheral.</td></tr>
</table>

==Monitor==
[[Monitor#Peripheral_Functions|Monitor Peripheral functions]] have been moved to the [[Monitor]] page.
In addition, the [[Advanced_Monitor#Peripheral_Functions|Advanced Monitor Peripheral functions]] have been moved to the [[Advanced Monitor]] page.

==Printer==
[[Printer#Peripheral_Functions|Printer Peripheral functions]] have been moved to the [[Printer]] page.

==Computers==
[[Computer#Peripheral_Functions|Computer Peripheral functions]] have been moved to the [[Computer]] page.
In addition, the [[Advanced_Computer#Peripheral_Functions|Advanced Computer Peripheral functions]] have been moved to the [[Advanced Computer]] page.

[[Category:APIs]]