ComputerCraft Wiki - User contributions [en]

Category talk:Notable Programs

2015-09-06T04:36:05Z

Cranium: Created page with "Before deletion, we should have a discussion re: the replacement for this page on the main page. What should be put there first before I go chopping willy-nilly at the page? ~~~~"

Before deletion, we should have a discussion re: the replacement for this page on the main page. What should be put there first before I go chopping willy-nilly at the page? [[User:Cranium|Cranium]] ([[User talk:Cranium|talk]]) 04:36, 6 September 2015 (UTC)

Turtle

2015-09-06T04:29:26Z

Cranium: removal of workbench reference

{{Block
|name=Turtle
|image=Grid turtle.png
|id=
|damage-value=
|is-peripheral=
}}

{{Selfref|This is for the turtle block/item. For the API, visit [[Turtle (API)]].}}

[[File:Turtles.png|thumb|Normal Turtle (left) and Advanced Turtle (right).]]

'''Turtles''' and '''Advanced Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS named [[TurtleOS]], similar to [[CraftOS]] for [[Computer]]s. They have the ability to place, break and detect blocks, move around and drop items in their inventory via their access to the [[Turtle_(API)|Turtle API]]. The programs they run are stored in their internal memory, or on [[Floppy Disk|floppy disks]].

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

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

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

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

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

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

==Floppy Disks and Peripherals==
Turtles do not have a built-in [[Disk Drive]]. As such, they need a [[Disk Drive]] placed beside them to access [[Floppy 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 80 block movements.

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

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

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

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

==Crafting==
Turtles with a [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]]s 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).

==Peripheral functions==

Just like a [[Computer]], a Turtle can be [[peripheral.wrap|used]] as a peripheral. You can find all Turtle peripheral functions [[Computer_(API)|here]].

==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=Advanced_Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=Advanced_Turtle |Output-link=turtle
}}
|}

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

Turtles can be equipped with different peripherals and tools. A turtle can only be crafted with one tool and one peripheral, however the crafting table can act as a tool, or peripheral. Turtles may later use [[Turtle.equipLeft|turtle.equipLeft()]] / [[Turtle.equipRight|turtle.equipRight()]] to add, remove or exchange tools in any combination.
<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 [[Crafting Table|crafting tables]].
<br>Diamond tools must be unused (i.e. not have a durability bar showing) an unenchanted 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]]

Number (type)

2015-09-06T04:24:37Z

Cranium: int and float pages deleted, as info is on this page now

A '''number''' is a data type which represents any real number (for example, 1, -900.1, or 13.37). There are a two types of different numbers that can be used within Lua programming.

==int==
An '''int''' (short for 'integer') is a data type which represents a real, absolute number.

An integer is a whole-number (without an express or implied decimal point). For example, 1, 5, -102 and 101283 are all integers. Numbers like 9.5, 8.3 and -53124.4 are not integers, they are floating point numbers.

==Float==
'''Float''' (short for "floating point") is a data-type for numbers.

Floating point numbers are decimals; they have an expressed decimal point and value (regardless of the value after the decimal place). For example, 1.4 and 5.2 are floats, and 1.0, 5.0 and 1293.0 are also floating point numbers.

Numbers without an express (or in the case of a floating point number, implied) decimal point are integers.

==More information==
For a more in-depth and concise explanation of types, please consult the [http://www.lua.org/manual/5.1/manual.html#2.2 Lua 5.1 Official Manual].

[[Category:Lua_Types]]

Wiki Todo

2015-09-06T04:20:33Z

Cranium: /* General Wiki Stuff */ Pages have apparently been added that address the missing vanilla links

<div style="padding-left: 8px; float: right">{{List of Administrators}}</div>
<span style='font-size: 132%; font-weight:bold;'>This page lists where work is needed to be done on the wiki. If you would like to help, we ask that you please make an account and help wherever you can.</span>

''If you need to contact an Administrator, please visit an admin's userpage, and leave a note on their talk page.''

'''If you make a change here, please give us as much detail as you can, and sign the end of your change using four tildes, like so: <nowiki>~~~~</nowiki>. This allows us to get back to you if we need more information.'''

__TOC__

== Missing, ToDelete & NeedsWork Pages ==
* The [[:Category:Pages_Needing_Changes|Pages Needing Changes]] list shows all the pages that have been tagged with <nowiki>{{NeedsWork}}</nowiki> or <nowiki>{{Stub}}</nowiki>. These pages either need more information, to be tidied, re-worded or adjusted, or just needs some TLC.
* The [[Special:WantedPages| Wanted Pages]] list shows all the pages that are missing (have been linked to, but aren't there). You should first check that the page being requested doesn't already exist (in case the person misspelled the page) and then, if you're feeling adventurous, put together a page. You can always come back, or tag the page with a <nowiki>{{NeedsWork}}</nowiki> or a <nowiki>{{Stub}}</nowiki> tag. If you need help, ask us! We don't bite.
* The [[:Category:Pages_Recommended_for_Deletion|Pages Recommended for Deletion]] list shows all the pages that have been tagged with <nowiki>{{ToDelete}}</nowiki>, their content is obsolete, duplicitous or irrelevant. Pages in this category have been recommended for deletion by editors who do not have the ability to do so. Users with the ability to do so should delete pages they believe should be removed and remove the tag from pages they believe shouldn't.

== Additional Tasks ==
*[[Vector_(API)|Vector]] <s>(Needs link to page explaining or description explaining what a vector is and function pages)</s>
** <s>It now has a link to Wikipedia, but it doesn't use any of the method or example templates. Can we get this rectified? ''[[User:AfterLifeLochie|AfterLifeLochie]] 02:14, 29 November 2012 (MSK)''</s>
** Now has pages to every function in a standard template. May need to double check work for any broken links or missing pages. Examples and descriptions probably need work. ''[[User:MafiaMoe|MafiaMoe]] 18:38, 23 February 2013 (MSK)''
* Some links don't link to their correct pages, resulting in page duplication and wasting time deleting pages. Can sometimes be found in the [[Special:WantedPages| Wanted Pages.]]

== Wiki Admin Things ==
=== General Wiki Stuff ===
* Would it be possible to get lua syntax highlighting for tutorials and program code? I noticed that Wikipedia has syntax highlighting for lua, which they can do using: <tt><syntaxhighlight lang="lua"> </syntaxhighlight></tt> tags. I looked it up, and Wikipedia appears to use [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight GeSHi] which is a GPL mediawiki extension. There's a download link on that page, and Wikipedia appears to have instructions for installing extensions [https://www.mediawiki.org/wiki/Manual:Extensions#Installing_an_extension here]. I think this would be an awesome addition for the Computercraft Wiki. :) -[[User:Turkey|Turkey]] 23:45, 29 August 2014 (GMT)
[[Category:Lists]]

=== Need Update ===
What about those pages with only one sentence in it like [[Water]]? Shoudn't we delete them, it's not a "official" part of Computercraft. --[[User:LuckyLuke|LuckyLuke]] ([[User talk:LuckyLuke|talk]]) 15:58, 30 July 2015 (UTC)

CraftOS Shell

2015-09-06T04:18:58Z

Cranium: Minor change for table color format

<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]]  
CraftOS Shell Programs
</td></tr>
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Program 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;"><div id="cmd-alias">[[alias]]</div><tt>alias <alias> <program></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Maps an alias string to a program.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[apis]]</div><tt>apis</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists all loaded APIs.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[bg]]</div><tt>bg <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens the specified script in a new [[multishell]] tab. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-cd">[[cd]]</div><tt>cd <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Changes to the specified directory</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-clear">[[clear]]</div><tt>clear</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Clears the terminal.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-copy">[[copy]]</div><tt>copy <source> <destination></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Copies a source file or folder to a destination</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-dj">[[delete]]</div><tt>delete <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Deletes the specified file (in the same manner as [[rm]]).</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-dj">[[dj]]</div><tt>dj</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Music box DJ - use <tt>dj</tt> for help.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-drive">[[drive]]</div><tt>drive</tt>, <tt>drive <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists the mount location of the current directory, or the path specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-edit">[[edit]]</div><tt>edit <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Edits the file specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-eject">[[eject]]</div><tt>eject <side></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Ejects the disk on the side specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-exit">[[exit]]</div><tt>exit</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Exits the currently running shell session - if it is the only shell session, the computer will power off.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-exit">[[fg]]</div><tt>fg <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens the specified script in a new [[multishell]] tab, then switches to it. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-gps">[[Gps (program)|gps]]</div><tt>gps <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Minecraft Global Positioning tool. Use <tt>gps</tt> for help.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-help">[[help]]</div><tt>help</tt>, <tt>help <topic></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Help utility. Opens the specified topic, or the introduction if no topic is specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-id">[[id]]</div><tt>id</tt>, <tt>id <side></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the ID of the computer, or if a side is specified, the ID of the disk in the specified side.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-label">[[label]]</div><tt>label</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Gets and sets the ID of the computer, or, the ID of a disk in a specified side. Use <tt>label</tt> for help.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-list">[[list]]</div><tt>list</tt>, <tt>list <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists the content of the current directory, or, the directory specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-lua">[[lua]]</div><tt>lua</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Interactive Lua interpreter at the shell.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-mkdir">[[mkdir]]</div><tt>mkdir <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Makes the directory at the path specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-monitor">[[Monitor (program)|monitor]]</div><tt>monitor <side> <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Redirects a specified program to a monitor on the specified side.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-move">[[move]]</div><tt>move <source> <destination></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Moves a file or folder at a specified source path to the specified destination path.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-move">[[multishell]]</div><tt>multishell</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens a new instance of multishell, running within the ''current'' multishell session. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-pastebin">[[pastebin]]</div><tt>pastebin <get/run/put> <pastebin code/file></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Allows the user to either retrieve a file from [http://pastebin.com/ pastebin.com], run it directly after downloading, or upload a file from the computer/turtle.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-programs">[[programs]]</div><tt>programs</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists all programs on the system.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-reboot">[[reboot]]</div><tt>reboot</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Reboots the Computer.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redprobe">[[redprobe]]</div><tt>redprobe</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">List redstone stats. <b>Note:</b> Removed in ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redpulse">[[redpulse]]</div><tt>redpulse</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Redstone output pulse tool. Use <tt>redpulse</tt> for help. <b>Note:</b> Removed in ComputerCraft 1.6</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redset">[[redset]]</div><tt>redset</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Redstone output set tool. Use <tt>redset</tt> for help. <b>Note:</b> Removed in ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redset">[[redstone (program)|redstone]]</div><tt>redstone <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Controls the redstone output state(s) of the system. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redset">[[repeat]]</div><tt>repeat</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Configures the system to act as a [[rednet (API)|rednet]] repeater. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-time">[[time]]</div><tt>time</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the Minecraft time of day.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-type">[[type]]</div><tt>type <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the type of the object or file at the specified path.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-rename">[[rename]]</div><tt>rename <old-name> <new-name></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Renames a file or directory.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-rename">[[rm]]</div><tt>rm <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Deletes the specified file (in the same manner as [[delete]]).</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-shell">[[shell]]</div><tt>shell, shell <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens another shell session. Runs a program if specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-shutdown">[[shutdown]]</div><tt>shutdown</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Powers off the Computer.</td></tr>
</table><br><br>

== Added TurtleOS programs ==

<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]]  
Additional TurtleOS Shell Programs
</td></tr>
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Program 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;"><div id="cmd-apis">[[craft]]</div><tt>craft</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The turtle will, if it is able, craft an item from the contents of its inventory.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[dance]]</div><tt>dance</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Initiates "get down" procedure.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[equip]]</div><tt>equip <side></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The turtle will attempt to place a tool on its specified side. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[excavate]]</div><tt>excavate <width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Digs a square-shaped quarry to bedrock, of width equal to that specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[go]]</div><tt>go <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Moves the turtle.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[refuel]]</div><tt>refuel <amount></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Attempts to replenish the turtle's [[fuel]] supply with items from its inventory.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[tunnel]]</div><tt>tunnel <width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Digs a horizontal tunnel leading off in the direction the turtle is facing.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[turn]]</div><tt>turn <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Causes the turtle to rotate.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[unequip]]</div><tt>unequip<width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Attempts to remove a tool from the turtle's specified side. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>
</table>

== See also ==
* [[Built In Turtle Programs]]

[[Category:Programs]][[Category:Lists]][[Category:Tutorials]]

Disk.getAudioTitle

2015-06-28T23:23:40Z

Cranium:

{{lowercase}}
{{Function
|name=disk.getAudioTitle
|args={{Type|string}} side
|api=disk
|returns={{Type|string}} the track title, or false if there is not a music record in the drive
|addon=ComputerCraft
|desc=Reads the title of the audio track from the music record in the drive. The [[disk.getLabel]] function also returns the track title of a music record.
|examples=
{{Example
|desc=Returns the title of an audio disk
|code=print(disk.getAudioTitle("bottom"))
|output=C418 - ward '''Output changes according to the audio title'''
}}
}}

[[Category:API_Functions]]

Computer.isOn

2015-06-18T05:04:05Z

Cranium: Created isOn function page

{{Lowercase}}
{{Function
|name=''computer''.isOn
|api=peripheral
|returns={{type|boolean}} power state
|addon=ComputerCraft
|desc=Returns the ON/OFF state of the [[Computer]] or [[Turtle]] wrapped to the <var>computer</var> variable.
|examples={{Example
|desc=Prints the power state of a computer or turtle on the right side of the calling machine.
|code=
local computer = [[peripheral.wrap]]("right")

[[print]]('''computer.isOn()''')
|output=The power state of any computer or turtle to the right of the calling machine.
}}
}}

[[Category:Lua_Core_Functions]]

Computer (API)

2015-06-18T05:01:49Z

Cranium:

{{PeripheralAPI}}
<br/>
The Computer API is a peripheral API that allows [[Computer|computers]] and [[Turtle|turtles]] to interact with other computers and turtles.
<br/>
''computer'' stands for the variable you [[peripheral.wrap|wrapped]] the computer to.

{{API table|Computer|image=Grid disk.png|2=

{{API table/row
|[[computer.turnOn|''computer''.turnOn]]()
|{{type|nil}}
|Turns on the [[Computer]] or [[Turtle]].
|odd}}

{{API table/row
|[[computer.shutdown|''computer''.shutdown]]()
|{{type|nil}}
|Shuts off the [[Computer]] or [[Turtle]].}}

{{API table/row
|[[computer.reboot|''computer''.reboot]]()
|{{type|nil}}
|Reboots the [[Computer]] or [[Turtle]].
|odd}}

{{API table/row
|[[computer.getID|''computer''.getID]]()
|{{type|number}} computerID
|Returns the ID of the [[Computer]] or [[Turtle]].}}

{{API table/row
|[[computer.isOn|''computer''.isOn]]()
|{{type|boolean}} power state
|Returns the ON/OFF state of the [[Computer]] or [[Turtle]].
|odd}}
}}
[[Category: Peripheral APIs]]

Computer (API)

2015-06-18T05:00:37Z

Cranium: Add isOn function

{{PeripheralAPI}}
<br/>
The Computer API is a peripheral API that allows [[Computer|computers]] and [[Turtle|turtles]] to interact with other computers and turtles.
<br/>
''computer'' stands for the variable you [[peripheral.wrap|wrapped]] the computer to.

{{API table|Computer|image=Grid disk.png|2=

{{API table/row
|[[computer.turnOn|''computer''.turnOn]]()
|{{type|nil}}
|Turns on the [[Computer]] or [[Turtle]].
|odd}}

{{API table/row
|[[computer.shutdown|''computer''.shutdown]]()
|{{type|nil}}
|Shuts off the [[Computer]] or [[Turtle]].}}

{{API table/row
|[[computer.reboot|''computer''.reboot]]()
|{{type|nil}}
|Reboots the [[Computer]] or [[Turtle]].
|odd}}

{{API table/row
|[[computer.getID|''computer''.getID]]()
|{{type|number}} computerID
|Returns the ID of the [[Computer]] or [[Turtle]].}}

{{API table/row
|[[computer.isOn|''computer''.isOn]]()
|{{type|boolean}} power status
|Returns the ON/OFF state of the [[Computer]] or [[Turtle]].
|odd}}
}}
[[Category: Peripheral APIs]]

CraftOS Shell

2014-08-13T20:50:49Z

Cranium: added pastebin

<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]]  
CraftOS Shell Programs
</td></tr>
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Program 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;"><div id="cmd-alias">[[alias]]</div><tt>alias <alias> <program></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Maps an alias string to a program.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[apis]]</div><tt>apis</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists all loaded APIs.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[bg]]</div><tt>bg <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens the specified script in a new [[multishell]] tab. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-cd">[[cd]]</div><tt>cd <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Changes to the specified directory</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-clear">[[clear]]</div><tt>clear</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Clears the terminal.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-copy">[[copy]]</div><tt>copy <source> <destination></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Copies a source file or folder to a destination</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-dj">[[delete]]</div><tt>delete <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Deletes the specified file (in the same manner as [[rm]]).</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-dj">[[dj]]</div><tt>dj</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Music box DJ - use <tt>dj</tt> for help.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-drive">[[drive]]</div><tt>drive</tt>, <tt>drive <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists the mount location of the current directory, or the path specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-edit">[[edit]]</div><tt>edit <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Edits the file specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-eject">[[eject]]</div><tt>eject <side></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Ejects the disk on the side specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-exit">[[exit]]</div><tt>exit</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Exits the currently running shell session - if it is the only shell session, the computer will power off.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-exit">[[fg]]</div><tt>fg <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens the specified script in a new [[multishell]] tab, then switches to it. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-gps">[[Gps (program)|gps]]</div><tt>gps <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Minecraft Global Positioning tool. Use <tt>gps</tt> for help.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-help">[[help]]</div><tt>help</tt>, <tt>help <topic></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Help utility. Opens the specified topic, or the introduction if no topic is specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-id">[[id]]</div><tt>id</tt>, <tt>id <side></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the ID of the computer, or if a side is specified, the ID of the disk in the specified side.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-label">[[label]]</div><tt>label</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Gets and sets the ID of the computer, or, the ID of a disk in a specified side. Use <tt>label</tt> for help.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-list">[[list]]</div><tt>list</tt>, <tt>list <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists the content of the current directory, or, the directory specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-lua">[[lua]]</div><tt>lua</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Interactive Lua interpreter at the shell.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-mkdir">[[mkdir]]</div><tt>mkdir <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Makes the directory at the path specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-monitor">[[monitor]]</div><tt>monitor <side> <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Redirects a specified program to a monitor on the specified side.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-move">[[move]]</div><tt>move <source> <destination></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Moves a file or folder at a specified source path to the specified destination path.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-move">[[multishell]]</div><tt>multishell</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens a new instance of multishell, running within the ''current'' multishell session. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-pastebin">[[pastebin]]</div><tt>pastebin <get/run/put> <pastebin code/file></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Allows the user to either retrieve a file from [http://pastebin.com/ pastebin.com], run it directly after downloading, or upload a file from the computer/turtle.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-programs">[[programs]]</div><tt>programs</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lists all programs on the system.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-reboot">[[reboot]]</div><tt>reboot</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Reboots the Computer.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redprobe">[[redprobe]]</div><tt>redprobe</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">List redstone stats. <b>Note:</b> Removed in ComputerCraft 1.6</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redpulse">[[redpulse]]</div><tt>redpulse</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Redstone output pulse tool. Use <tt>redpulse</tt> for help. <b>Note:</b> Removed in ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redset">[[redset]]</div><tt>redset</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Redstone output set tool. Use <tt>redset</tt> for help. <b>Note:</b> Removed in ComputerCraft 1.6</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redset">[[redstone (program)|redstone]]</div><tt>redstone <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Controls the redstone output state(s) of the system. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-redset">[[repeat]]</div><tt>repeat</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Configures the system to act as a [[rednet (API)|rednet]] repeater. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-time">[[time]]</div><tt>time</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the Minecraft time of day.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-type">[[type]]</div><tt>type <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the type of the object or file at the specified path.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-rename">[[rename]]</div><tt>rename <old-name> <new-name></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Renames a file or directory.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-rename">[[rm]]</div><tt>rm <path></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Deletes the specified file (in the same manner as [[delete]]).</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-shell">[[shell]]</div><tt>shell, shell <program> <arguments></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens another shell session. Runs a program if specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-shutdown">[[shutdown]]</div><tt>shutdown</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Powers off the Computer.</td></tr>
</table><br><br>

<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]]  
Additional TurtleOS Shell Programs
</td></tr>
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Program 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;"><div id="cmd-alias">[[dance]]</div><tt>dance</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Initiates "get down" procedure.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[craft]]</div><tt>craft</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The turtle will, if it is able, craft an item from the contents of its inventory.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[equip]]</div><tt>equip <side></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The turtle will attempt to place a tool on its specified side. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[excavate]]</div><tt>excavate <width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Digs a square-shaped quarry to bedrock, of width equal to that specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[go]]</div><tt>go <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Moves the turtle.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[refuel]]</div><tt>refuel <amount></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Attempts to replenish the turtle's [[fuel]] supply with items from its inventory.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[tunnel]]</div><tt>tunnel <width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Digs a horizontal tunnel leading off in the direction the turtle is facing.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-apis">[[turn]]</div><tt>turn <?></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Causes the turtle to rotate.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-alias">[[unequip]]</div><tt>unequip<width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Attempts to remove a tool from the turtle's specified side. <b>Note:</b> Added by ComputerCraft 1.6</td></tr>
</table>

[[Category:Programs]][[Category:Lists]][[Category:Tutorials]]

ComputerCraft.cfg

2014-04-17T06:57:15Z

Cranium: Removing NeedsWork tag, as the formatting was fixed. Cheers, MKLegoMan

This is an example of the default ComputerCraft configuration file, as it's seen in version 1.58.
<pre>
# Configuration file

####################
# block
####################

block {
# The Block ID for Cables
I:cableBlockID=1229

# The Block ID for Computers
I:computerBlockID=1225

# The Block ID for all Peripherals
I:peripheralBlockID=1226

# The Block ID for advanced turtles
I:turtleAdvancedBlockID=1230

# The Block ID for turtles
I:turtleBlockID=1227

# The Block ID for upgraded turtles
I:turtleUpgradedBlockID=1228
}

####################
# general
####################

general {
# The fuel limit for Advanced Turtles
I:advancedTurtleFuelLimit=100000

# The disk space limit for computers and turtles, in bytes
I:computerSpaceLimit=1000000

# Enable the "http" API on Computers
B:enableAPI_http=false

# Enable Command Block peripheral support
B:enableCommandBlock=false

# The disk space limit for floppy disks, in bytes
I:floppySpaceLimit=125000

# The range of Wireless Modems at maximum altitude in clear weather, in meters
I:modem_highAltitudeRange=384

# The range of Wireless Modems at maximum altitude in stormy weather, in meters
I:modem_highAltitudeRangeDuringStorm=96

# The range of Wireless Modems at low altitude in clear weather, in meters
I:modem_range=64

# The range of Wireless Modems at low altitude in stormy weather, in meters
I:modem_rangeDuringStorm=16
I:terminal_height=19
I:terminal_width=51

# The frequency that treasure disks will be found in dungeon chests, from 0 to 100. Increase this value if running a modpack with lots of mods that add dungeon loot, or you just want more treasure disks. Set to 0 to disable treasure disks.
I:treasureDiskLootFrequency=1

# The fuel limit for Turtles
I:turtleFuelLimit=20000

# Set whether Turtles require fuel to move
B:turtlesNeedFuel=true
}

####################
# item
####################

item {
# The Item ID for Coloured Floppy Disks
I:diskExpandedItemID=31707

# The Item ID for Floppy Disks
I:diskItemID=31708

# The Item ID for Pocket Computers
I:pocketComputerItemID=31709

# The Item ID for Printouts
I:printoutItemID=31706

# The Item ID for Treasure Disks
I:treasureDiskItemID=31705
}
</pre>

Shell.exit

2014-04-16T20:29:44Z

Cranium: correction of sleep link

{{lowercase}}
{{Function
|name=shell.exit
|returns=None
|api=shell
|addon=ComputerCraft
|desc=Exits the current program (or shell if no program is open).
|examples=
{{Example
|desc=Exits the program.
|code= [[print]]("Prepare for program termination...")
[[Os.sleep|sleep]](3)
'''shell.exit()'''
}}
}}

[[Category:API_Functions]]

Parallel (API)

2014-04-16T20:29:04Z

Cranium:

{{lowercase}}
Parallel is an API which allows you to multitask.

Functions are not actually executed simultaniously, but rather this API will automatically switch between them whenever they yield (eg whenever they call [[coroutine.yield]](), or functions that call that - eg [[os.pullEvent]]() - or functions that call that, etc - basically, anything that causes the function to "pause").

Each function executed in "parallel" gets its own copy of the event queue, and so "event consuming" functions (again, mostly anything that causes the script to pause - eg [[Os.sleep|sleep]](), [[rednet.receive]](), most of the [[Turtle (API)|turtle API]], etc) can safely be used in one without affecting the event queue accessed by the other.

{{API table|parallel|image=Grid disk.png|2=

{{API table/row
|[[parallel.waitForAny]]({{type|function}} function1, {{type|function}} function2, ...)
|{{type|number}} stoppedFunction
|Runs all the functions at the same time, and stops when any of them returns.
|odd}}

{{API table/row
|[[parallel.waitForAll]]({{type|function}} function1, {{type|function}} function2, ...)
|{{type|nil}}
|Runs all the functions at the same time, and stops when all of them have returned.
|}}

}}

[[Category:APIs]]

Parallel (API)

2014-04-16T20:28:49Z

Cranium: correction of sleep link

{{lowercase}}
Parallel is an API which allows you to multitask.

Functions are not actually executed simultaniously, but rather this API will automatically switch between them whenever they yield (eg whenever they call [[coroutine.yield]](), or functions that call that - eg [[os.pullEvent]]() - or functions that call that, etc - basically, anything that causes the function to "pause").

Each function executed in "parallel" gets its own copy of the event queue, and so "event consuming" functions (again, mostly anything that causes the script to pause - eg [[Os.sleep]](), [[rednet.receive]](), most of the [[Turtle (API)|turtle API]], etc) can safely be used in one without affecting the event queue accessed by the other.

{{API table|parallel|image=Grid disk.png|2=

{{API table/row
|[[parallel.waitForAny]]({{type|function}} function1, {{type|function}} function2, ...)
|{{type|number}} stoppedFunction
|Runs all the functions at the same time, and stops when any of them returns.
|odd}}

{{API table/row
|[[parallel.waitForAll]]({{type|function}} function1, {{type|function}} function2, ...)
|{{type|nil}}
|Runs all the functions at the same time, and stops when all of them have returned.
|}}

}}

[[Category:APIs]]

Label

2014-04-16T20:16:00Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps an image?}} Label is a built in program for computers and turtles that will create a label for the c..."

{{Stub|Needs more info about the program itself, perhaps an image?}}
Label is a [[CraftOS Shell|built in program for computers and turtles]] that will create a label for the computer, which will result in the label being assigned to the ID of the computer.

This prevents loss of programs in the event of destruction of the computer or turtle, with the added benefit of allowing turtles to retain fuel between being broken.

You can either '''set''' or '''clear''' the label on any computer or turtle.

{{Example
|desc=Set the label of the computer to "Foo"
|code=label set foo
}}
{{Example
|desc=Clears the label on the computer
|code=label clear
}}

Turtle.drop

2014-04-16T19:58:02Z

Cranium:

{{lowercase}}
{{Function
|name=turtle.drop
|args=[<nowiki></nowiki>{{type|number}} count]
|returns={{type|boolean}} true if an item was dropped; false otherwise.
|api=turtle
|addon=ComputerCraft
|desc=Drops all items in the selected slot, or if ''count'' is specified, drops that many items.
If the space in front of the turtle does not contain an inventory, the items are dropped into that space.
If the space in front of the turtle contains an inventory, the items are dropped into that inventory.
The items will be placed in the first available slot, starting at the top left, moving right and then down.

[[turtle.dropUp]] and [[turtle.dropDown]] are also available, and useful for loading furnaces; dropDown when above the furnace will load the top slot for smelting.

Before Minecraft 1.5/ComputerCraft 1.51, dropUp would load the bottom (fuel) slot for furnaces, since the hopper-related changes, fuel is loaded into the sides, and the output slot is available on the bottom (using [[Turtle.suck|turtle.suckUp]])

|examples=
{{Example
|desc=Drops all items in the first available slot.
|code=turtle.drop()
}}
}}

[[Category:Lua_Core_Functions]]

Turtle.drop

2014-04-16T19:57:31Z

Cranium:

{{lowercase}}
{{Function
|name=turtle.drop
|args=[<nowiki></nowiki>{{type|number}} count]
|returns={{type|boolean}} true if an item was dropped; false otherwise.
|api=turtle
|addon=ComputerCraft
|desc=Drops all items in the selected slot, or if ''count'' is specified, drops that many items.
If the space in front of the turtle does not contain a chest, the items are dropped into that space.
If the space in front of the turtle contains a chest, the items are dropped into that chest.
The items will be placed in the first available slot, starting at the top left, moving right and then down.

[[turtle.dropUp]] and [[turtle.dropDown]] are also available, and useful for loading furnaces; dropDown when above the furnace will load the top slot for smelting.

Before Minecraft 1.5/ComputerCraft 1.51, dropUp would load the bottom (fuel) slot for furnaces, since the hopper-related changes, fuel is loaded into the sides, and the output slot is available on the bottom (using [[Turtle.suck|turtle.suckUp]])

|examples=
{{Example
|desc=Drops all items in the first available slot.
|code=turtle.drop()
}}
}}

[[Category:Lua_Core_Functions]]

Turtle.dropUp

2014-04-16T19:57:01Z

Cranium:

{{lowercase}}
{{Function
|name=turtle.dropUp
|args=[<nowiki></nowiki>{{type|number}} count]
|returns={{type|boolean}} true if an item was dropped; false otherwise.
|api=turtle
|addon=ComputerCraft
|desc=Drops all items in the selected slot, or if ''count'' is specified, drops that many items.
If the space above the turtle does not contain an inventory, the items are dropped into that space.
If the space above the turtle contains an inventory, the items are dropped into that inventory.
The items will be placed in the first available slot, starting at the top left, moving right and then down.

[[turtle.drop]] and [[turtle.dropDown]] are also available, and useful for loading furnaces; dropDown when above the furnace will load the top slot for smelting.

Before Minecraft 1.5/ComputerCraft 1.51, dropUp would load the bottom (fuel) slot for furnaces, since the hopper-related changes, fuel is loaded into the sides, and the output slot is available on the bottom (using [[Turtle.suck|turtle.suckUp]])

|examples=
{{Example
|desc=Drops all items in the first available slot.
|code=turtle.dropUp()
}}
}}

[[Category:Lua_Core_Functions]]

Turtle.dropDown

2014-04-16T19:56:43Z

Cranium: Created

{{lowercase}}
{{Function
|name=turtle.dropDown
|args=[<nowiki></nowiki>{{type|number}} count]
|returns={{type|boolean}} true if an item was dropped; false otherwise.
|api=turtle
|addon=ComputerCraft
|desc=Drops all items in the selected slot, or if ''count'' is specified, drops that many items.
If the space below the turtle does not contain an inventory, the items are dropped into that space.
If the space below the turtle contains an inventory, the items are dropped into that inventory.
The items will be placed in the first available slot, starting at the top left, moving right and then down.

[[turtle.drop]] and [[turtle.dropUp]] are also available, and useful for loading furnaces; dropDown when above the furnace will load the top slot for smelting.

Before Minecraft 1.5/ComputerCraft 1.51, dropUp would load the bottom (fuel) slot for furnaces, since the hopper-related changes, fuel is loaded into the sides, and the output slot is available on the bottom (using [[Turtle.suck|turtle.suckUp]])

|examples=
{{Example
|desc=Drops all items in the first available slot.
|code=turtle.dropDown()
}}
}}

[[Category:Lua_Core_Functions]]

Turtle.dropUp

2014-04-16T19:55:38Z

Cranium: Created

{{lowercase}}
{{Function
|name=turtle.dropUp
|args=[<nowiki></nowiki>{{type|number}} count]
|returns={{type|boolean}} true if an item was dropped; false otherwise.
|api=turtle
|addon=ComputerCraft
|desc=Drops all items in the selected slot, or if ''count'' is specified, drops that many items.
If the space above the turtle does not contain an inventory, the items are dropped into that space.
If the space above the turtle contains a chest, the items are dropped into that inventory.
The items will be placed in the first available slot, starting at the top left, moving right and then down.

[[turtle.drop]] and [[turtle.dropDown]] are also available, and useful for loading furnaces; dropDown when above the furnace will load the top slot for smelting.

Before Minecraft 1.5/ComputerCraft 1.51, dropUp would load the bottom (fuel) slot for furnaces, since the hopper-related changes, fuel is loaded into the sides, and the output slot is available on the bottom (using [[Turtle.suck|turtle.suckUp]])

|examples=
{{Example
|desc=Drops all items in the first available slot.
|code=turtle.dropUp()
}}
}}

[[Category:Lua_Core_Functions]]

Unequip

2014-04-16T18:11:17Z

Cranium:

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Unequip is a [[Built In Turtle Programs|built in program for turtles]] that will remove the item currently equipped to the specified side into the currently selected slot.

You can only remove items from the left or right sides. If an item is not attached on either side, you must [[Equip_(program)|equip]] one first, before unequipping.

{{Example
|desc=Unequips an item from the right side
|code=unequip right
}}

Equip

2014-04-16T18:10:46Z

Cranium:

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Equip is a [[Built In Turtle Programs|built in program for turtles]] that will equip the item in the currently selected slot to the specified side.

You can only equip items either to the left or right sides, and you must [[Unequip_(program)|unequip]] items before equipping an item to the specified side if it is already occupied.

{{Example
|desc=Equips an item to the right side
|code=equip right
}}

Unequip

2014-04-16T18:10:08Z

Cranium:

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Unequip is a [[Built In Turtle Programs|built in program for turtles]] that will remove the item currently equipped to the specified side into the currently selected slot.

You can only remove items from the left or right sides. If an item is not attached on either side, you must equip one first, before unequipping.

{{Example
|desc=Unequips an item from the right side
|code=unequip right
}}

Unequip

2014-04-16T18:09:55Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps listing the code?}} Unequip is a built in program for turtles that will remove the item c..."

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Unequip is a [[Built In Turtle Programs|built in program for turtles]] that will remove the item currently equipped to teh specified side into the currently selected slot.

You can only remove items from the left or right sides. If an item is not attached on either side, you must equip one first, before unequipping.

{{Example
|desc=Unequips an item from the right side
|code=unequip right
}}

Equip

2014-04-16T18:05:46Z

Cranium:

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Equip is a [[Built In Turtle Programs|built in program for turtles]] that will equip the item in the currently selected slot to the specified side.

You can only equip items either to the left or right sides.

{{Example
|desc=Equips an item to the right side
|code=equip right
}}

Equip

2014-04-16T18:05:25Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps listing the code?}} Equip is a built in program for turtles that will equip the item int ..."

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Equip is a [[Built In Turtle Programs|built in program for turtles]] that will equip the item int he currently selected slot to the specified side.

You can only equip items either to the left or right sides.

{{Example
|desc=Equips an item to the right side
|code=equip right
}}

Rename

2014-04-16T17:59:36Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps an image?}} Rename is a built in program for computers and turtles that will rename the specified so..."

{{Stub|Needs more info about the program itself, perhaps an image?}}
Rename is a [[CraftOS Shell|built in program for computers and turtles]] that will rename the specified source file to the specified destination name. However, it will not rename directories.

Note: This operation works exactly the same way as the [[Move_(program)|move program]].

{{Example
|desc=Renames /foo to /bar
|code=rename /foo /bar
}}

Delete

2014-04-16T17:56:01Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps an image?}} Delete is a built in program for computers and turtles that will delete the specified so..."

{{Stub|Needs more info about the program itself, perhaps an image?}}
Delete is a [[CraftOS Shell|built in program for computers and turtles]] that will delete the specified source file or directory. However, it will not delete directories that contain files.

{{Example
|desc=Removes regular file /foo
|code=delete /foo
}}

Move

2014-04-16T17:26:08Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps an image?}} Move is a built in program for computers and turtles that will copy the specified source..."

{{Stub|Needs more info about the program itself, perhaps an image?}}
Move is a [[CraftOS Shell|built in program for computers and turtles]] that will copy the specified source into the specified destination, then delete the original source. If a different filename is specified as the destination, it will rename the file as well. It will not create non-existant directories however.

{{Example
|desc=moves /foo to /sample/bar, assuming the directory /sample exists already.
|code=move /foo /sample/bar
}}

Copy

2014-04-16T17:23:35Z

Cranium:

{{Stub|Needs more info about the program itself, perhaps an image?}}
Copy is a [[CraftOS Shell|built in program for computers and turtles]] that will copy the specified source into the specified destination. If a different filename is specified, it will rename the copy as well. It will not create non-existant directories however.

Note: This program can also be used with the linux-like command 'cp'

{{Example
|desc=Copies /foo to /bar
|code=copy /foo /bar
}}

Copy

2014-04-16T17:14:00Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps an image?}} Copy is a built in program for computers and turtles that will copy the specified file i..."

{{Stub|Needs more info about the program itself, perhaps an image?}}
Copy is a [[CraftOS Shell|built in program for computers and turtles]] that will copy the specified file into the specified location. If a different filename is specified, it will rename the copy as well.

Note: This program can also be used with the linux-like command 'cp'

{{Example
|desc=Copies /foo to /bar
|code=copy /foo /bar
}}

Excavate

2014-04-16T17:10:44Z

Cranium: Added more info

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Excavate is a [[Built In Turtle Programs|built in program for turtles]] that will mine out a specified width square of blocks, all the way down to bedrock level.

It will periodically return to the surface when it is full and drops off mined materials either into an available inventory placed behind it when it starts, or onto the ground. If fuel requirements are enabled, it will also periodically return to the starting point if it requires additional fuel.

{{Example
|desc=Mines a 16x16 wide hole down to bedrock
|code=excavate 16
}}

Excavate

2014-04-16T17:03:22Z

Cranium: Created page with "{{Stub|Needs more info about the program itself, perhaps listing the code?}} Excavate is a built in program for turtles that will mine out a speci..."

{{Stub|Needs more info about the program itself, perhaps listing the code?}}
Excavate is a [[Built In Turtle Programs|built in program for turtles]] that will mine out a specified width square of blocks, all the way down to bedrock level, periodically returning to the surface when full and dropping off supplies either into a supplied chest with empty slots, or onto the ground if none is available.
{{Example
|desc=Mines a 16x16 wide hole down to bedrock
|code=excavate 16
}}

ComputerCraft.cfg

2014-04-16T16:56:50Z

Cranium:

{{NeedsWork|this page needs to be formatted properly in the same format as the config file.}}
This is an example of the default ComputerCraft configuration file, as it's seen in version 1.58.
<nowiki><code>
# Configuration file

####################
# block
####################

block {
# The Block ID for Cables
I:cableBlockID=1229

# The Block ID for Computers
I:computerBlockID=1225

# The Block ID for all Peripherals
I:peripheralBlockID=1226

# The Block ID for advanced turtles
I:turtleAdvancedBlockID=1230

# The Block ID for turtles
I:turtleBlockID=1227

# The Block ID for upgraded turtles
I:turtleUpgradedBlockID=1228
}

####################
# general
####################

general {
# The fuel limit for Advanced Turtles
I:advancedTurtleFuelLimit=100000

# The disk space limit for computers and turtles, in bytes
I:computerSpaceLimit=1000000

# Enable the "http" API on Computers
B:enableAPI_http=false

# Enable Command Block peripheral support
B:enableCommandBlock=false

# The disk space limit for floppy disks, in bytes
I:floppySpaceLimit=125000

# The range of Wireless Modems at maximum altitude in clear weather, in meters
I:modem_highAltitudeRange=384

# The range of Wireless Modems at maximum altitude in stormy weather, in meters
I:modem_highAltitudeRangeDuringStorm=96

# The range of Wireless Modems at low altitude in clear weather, in meters
I:modem_range=64

# The range of Wireless Modems at low altitude in stormy weather, in meters
I:modem_rangeDuringStorm=16
I:terminal_height=19
I:terminal_width=51

# The frequency that treasure disks will be found in dungeon chests, from 0 to 100. Increase this value if running a modpack with lots of mods that add dungeon loot, or you just want more treasure disks. Set to 0 to disable treasure disks.
I:treasureDiskLootFrequency=1

# The fuel limit for Turtles
I:turtleFuelLimit=20000

# Set whether Turtles require fuel to move
B:turtlesNeedFuel=true
}

####################
# item
####################

item {
# The Item ID for Coloured Floppy Disks
I:diskExpandedItemID=31707

# The Item ID for Floppy Disks
I:diskItemID=31708

# The Item ID for Pocket Computers
I:pocketComputerItemID=31709

# The Item ID for Printouts
I:printoutItemID=31706

# The Item ID for Treasure Disks
I:treasureDiskItemID=31705
}
</code>
</nowiki>

ComputerCraft.cfg

2014-04-16T16:15:30Z

Cranium: ARGH, WHY DOES THE <nowiki> tag not work with <code>?

This is an example of the default ComputerCraft configuration file, as it's seen in version 1.58.
<nowiki><code>
# Configuration file

####################
# block
####################

block {
# The Block ID for Cables
I:cableBlockID=1229

# The Block ID for Computers
I:computerBlockID=1225

# The Block ID for all Peripherals
I:peripheralBlockID=1226

# The Block ID for advanced turtles
I:turtleAdvancedBlockID=1230

# The Block ID for turtles
I:turtleBlockID=1227

# The Block ID for upgraded turtles
I:turtleUpgradedBlockID=1228
}

####################
# general
####################

general {
# The fuel limit for Advanced Turtles
I:advancedTurtleFuelLimit=100000

# The disk space limit for computers and turtles, in bytes
I:computerSpaceLimit=1000000

# Enable the "http" API on Computers
B:enableAPI_http=false

# Enable Command Block peripheral support
B:enableCommandBlock=false

# The disk space limit for floppy disks, in bytes
I:floppySpaceLimit=125000

# The range of Wireless Modems at maximum altitude in clear weather, in meters
I:modem_highAltitudeRange=384

# The range of Wireless Modems at maximum altitude in stormy weather, in meters
I:modem_highAltitudeRangeDuringStorm=96

# The range of Wireless Modems at low altitude in clear weather, in meters
I:modem_range=64

# The range of Wireless Modems at low altitude in stormy weather, in meters
I:modem_rangeDuringStorm=16
I:terminal_height=19
I:terminal_width=51

# The frequency that treasure disks will be found in dungeon chests, from 0 to 100. Increase this value if running a modpack with lots of mods that add dungeon loot, or you just want more treasure disks. Set to 0 to disable treasure disks.
I:treasureDiskLootFrequency=1

# The fuel limit for Turtles
I:turtleFuelLimit=20000

# Set whether Turtles require fuel to move
B:turtlesNeedFuel=true
}

####################
# item
####################

item {
# The Item ID for Coloured Floppy Disks
I:diskExpandedItemID=31707

# The Item ID for Floppy Disks
I:diskItemID=31708

# The Item ID for Pocket Computers
I:pocketComputerItemID=31709

# The Item ID for Printouts
I:printoutItemID=31706

# The Item ID for Treasure Disks
I:treasureDiskItemID=31705
}
</code>
</nowiki>

ComputerCraft.cfg

2014-04-16T16:14:42Z

Cranium:

<nowiki>This is an example of the default ComputerCraft configuration file, as it's seen in version 1.58.
<code>
# Configuration file

####################
# block
####################

block {
# The Block ID for Cables
I:cableBlockID=1229

# The Block ID for Computers
I:computerBlockID=1225

# The Block ID for all Peripherals
I:peripheralBlockID=1226

# The Block ID for advanced turtles
I:turtleAdvancedBlockID=1230

# The Block ID for turtles
I:turtleBlockID=1227

# The Block ID for upgraded turtles
I:turtleUpgradedBlockID=1228
}

####################
# general
####################

general {
# The fuel limit for Advanced Turtles
I:advancedTurtleFuelLimit=100000

# The disk space limit for computers and turtles, in bytes
I:computerSpaceLimit=1000000

# Enable the "http" API on Computers
B:enableAPI_http=false

# Enable Command Block peripheral support
B:enableCommandBlock=false

# The disk space limit for floppy disks, in bytes
I:floppySpaceLimit=125000

# The range of Wireless Modems at maximum altitude in clear weather, in meters
I:modem_highAltitudeRange=384

# The range of Wireless Modems at maximum altitude in stormy weather, in meters
I:modem_highAltitudeRangeDuringStorm=96

# The range of Wireless Modems at low altitude in clear weather, in meters
I:modem_range=64

# The range of Wireless Modems at low altitude in stormy weather, in meters
I:modem_rangeDuringStorm=16
I:terminal_height=19
I:terminal_width=51

# The frequency that treasure disks will be found in dungeon chests, from 0 to 100. Increase this value if running a modpack with lots of mods that add dungeon loot, or you just want more treasure disks. Set to 0 to disable treasure disks.
I:treasureDiskLootFrequency=1

# The fuel limit for Turtles
I:turtleFuelLimit=20000

# Set whether Turtles require fuel to move
B:turtlesNeedFuel=true
}

####################
# item
####################

item {
# The Item ID for Coloured Floppy Disks
I:diskExpandedItemID=31707

# The Item ID for Floppy Disks
I:diskItemID=31708

# The Item ID for Pocket Computers
I:pocketComputerItemID=31709

# The Item ID for Printouts
I:printoutItemID=31706

# The Item ID for Treasure Disks
I:treasureDiskItemID=31705
}
</code>
</nowiki>

ComputerCraft.cfg

2014-04-16T16:07:16Z

Cranium: Created example config

This is an example of the default ComputerCraft configuration file, as it's seen in version 1.58.
<code>
# Configuration file

####################
# block
####################

block {
# The Block ID for Cables
I:cableBlockID=1229

# The Block ID for Computers
I:computerBlockID=1225

# The Block ID for all Peripherals
I:peripheralBlockID=1226

# The Block ID for advanced turtles
I:turtleAdvancedBlockID=1230

# The Block ID for turtles
I:turtleBlockID=1227

# The Block ID for upgraded turtles
I:turtleUpgradedBlockID=1228
}

####################
# general
####################

general {
# The fuel limit for Advanced Turtles
I:advancedTurtleFuelLimit=100000

# The disk space limit for computers and turtles, in bytes
I:computerSpaceLimit=1000000

# Enable the "http" API on Computers
B:enableAPI_http=false

# Enable Command Block peripheral support
B:enableCommandBlock=false

# The disk space limit for floppy disks, in bytes
I:floppySpaceLimit=125000

# The range of Wireless Modems at maximum altitude in clear weather, in meters
I:modem_highAltitudeRange=384

# The range of Wireless Modems at maximum altitude in stormy weather, in meters
I:modem_highAltitudeRangeDuringStorm=96

# The range of Wireless Modems at low altitude in clear weather, in meters
I:modem_range=64

# The range of Wireless Modems at low altitude in stormy weather, in meters
I:modem_rangeDuringStorm=16
I:terminal_height=19
I:terminal_width=51

# The frequency that treasure disks will be found in dungeon chests, from 0 to 100. Increase this value if running a modpack with lots of mods that add dungeon loot, or you just want more treasure disks. Set to 0 to disable treasure disks.
I:treasureDiskLootFrequency=1

# The fuel limit for Turtles
I:turtleFuelLimit=20000

# Set whether Turtles require fuel to move
B:turtlesNeedFuel=true
}

####################
# item
####################

item {
# The Item ID for Coloured Floppy Disks
I:diskExpandedItemID=31707

# The Item ID for Floppy Disks
I:diskItemID=31708

# The Item ID for Pocket Computers
I:pocketComputerItemID=31709

# The Item ID for Printouts
I:printoutItemID=31706

# The Item ID for Treasure Disks
I:treasureDiskItemID=31705
}
</code>

Floppy Disk

2014-04-16T15:58:43Z

Cranium: /* Release Changes */

The system of disks and floppies in [[ComputerCraft]] were added in version 1.2. How they work and interact with the [[Computer|computers]] is very similar to how they would work in the real world with our real computers: There's a [[Disk Drive]] that we're able to insert removable disks (or floppies) which we're able to place data upon, which, in turn, makes data portable. This brings much potential for things such as servers running ComputerCraft and users of that server wishing to distribute their software for in-game currency.

The 1.42 update allows floppies to be colored with any kind of dye. This is done by putting a floppy and a dye in your crafting table.
[[File:Floppy.png|frame|right|Dyed Floppy Disks]]
== Recipe ==
{{Crafting grid
|B1=Redstone
|B2=paper
|Output=disk
}}
== Usage ==
Like individual computers, each floppy disk has its own folder containing the data that is within that floppy and is easily movable from within the computers in Minecraft using the simple UNIX-like commands such as cp (copy) or mv (move). Just like anywhere else in a computer, you can create, edit, move, copy, etc., any files and do so however you wish.

To insert a floppy into a [[Disk Drive]] so it can be used, right-click the disk drive and place the floppy into the slot at the top of the drive's inventory menu.

== Interacting with Computers ==
When a disk is inserted into a disk drive that is adjacent to a computer, a directory is visible in the computer's root directory titled 'disk'. If another disk is inserted into a different drive that is also connected to a computer then that next directory is entitled 'disk2' and so-on for each additional disk that is inserted and connected.

== Release Changes ==
*'''1.56''': Added [[Treasure Disks]].
*'''1.3''': Used for [[Turtle]]s' programming.
*'''1.2''': Initial Release

{{BlocksItemsList}}
[[Category:Items]]

Floppy Disk

2014-04-16T15:56:57Z

Cranium: /* Release Changes */ Mention of Treasure Disks

The system of disks and floppies in [[ComputerCraft]] were added in version 1.2. How they work and interact with the [[Computer|computers]] is very similar to how they would work in the real world with our real computers: There's a [[Disk Drive]] that we're able to insert removable disks (or floppies) which we're able to place data upon, which, in turn, makes data portable. This brings much potential for things such as servers running ComputerCraft and users of that server wishing to distribute their software for in-game currency.

The 1.42 update allows floppies to be colored with any kind of dye. This is done by putting a floppy and a dye in your crafting table.
[[File:Floppy.png|frame|right|Dyed Floppy Disks]]
== Recipe ==
{{Crafting grid
|B1=Redstone
|B2=paper
|Output=disk
}}
== Usage ==
Like individual computers, each floppy disk has its own folder containing the data that is within that floppy and is easily movable from within the computers in Minecraft using the simple UNIX-like commands such as cp (copy) or mv (move). Just like anywhere else in a computer, you can create, edit, move, copy, etc., any files and do so however you wish.

To insert a floppy into a [[Disk Drive]] so it can be used, right-click the disk drive and place the floppy into the slot at the top of the drive's inventory menu.

== Interacting with Computers ==
When a disk is inserted into a disk drive that is adjacent to a computer, a directory is visible in the computer's root directory titled 'disk'. If another disk is inserted into a different drive that is also connected to a computer then that next directory is entitled 'disk2' and so-on for each additional disk that is inserted and connected.

== Release Changes ==
*'''1.56''': Added Treasure Disks.
*'''1.3''': Used for [[Turtle]]s' programming.
*'''1.2''': Initial Release

{{BlocksItemsList}}
[[Category:Items]]

Built In Turtle Programs

2014-04-16T04:26:22Z

Cranium: minor formatting

[[CraftOS_Shell|Turtles have the same programs installed by default as any other computer]], but with the addition of turtle-specific programs.
<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_turtle.png|24px]]  
TurtleOS Shell Programs
</td></tr>
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Program 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;"><div id="cmd-craft">craft</div><tt>craft <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will craft the number of items specified (if not enough material is provided, will craft as many as possible).</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-dance">dance</div><tt>dance</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Commands the turtle to get funky.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-excavate">excavate</div><tt>excavate <width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will excavate a square hole <width> blocks wide until it hits bedrock.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-tunnel">tunnel</div><tt>tunnel <distance></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will dig a tunnel 2 high by 3 wide for the <distance> specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-refuel">refuel</div><tt>refuel</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will refuel the turtle using the item in the currently selected slot.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-turn">turn</div><tt>turn <direction> <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will make the turtle turn in the <direction> specified, for the designated <number> of times.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-go">go</div><tt>go <direction> <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will command the turtle to move in the list of specified directions in the <direction <number> format. <b>Example:</b> <i>go forward 3 left 2</i> will move forward three, and turn left twice.</td></tr>
[[Category:Programs]][[Category:Lists]][[Category:Tutorials]]

CraftOS Shell

2014-04-16T04:17:29Z

Cranium: minor formatting

CraftOS Shell

2014-04-16T04:16:43Z

Cranium: Added notes regarding redprobe, redset, redpulse removed in 1.6

Built In Turtle Programs

2014-04-16T04:12:47Z

Cranium:

[[CraftOS_Shell|Turtles have the same programs installed by default as any other computer]], but with the addition of turtle-specific programs.
<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_turtle.png|24px]]  
TurtleOS Shell Programs
</td></tr>
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Program 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;"><div id="cmd-craft">craft</div><tt>craft <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will craft the number of items specified (if not enough material is provided, will craft as many as possible).</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-dance">dance</div><tt>dance</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Commands the turtle to get funky.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-excavate">excavate</div><tt>excavate <width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will excavate a square hole <width> blocks wide until it hits bedrock.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-tunnel">tunnel</div><tt>tunnel <distance></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will dig a tunnel 2 high by 3 wide for the <distance> specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-refuel">refuel</div><tt>refuel</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will refuel the turtle using the item in the currently selected slot.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-turn">turn</div><tt>turn <direction> <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will make the turtle turn in the <direction> specified, for the designated <number> of times.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-go">go</div><tt>go <direction> <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will command the turtle to move in the list of specified directions in the <direction <number> format. Example: go forward 3 left 2 will move forward three, and turn left twice.</td></tr>
[[Category:Programs]][[Category:Lists]][[Category:Tutorials]]

Built In Turtle Programs

2014-04-16T04:12:21Z

Cranium: Adding default programs for turtles, similar to CraftOS Shell page.

{{NeedsWork|Updating this page to give more detailed information similar to [[CraftOS Shell]] would be useful. - [[User:Oeed|Oeed]] 07:50, 26 March 2014 (GMT)}}
[[CraftOS_Shell|Turtles have the same programs installed by default as any other computer]], but with the addition of turtle-specific programs.
<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_turtle.png|24px]]  
TurtleOS Shell Programs
</td></tr>
<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Program 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;"><div id="cmd-craft">craft</div><tt>craft <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will craft the number of items specified (if not enough material is provided, will craft as many as possible).</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-dance">dance</div><tt>dance</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Commands the turtle to get funky.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-excavate">excavate</div><tt>excavate <width></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will excavate a square hole <width> blocks wide until it hits bedrock.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-tunnel">tunnel</div><tt>tunnel <distance></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will dig a tunnel 2 high by 3 wide for the <distance> specified.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-refuel">refuel</div><tt>refuel</tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will refuel the turtle using the item in the currently selected slot.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-turn">turn</div><tt>turn <direction> <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will make the turtle turn in the <direction> specified, for the designated <number> of times.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;"><div id="cmd-go">go</div><tt>go <direction> <number></tt></td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Will command the turtle to move in the list of specified directions in the <direction <number> format. Example: go forward 3 left 2 will move forward three, and turn left twice.</td></tr>
[[Category:Programs]][[Category:Lists]][[Category:Tutorials]]

Getting Started

2014-04-16T03:44:41Z

Cranium: /* Prerequisite: Installing the mods */ Updating installation instructions

== Prerequisite: Installing the mods ==
'''It is very important to read everything carefully before asking questions.'''
'''Also, the latest version of this mod may not be compatible with the current Minecraft release.'''

# Install [http://files.minecraftforge.net/ Minecraft Forge Recommended Build]
# Download the latest version of [http://computercraft.info ComputerCraft]
# Copy the .zip file into *minecraft folder*\mods\ or into your specified profile. (Tip: If on Windows, on the main screen of Minecraft, go to 'Texture Packs' and click on 'Open texture pack folder'. Go up one folder, there's your Minecraft folder. If on Mac, open Finder, hit Command+Shift+G and type ~/Library/ then hit enter, open 'Application Support' then open 'minecraft')


== Crafting ==
<br />
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=Redstone |C2=stone
|A3=stone |B3=glass pane |C3=stone
|Output=Computer
}}
<br />

Right click on the computer to use it.<br />
Some important key combinations to remember:
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Key Combination
!style="background:#EEE" width="*"|Usage
|-
|{{Keypress|key=CTRL}} + {{Keypress|key=T}}
|Closes the current program.
|-
|{{Keypress|key=CTRL}} + {{Keypress|key=R}}
|Reboots the computer.
|-
|{{Keypress|key=CTRL}} + {{Keypress|key=S}}
|Forcefully shuts down the computer.
|}
You usually will have to hold down the key combinations for at least 1 second<br />

== Attaching hardware ==
You can a bunch of stuff to your computer. There are 6 sides to the sides of your computer, and the computer can interact with almost anything there that it can interact with. This includes [[Modem|modems]] [[Modem_(API)|(API)]], [[Disk_Drive|disk drives]] [[Fs_(API)|(API)]], [[Printer|Printers]] [[Printer_(API)|(API)]], [[Monitor|monitors]] [[Term_(API)|(API)]], and even redstone [[Rs_(API)|(API)]]! Connect these to the sides of your computer and use the appropriate API to control your hardware.

== Using the computer 's shell ==
Your computer should come with CraftOS as long as you didn't mod the mod.
If you have ever used the Linux terminal or Command Prompt or DOS or something similar, shell usage should be pretty simple.

However the CraftOS Shell is even simpler and it only has one thing you can do: Type the name of a program (along with arguments) and it will run.

A few useful programs that will help you magically appear on every computer you use, because they are in the universal ''rom'' folder that every computer can access.
{| border="2" cellpadding="2" cellspacing="0"
|cd
|'''C'''hanges the current working '''d'''irectory of the shell, so you can do something else.
|-
|ls
|'''L'''i'''s'''ts the contents of the working directory, with directories in green and files in white.
|-
|rm
|'''R'''e'''m'''oves (deletes) a file or folder
|-
|mkdir
|'''M'''a'''k'''es an empty '''dir'''ectory
|}

== Programming your computer ==
For programming tutorials, ''go to'': [[Tutorials]]

Programming ComputerCraft computers is done with a programming language called Lua. Lua is intended to be pretty simple to use, but if you don't know how, you can check out the programming tutorials on this wiki.

----
Do you recall that one time ages ago when you looked up "how to play Minecraft", and you got a basic guide: punch trees, make bench, make tools, build house, make torches. But do you remember the end?

''The rest is up to you...''

ComputerCraft works the same way. The goals and uses for ComputerCraft are limitless, and now you've gotten started. There is no definite thing to do next, the rest is up to you.

[[Category:Tutorials]]

Gps (API)

2014-03-10T17:37:01Z

Cranium: tostring() doesn't work that way

The GPS API provides a method for turtles and computers to retrieve their own locations.

It broadcasts a PING message over [[Rednet_(API)|rednet]] and wait for responses. In order for this system to work, there must be at least 4 computers used as gps ''hosts'' which will respond and allow [[Wikipedia:Trilateration|trilateration]]. Three of these hosts should be in a plane, and the fourth should be either above or below the other three. You can set up hosts using the [[Gps (program)|gps program]].

Note: When entering in the coordinates for the ''host'' you need to put in the x,y,z of the computer, not the modem, as all rednet distances are measured from the block the computer is in.

Also note that you may ''choose'' which axises x, y or z refers to - so long as your systems have the same definition as any GPS servers that're in range, it works just the same. For example, you might build a GPS cluster according to [http://www.computercraft.info/forums2/index.php?/topic/3088-how-to-guide-gps-global-position-system/ this tutorial], using z to account for height, or you might use y to account for height in the way that MineCraft's debug screen displays.



<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="3" 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]]  
Gps (API)
</td></tr>

<tr><td style="width: 100px; background: #E0E0E0; padding: .4em; font-weight:bold;">Return</td><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;">({{Type|number}} x, {{Type|number}} y, {{Type|number}} z), or [[nil]]</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gps.locate(<nowiki>[</nowiki>{{Type|number}} timeout [, {{Type|boolean}} debug]])</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tries to retrieve the computer or turtles own location. On success, returns the location of the turtle’s modem. On failure (if no responses are received for <var>timeout</var> seconds, by default 2), returns [[nil]]. If <var>debug</var> is <code>true</code>, debug messages are printed.</td></tr></table>

== Example ==
print("Man I am so lost right now!")
local x, y, z = gps.locate(5)
if x == nil then
print("Nope, still lost :(")
else
print("I am at ",x," ",y," ",z)
end

== Vector Example ==
GPS position and navigation can be handled more easily using a [[vector (API)|vector]].

local home = vector.new(45, 85, 20)
local position = vector.new(gps.locate(5))
local displacement = position - home

print("I am ", tostring(displacement), " away from home!!!")

[[Category:APIs]]

Mouse click (event)

2014-03-01T16:00:40Z

Cranium: Clarified the output of return1

{{Event
|name=mouse_click
|desc=Fired when the terminal is clicked.
|return1=The mouse button that was clicked. Left Mouse Button is returned as the number 1, and Right Mouse Button is returned as the number 2
|return2=The X-coordinate of the click (in screen-characters).
|return3=The Y-coordinate of the click (in screen-characters).
|examples=
{{Example
|desc=Print the button and the co-ordinates of every mouse click we receive a ''mouse_click'' event.
|code=
while true do
local event, button, xPos, yPos = [[os.pullEvent]]("[[mouse_click_(event)|mouse_click]]")
[[print]]("Mouse button clicked: ", button, " => Click Position X: ", xPos, " => Click Position Y: ", yPos)
end
|output=The button that was pressed, followed by the X and Y position of the event.
}}
}}

Os.clock

2013-11-05T10:32:31Z

Cranium:

{{lowercase}}
{{Function
|name=os.clock
|returns={{type|number}}, amount of time the computercraft computer has been running, in seconds.
|api=OS
|addon=ComputerCraft
|desc=Returns the amount of time the Computer has been running, note that this may not be the amount of time the program has been running. the function os.clock() is useful for debugging, see the example.
|examples=
{{Example
|desc=Measure how long a custom function takes to execute
|code=x = os.clock() -- compensates for time already passed<br />myFunction() -- function to be tested<br />y = os.clock()-x -- calculates time change<br />print(y)
|output=Time it took to run myFunction()
}}
}}

[[Category:Lua_Core_Functions]]

Wiki Todo

2013-10-29T16:04:03Z

Cranium: /* General Wiki Stuff */

<div style="padding-left: 8px; float: right">{{List of Administrators}}</div>
<span style='font-size: 132%; font-weight:bold;'>This page lists where work is needed to be done on the wiki. If you would like to help, we ask that you please make an account and help wherever you can.</span>

''If you need to contact an Administrator, please visit an admin's userpage, and leave a note on their talk page.''

'''If you make a change here, please give us as much detail as you can, and sign the end of your change using four tildes, like so: <nowiki>~~~~</nowiki>. This allows us to get back to you if we need more information.'''

__TOC__

== Missing & NeedsWork Pages ==
* The [[:Category:Pages_Needing_Changes|Pages Needing Changes]] list shows all the pages that have been tagged with <nowiki>{{NeedsWork}}</nowiki> or <nowiki>{{Stub}}</nowiki>. These pages either need more information, to be tidied, re-worded or adjusted, or just needs some TLC.
* The [[Special:WantedPages| Wanted Pages]] list shows all the pages that are missing (have been linked to, but aren't there). You should first check that the page being requested doesn't already exist (in case the person misspelled the page) and then, if you're feeling adventurous, put together a page. You can always come back, or tag the page with a <nowiki>{{NeedsWork}}</nowiki> or a <nowiki>{{Stub}}</nowiki> tag. If you need help, ask us! We don't bite.

== Additional Tasks ==
*[[Textutils_(API)|Textutils]] (Needs <s>5</s> 3 function pages, <s>2</s> 1 function description)
*[[Vector_(API)|Vector]] <s>(Needs link to page explaining or description explaining what a vector is and function pages)</s>
** <s>It now has a link to Wikipedia, but it doesn't use any of the method or example templates. Can we get this rectified? ''[[User:AfterLifeLochie|AfterLifeLochie]] 02:14, 29 November 2012 (MSK)''</s>
** Now has pages to every function in a standard template. May need to double check work for any broken links or missing pages. Examples and descriptions probably need work. ''[[User:MafiaMoe|MafiaMoe]] 18:38, 23 February 2013 (MSK)''
* Some links don't link to their correct pages, resulting in page duplication and wasting time deleting pages. Can sometimes be found in the [[Special:WantedPages| Wanted Pages.]]
*<s>[[Coroutine_(API)|Coroutine]] (Bottom section on interaction with other APIs is completely misleading; needs either re-write or removal) [[User:Lyqyd|Lyqyd]] 01:44, 27 May 2013 (MSK)</s>
** Fixed by Hawk777 at 17:41, 28 May 2013 (MSK). ''[[User:AfterLifeLochie|AfterLifeLochie]] 10:27, 3 June 2013 (MSK)''

== Wiki Admin Things ==
=== General Wiki Stuff ===
* <s>Random Links, such as mining_turtle via image links, any chance of removing them? </s>
** Uh, no. They're generated through templates doing weird things, and fixing them is a real pain (template re factorization, renaming files, etc). I have fixed some but not all. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:46, 29 December 2012 (MSK)''
* Any chance to get some of the links to the vanilla Minecraft items to link to their page on the Minecraft Wiki? That's where a majority of the missing pages point towards. I think it's part of the above mentioned issue with the links via recipe or thumbnail images. Of course, we could always create a page for all of them, and redirect to the Minecraft Wiki, but that seems stupid to have to do.
[[Category:Lists]]

Turtle inventory (event)

2013-10-29T15:46:51Z

Cranium:

{{lowercase}}
{{Event
|name=turtle_inventory
|desc=Fired when the inventory of the turtle is altered in any slot.
|examples=
{{Example
|desc=Returns the slot number when the inventory in slot 1 is changed.
|code=
while true do
local event, p1 = [[os.pullEvent]]("[[turtle_inventory_(event)|turtle_inventory]]")
[[print]]("Inventory has changed")
end
|output=If the inventory in any slot has changed, or the player has clicked inside the turtle, the output is: "Inventory has changed".
}}
'''Note: '''This event can fire even if the inventory has not changed, such as if the player has clicked on an empty slot.
}}