ComputerCraft Wiki - User contributions [en]

Window

2014-10-24T00:34:00Z

Mitterdoo: Redirected page to Window (API)

#REDIRECT [[Window (API)]]

Vector

2014-10-24T00:28:25Z

Mitterdoo: Redirected page to Vector (API)

#REDIRECT [[Vector (API)]]

Turtle

2014-10-24T00:27:49Z

Mitterdoo:

{{Selfref|This is for the turtle block/item. For the API, visit [[Turtle (API)]].}}
[[File:Turtles.png|thumb]]
'''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=Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=Advanced_Turtle |Output-link=turtle
}}
|}
Turtles can be equipped with different peripherals and tools. A turtle can only 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.
 The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
 The following peripherals can be equipped to a turtles: [[Wireless Modem|wireless modem]] and [[Workbench|crafting tables]].
 Diamond tools must be unused (i.e. not have a durability bar showing) an unenchanted to combine with a turtle.
 '''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]]

Textutils

2014-10-24T00:26:07Z

Mitterdoo: Redirected page to Textutils (API)

#REDIRECT [[Textutils (API)]]

Term

2014-10-24T00:25:42Z

Mitterdoo: Redirected page to Term (API)

#REDIRECT [[Term (API)]]

Table

2014-10-24T00:24:38Z

Mitterdoo:

Table may refer to:
* [[Table (API)]] An in-built Lua API designed to manipulate tables.
* [[Table (type)]] a type that implements associative arrays that can be indexed with any value besides [[Nil|nil]].

[[Category:Disambiguation_Pages]]

CraftOS

2014-10-24T00:21:21Z

Mitterdoo:

{{Selfref|This is the article for CraftOS. If you were redirected from Shell and are looking for the API, see [[Shell (API)]]}}
{{Stub|Needs more info - especially links to other articles.}}
[[File:2012-01-30_23.02.52.png|frame|right|CraftOS's interface.]]CraftOS is the default ComputerCraft OS. It has a DOS style interface, where you use ls to view programs, cd to move through directories, and type the name of a program to run it.

Its features include...
*DOS style interface
*Default; guaranteed to work unlike the others which may break with ComputerCraft updates
*Do-It-Yourself, allowing you to customize what you want on your OS

[[Category:OSes]]

Rs

2014-10-24T00:20:39Z

Mitterdoo: Redirected page to Redstone (API)

#REDIRECT [[Redstone (API)]]

Rednet (API)

2014-10-24T00:19:53Z

Mitterdoo:

''For a tutorial on how to use the API, visit [[Rednet Tutorial]].''

The Rednet API allows systems to communicate between each other without using redstone. It serves as a wrapper for the [[modem (API)|modem API]], offering ease of functionality (particularly in regards to [[Repeat|repeating signals]]) with some expense of fine control.

In order to send and receive data, a [[modem]] (either [[Wired Modem|wired]] or [[Wireless Modem|wireless]]) is required. The data reaches any possible destinations immediately after sending it, but is [[#Range|range limited]].

==API==
{{API table|rednet|image=Grid_disk.png|2=

{{API table/row
|[[rednet.open]]({{type|string}} side)
|{{type|nil}}
|Tells the computer that the side can be used for networking.}}

{{API table/row
|[[rednet.close]]({{type|string}} side)
|{{type|nil}}
|Tells the computer that the side can no longer be used for networking.
|odd}}

{{API table/row
|[[rednet.send]]({{type|number}} receiverID, {{type|string}} message, [<nowiki/>{{type|string}} protocol])
|{{type|nil}}
|Sends a message "intended" for another system with a specific ID, using the currently opened sides. The <var>receiverID</var> is the ID {{type|number}} (note - '''not''' a {{type|string}}) of the computer you're sending the message to. Later versions or ComputerCraft allow some other data types as the message.}}

{{API table/row
|[[rednet.broadcast]]({{type|string}} message, [<nowiki/>{{type|string}} protocol])
|{{type|nil}}
|Sends the message to ''all'' connected and open computers.
|odd}}

{{API table/row
|[[rednet.receive]]([<nowiki/> [<nowiki/>{{type|string}} protocolFilter, ] {{type|number}} timeout])
|{{type|number}} senderID, {{type|string}} message, {{type|number}} distance / {{type|string}} protocol
|Waits until a rednet message of the specified protocol has been received, or until <var>timeout</var> seconds have passed. Leave all arguments empty to wait for any message indefinitely. If only a single, numerical argument is passed, will wait that many seconds for a message of any protocol. Versions of ComputerCraft prior to 1.6 may return the distance to the transmitting computer - 1.6 or later returns message protocols instead, though distance can still be obtained via direct use of the [[Modem (API)|Modem API]].}}

{{API table/row
|[[rednet.isOpen]]({{type|string}} side)
|{{type|boolean}} isOpen
|Returns [[Boolean_(type)|true]] if the wireless modem is open.
|odd}}

{{API table/row
|[[rednet.host]]({{type|string}} protocol, {{type|string}} hostname)
|{{type|nil}}
|Registers <var>hostname</var> against <var>protocol</var> for the purposes of [[rednet.lookup]](). '''Only available in ComputerCraft 1.6 and above.'''}}

{{API table/row
|[[rednet.unhost]]({{type|string}} protocol, {{type|string}} hostname)
|{{type|nil}}
|Unregisters <var>hostname</var> from <var>protocol</var>. '''Only available in ComputerCraft 1.6 and above.'''
|odd}}

{{API table/row
|[[rednet.lookup]]({{type|string}} protocol, {{type|string}} hostname)
|{{type|number}} ID1, {{type|number}} ID2, ...
|Searches the local network for systems registered with a matching <var>hostname</var> and/or <var>protocol</var>, and returns matching IDs found. '''Only available in ComputerCraft 1.6 and above.'''
}}

{{API table/row
|[[rednet.run]]()
|{{type|nil}}
|Internal use function - runs automatically and does not need to be called directly. Waits for [[Modem_message_(event)|modem_message]] events to appear within the event queue and generates corresponding [[Rednet_message_(event)|rednet_message]] events for use with this API. Also responds to [[rednet.lookup]]() requests.
|odd}}

}}

==Events==
{{Event|name=[[rednet_message_(event)|rednet_message]]
|desc=Fired when a rednet message is received (can be pulled via [[os.pullEvent|os.pullEvent()]] directly as an alternative to using [[rednet.receive|rednet.receive()]]).
|return1={{type|number}} senderId
|return2={{type|string}} message
|return3={{type|number}} distance / {{type|string}} protocol
}}

==Range==
The range of a wireless network transmission can be determined via the following formula:

minRange + (position.yCoord - 96.0) * ((maxRange - minRange) / ((world.getHeight() - 1) - 96.0))

Where, by default:

minRange = 64 (or 16 in a storm)
maxRange = 384 (or 96 in a storm)
world.getHeight() = 256

Catch is, that formula is quite capable of returning values that are well below 0... More research is required, it seems. Anyway, min/max range figures can be altered in [[ComputerCraft.cfg]], and the maximum range of a system located at world height will generally be equal to the maxRange for the current weather.

Even for the purposes of two-way communications, only the system with the best range is checked - a system located at the bottom of the world may hence send to and receive from a system at the top. Range is calculated in three dimensions, so the area a given system can reach wirelessly is represented by a sphere.

For wired networks, range between devices is 256 blocks of [[Networking_Cable|network cable]] (unconfigurable). Either method of communication works regardless as to whether the intervening chunks are loaded or not.

As of ComputerCraft 1.6, a [[Repeat|repeater script]] is available to all systems by default.

==Protocols==
Introduced by ComputerCraft 1.6, "protocols" are simple string names indicating what given messages are about. Receiving systems may filter messages according to their protocols, thereby automatically ignoring incoming messages which don't specify an identical string. It's also possible to [[rednet.lookup|lookup]] which systems in the area are interested in certain protocols, hence making it easier to determine where given messages should be sent in the first place.

==History==
Before the creation of the in-game wireless networking API, the term "Rednet" referred to a system created by a ComputerCraft user based on bundled cables from the popular Minecraft mod [http://www.eloraam.com RedPower]. That also allowed communication between computers, but the data was transferred slowly - every bit was converted to redstone signal (using the [[redstone (API)|redstone API]]) that lasted about 0.05 seconds (the length of a MineCraft "tick"). That system was rendered redundant by the release of ComputerCraft 1.3, as this heralded the arrival of [[Wireless Modem|wireless networking]] to the mod and allowed instant communications between computers.

Later, ComputerCraft 1.51 brought forward [[Wired Modem]]s, which could not only be used for regular network communications, but to interact with [[peripheral]]s remotely.

==Security==
In current versions of ComputerCraft (1.5 or later), Rednet is not to be considered a "secure" method of communication. The identity data indicating who sent a given message is set ''by the sender'', and hence cannot be trusted. Messages intended for a given system may be received and read by any other system in range.

This is because Rednet is simply a convenience wrapper for the [[modem (API)|modem API]], and while it typically sends/receives using channel numbers matching the IDs of systems you control, the latter offers ''complete control'' over channel usage. Another user can hence easily task the modem API directly to sniff and find out what messages a computer is receiving if he knows (or can even guess) its ID, or pretend to send from any ID he wishes.

When using Rednet for anything with security implications, be sure to implement your own methods of protection.

==Deprecated Functions==
{{Deprecated
|plural=yes
|type=These functions
}}

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

{{API table/row
|[[rednet.announce]]()
|{{type|nil}}
|Broadcasts an empty rednet message. Removed from ComputerCraft by version ''1.5'' in favor of [[rednet.broadcast]]()
|odd}}

}}

[[Category:APIs]]

Rednet

2014-10-24T00:19:02Z

Mitterdoo: Redirected page to Rednet (API)

#REDIRECT [[Rednet (API)]]

Peripheral

2014-10-24T00:18:16Z

Mitterdoo:

{{Selfref|This is an explanation for a peripheral. For the API, visit [[Peripheral (API)]].}}
A [[Peripheral]] is a Minecraft block which can be controlled using the [[Peripheral (API)|Peripheral API]]. Sometimes this is the main purpose of the block, e.g. for monitors and printers. Other times, it is merely incidental to the block's main purpose.

== Built-in peripherals ==
ComputerCraft itself includes some peripherals. Specifically:
* [[Monitor]]s and [[Advanced Monitor|advanced monitor]]s allow computers to display text in the world.
* [[Printer]]s allow computers to print text on paper.
* [[Disk Drive|Disk drive]]s allow computers to access floppy disks.
* [[Wireless Modem|Wireless]] and [[Wired Modem|wired]] modems allow computers to send messages to each other.
* [[Computer]]s, [[Advanced Computer|advanced computer]]s, [[Turtle|turtle]]s and [[Turtle|advanced turtle]]s can be turned on and off using the peripheral API.

For a full list of ComputerCraft peripherals, see [[:Category:Peripherals]].

== Mod Peripherals ==
Many mods add blocks which are peripherals. If this is the main purpose of the mod, it is often called a '''peripheral mod'''. Confusingly, this is sometimes shortened to '''peripheral'''.

Some mods, notably [[OpenPeripheral]], add a peripheral ability to blocks which don't normally have it (such as chests).

See [[:Category:User Created Peripherals]].

[[Category:Disambiguation Pages]]

Paintutils

2014-10-24T00:17:14Z

Mitterdoo: Redirected page to Paintutils (API)

#REDIRECT [[Paintutils (API)]]

Multishell

2014-10-24T00:16:22Z

Mitterdoo:

{{Selfref|This is an explanation for Multishell. For the API, visit [[Multishell (API)]].}}
{{lowercase}}[[File:Multishell.png|thumb|300px|Multiple instances of multishell may run at at time, producing layers of tabs.]]
As of ComputerCraft 1.6, '''multishell''' is a script automatically executed on startup by advanced systems. It allows easy use of multiple tabs of processes running on the one unit at the same time. By default, it launches just the one tab, running either [[CraftOS]] or [[TurtleOS]] - at a glance, a system with multishell looks identical to a system without, until such time as multiple tabs are running (at which point a menu bar appears).

Additional tabs may be opened by use of the [[fg]] or [[bg]] commands - supplied with a parameter, they'll launch the specified script in a new tab (in the foreground or background, respectively), or if not, they'll simply launch another shell. You may switch between tabs simply by clicking their titles on the top menu bar. Note that scripts continue to run regardless as to whether they're in the foreground or not.

The multishell system operates by making heavy use of the [[window (API)|window API]] (also introduced by ComputerCraft 1.6). If it is active on a unit, that unit will furthermore have access to the [[multishell (API)|multishell API]] (plus a couple of extra [[shell (API)|shell API]] commands), allowing other scripts to interact with it directly.

Note that the area of the screen taken by up by the menu bar is unavailable to scripts running within tabs. Some scripts may require full screen access to operate correctly - whether or not you'll be ''warned'' of this depends on whether the individual script author considered to [[term.getSize|check the display size]], so bear it in mind.

[[Category:Programs]]

Keys

2014-10-24T00:14:18Z

Mitterdoo: Redirected page to Keys (API)

#REDIRECT [[Keys_(API)]]

Io

2014-10-24T00:13:38Z

Mitterdoo: Redirected page to IO (API)

#REDIRECT [[IO_(API)]]

Help

2014-10-24T00:12:59Z

Mitterdoo: Redirected page to Help (API)

#REDIRECT [[Help_(API)]]

Gps

2014-10-24T00:12:06Z

Mitterdoo: Created page with "The term '''Gps''' may refer to: * Gps API Provides a method for turtles and computers to retrieve their own location. * Gps Program A program ..."

The term '''Gps''' may refer to:
* [[Gps_(API)|Gps API]] Provides a method for turtles and computers to retrieve their own location.
* [[Gps_(program)|Gps Program]] A program designed to make use of the positioning capabilities introduced in CC 1.31.

[[Category:Disambiguation_Pages]]

Fs

2014-10-24T00:07:55Z

Mitterdoo: See my recent changes for reasoning

#REDIRECT [[Fs_(API)]]

Bit

2014-10-24T00:05:23Z

Mitterdoo: See my recent changes for reasoning

#REDIRECT [[Bit_(API)]]

Parallel

2014-10-24T00:03:53Z

Mitterdoo: I'm recreating these redirect pages. I'm supposing cyclic redirects are endless redirect loops, which will not happen on the page this redirects to. If you think these should be removed, please discuss it with me.

#REDIRECT [[Parallel_(API)]]

Math

2014-10-24T00:03:42Z

#REDIRECT [[Math_(API)]]

Os

2014-10-24T00:01:24Z

#REDIRECT [[OS_(API)]]

User talk:AfterLifeLochie

2014-10-22T01:37:17Z

Mitterdoo: /* Why were API redirects removed? */

Another test. Ignore this.

== Why did you revert my changes on the function and example templates? ==

The 24px ones were really small and blurry. --[[Special:Contributions/67.189.72.22|67.189.72.22]] 13:17, 3 December 2012 (MSK)
* The templates are optimized for screen-readers at present, and are only meant to be a complimentary object. In addition, the files themselves are actually blurry and aren't rendered in high-enough definition. If and when I get FTP access, I can setup a better system than the current one, but the most important point; ''please don't edit live production templates without using a sandbox''. The effects of a template bungle could be a potential eye-sore. ''[[User:AfterLifeLochie|AfterLifeLochie]] 13:22, 3 December 2012 (MSK)''

== APT Minecraft Tekkit window. ==

Lochie, I was viewing your new forum thread on ComputerCraft APT and realised you were running Tekkit. I am glad that not all of the Mod Admins are so hardcoming on the Technic Team. Yours, [[User:Jonjon1234|Jonjon1234]] 15:51, 14 December 2012 (MSK)

== Program Listing? ==

Question for you: As a rookie to CC, I find it really hard to track down APIs or Programs in the forums for such. Sites like Turtlescripts have spawned trying to be a better browseable index of programs.

Would it make sense to have a Program Catalog on the site? I was thinking relatively lightweight, a table with the name, author, summary, current supported version, and a link to the Programs forum thread for it. Possibly have different sections for the major groupings, such as API, OS, Turtles, etc. I can do a mock-up version of what I'm describing if I'm describing poorly. Having posted a couple programs (and more to come), I'd have no issue creating a forum thread, then adding it to a Wiki page. I'd prefer the visibility. [[User:Rihlsul|Rihlsul]] 07:04, 27 March 2013 (MSK)

== Why did you revert my edits? ==

I just noticed my new version on [[Login_with_Roaming_Profiles|this page]] was removed, can you please tell me why? [[User:Latias1290|Latias1290]] 05:45, 28 August 2013 (GMT)

* Do not paste copyrighted or 'copyrighted' code, text or images on the ComputerCraft Wiki. By pasting code, text and content you release it to the public domain and I cannot assert you own said code due to the comments and 'copyright lines'. ''[[User:AfterLifeLochie|AfterLifeLochie]] 05:50, 28 August 2013 (GMT)''
::I thought it was fine because "Dirk Kok" is my real name, but Ill leave it out. [[User:Latias1290|Latias1290]] 05:51, 28 August 2013 (GMT)
::* No, under no circumstances is copyright content permitted. You must release it to public domain to paste it here. ''[[User:AfterLifeLochie|AfterLifeLochie]] 05:52, 28 August 2013 (GMT)''

== Any chance for Lua syntax highlighting? ==

I started this topic a few minutes ago on the [[Wiki Todo#Wiki Admin Things|Wiki Todo]] and I'm placing this note here to make sure you get a chance to see it. -[[User:Turkey|Turkey]] 23:58, 29 August 2014 (GMT)

== Why were API redirects removed? ==

When I searched for an API, which in my case was Term, most people would be looking for the API. However there isn't a redirect page. In fact there aren't ''any'' redirect pages for the APIs. Why is this? When I tried to create it I was greeted with the message saying you deleted it for the reason "Omnomnom redirect pages!"

So there were redirect pages? Why remove them? They're very useful and help you find what you're looking for.
[[User:Mitterdoo|Mitterdoo]] 01:33, 22 October 2014 (GMT)

'''EDITED'''
I just saw for other API redirects that the reason was "Cyclic redirects will be removed" But why would that ever happen? There isn't anything on the API pages that redirect back to the deleted pages, otherwise they wouldn't exist.

User talk:AfterLifeLochie

2014-10-22T01:34:37Z

Mitterdoo: Added username

Another test. Ignore this.

== Why did you revert my changes on the function and example templates? ==

The 24px ones were really small and blurry. --[[Special:Contributions/67.189.72.22|67.189.72.22]] 13:17, 3 December 2012 (MSK)
* The templates are optimized for screen-readers at present, and are only meant to be a complimentary object. In addition, the files themselves are actually blurry and aren't rendered in high-enough definition. If and when I get FTP access, I can setup a better system than the current one, but the most important point; ''please don't edit live production templates without using a sandbox''. The effects of a template bungle could be a potential eye-sore. ''[[User:AfterLifeLochie|AfterLifeLochie]] 13:22, 3 December 2012 (MSK)''

== APT Minecraft Tekkit window. ==

Lochie, I was viewing your new forum thread on ComputerCraft APT and realised you were running Tekkit. I am glad that not all of the Mod Admins are so hardcoming on the Technic Team. Yours, [[User:Jonjon1234|Jonjon1234]] 15:51, 14 December 2012 (MSK)

== Program Listing? ==

Question for you: As a rookie to CC, I find it really hard to track down APIs or Programs in the forums for such. Sites like Turtlescripts have spawned trying to be a better browseable index of programs.

Would it make sense to have a Program Catalog on the site? I was thinking relatively lightweight, a table with the name, author, summary, current supported version, and a link to the Programs forum thread for it. Possibly have different sections for the major groupings, such as API, OS, Turtles, etc. I can do a mock-up version of what I'm describing if I'm describing poorly. Having posted a couple programs (and more to come), I'd have no issue creating a forum thread, then adding it to a Wiki page. I'd prefer the visibility. [[User:Rihlsul|Rihlsul]] 07:04, 27 March 2013 (MSK)

== Why did you revert my edits? ==

I just noticed my new version on [[Login_with_Roaming_Profiles|this page]] was removed, can you please tell me why? [[User:Latias1290|Latias1290]] 05:45, 28 August 2013 (GMT)

* Do not paste copyrighted or 'copyrighted' code, text or images on the ComputerCraft Wiki. By pasting code, text and content you release it to the public domain and I cannot assert you own said code due to the comments and 'copyright lines'. ''[[User:AfterLifeLochie|AfterLifeLochie]] 05:50, 28 August 2013 (GMT)''
::I thought it was fine because "Dirk Kok" is my real name, but Ill leave it out. [[User:Latias1290|Latias1290]] 05:51, 28 August 2013 (GMT)
::* No, under no circumstances is copyright content permitted. You must release it to public domain to paste it here. ''[[User:AfterLifeLochie|AfterLifeLochie]] 05:52, 28 August 2013 (GMT)''

== Any chance for Lua syntax highlighting? ==

I started this topic a few minutes ago on the [[Wiki Todo#Wiki Admin Things|Wiki Todo]] and I'm placing this note here to make sure you get a chance to see it. -[[User:Turkey|Turkey]] 23:58, 29 August 2014 (GMT)

== Why were API redirects removed? ==

When I searched for an API, which in my case was Term, most people would be looking for the API. However there isn't a redirect page. In fact there aren't 'any' redirect pages for the APIs. Why is this? When I tried to create it I was greeted with the message saying you deleted it for the reason "Omnomnom redirect pages!"

So there were redirect pages? Why remove them? They're very useful and help you find what you're looking for.
[[User:Mitterdoo|Mitterdoo]] 01:33, 22 October 2014 (GMT)

User talk:AfterLifeLochie

2014-10-22T01:33:45Z

Mitterdoo: /* Why were API redirects removed? */ new section

Another test. Ignore this.

== Why did you revert my changes on the function and example templates? ==

The 24px ones were really small and blurry. --[[Special:Contributions/67.189.72.22|67.189.72.22]] 13:17, 3 December 2012 (MSK)
* The templates are optimized for screen-readers at present, and are only meant to be a complimentary object. In addition, the files themselves are actually blurry and aren't rendered in high-enough definition. If and when I get FTP access, I can setup a better system than the current one, but the most important point; ''please don't edit live production templates without using a sandbox''. The effects of a template bungle could be a potential eye-sore. ''[[User:AfterLifeLochie|AfterLifeLochie]] 13:22, 3 December 2012 (MSK)''

== APT Minecraft Tekkit window. ==

Lochie, I was viewing your new forum thread on ComputerCraft APT and realised you were running Tekkit. I am glad that not all of the Mod Admins are so hardcoming on the Technic Team. Yours, [[User:Jonjon1234|Jonjon1234]] 15:51, 14 December 2012 (MSK)

== Program Listing? ==

Question for you: As a rookie to CC, I find it really hard to track down APIs or Programs in the forums for such. Sites like Turtlescripts have spawned trying to be a better browseable index of programs.

Would it make sense to have a Program Catalog on the site? I was thinking relatively lightweight, a table with the name, author, summary, current supported version, and a link to the Programs forum thread for it. Possibly have different sections for the major groupings, such as API, OS, Turtles, etc. I can do a mock-up version of what I'm describing if I'm describing poorly. Having posted a couple programs (and more to come), I'd have no issue creating a forum thread, then adding it to a Wiki page. I'd prefer the visibility. [[User:Rihlsul|Rihlsul]] 07:04, 27 March 2013 (MSK)

== Why did you revert my edits? ==

I just noticed my new version on [[Login_with_Roaming_Profiles|this page]] was removed, can you please tell me why? [[User:Latias1290|Latias1290]] 05:45, 28 August 2013 (GMT)

* Do not paste copyrighted or 'copyrighted' code, text or images on the ComputerCraft Wiki. By pasting code, text and content you release it to the public domain and I cannot assert you own said code due to the comments and 'copyright lines'. ''[[User:AfterLifeLochie|AfterLifeLochie]] 05:50, 28 August 2013 (GMT)''
::I thought it was fine because "Dirk Kok" is my real name, but Ill leave it out. [[User:Latias1290|Latias1290]] 05:51, 28 August 2013 (GMT)
::* No, under no circumstances is copyright content permitted. You must release it to public domain to paste it here. ''[[User:AfterLifeLochie|AfterLifeLochie]] 05:52, 28 August 2013 (GMT)''

== Any chance for Lua syntax highlighting? ==

I started this topic a few minutes ago on the [[Wiki Todo#Wiki Admin Things|Wiki Todo]] and I'm placing this note here to make sure you get a chance to see it. -[[User:Turkey|Turkey]] 23:58, 29 August 2014 (GMT)

== Why were API redirects removed? ==

When I searched for an API, which in my case was Term, most people would be looking for the API. However there isn't a redirect page. In fact there aren't 'any' redirect pages for the APIs. Why is this? When I tried to create it I was greeted with the message saying you deleted it for the reason "Omnomnom redirect pages!"

So there were redirect pages? Why remove them? They're very useful and help you find what you're looking for.
01:33, 22 October 2014 (GMT)

CraftOS

2014-10-20T23:57:01Z

Mitterdoo: By searching "shell" you are redirected to this page. Some people search for the API, so link to that is on top of page.

{{Stub|Needs more info - especially links to other articles.}}
{{Selfref|This is the article for CraftOS. If you were redirected from Shell and are looking for the API, see [[Shell (API)]]}}
[[File:2012-01-30_23.02.52.png|frame|right|CraftOS's interface.]]CraftOS is the default ComputerCraft OS. It has a DOS style interface, where you use ls to view programs, cd to move through directories, and type the name of a program to run it.

Its features include...
*DOS style interface
*Default; guaranteed to work unlike the others which may break with ComputerCraft updates
*Do-It-Yourself, allowing you to customize what you want on your OS

[[Category:OSes]]

Template:Selfref

2014-10-20T23:55:39Z

Mitterdoo: Added template; making changes very soon

{{msgbox
| title = Is this the page you were looking for?
| text = {{{1}}}
| bgcol = #CCEEFF
}}

Shell.resolveProgram

2013-07-14T02:17:26Z

Mitterdoo:

{{Function
|name=shell.resolveProgram
|args=[[string]] program
|api=shell
|returns=[[string]] path
|addon=ComputerCraft
|desc=Gets the absolute path to the program
|examples={{Example
|desc=Finds the path to default program "hello"
|code=shell.resolveProgram("hello")
|output=rom/programs/computer/hello
}}
}}
[[Category:API_Functions]]

Shell.resolveProgram

2013-07-14T02:16:07Z

Mitterdoo: Created page with "{{Function |name=shell.resolveProgram |args=string program |api=shell |returns=string path |addon=ComputerCraft |examples={{Example |desc=Gets the absolute pat..."

{{Function
|name=shell.resolveProgram
|args=[[string]] program
|api=shell
|returns=[[string]] path
|addon=ComputerCraft
|examples={{Example
|desc=Gets the absolute path to the program
|code=shell.resolveProgram("hello")
|output=rom/programs/computer/hello
}}
}}
[[Category:API_Functions]]

Turtle (API)

2013-07-05T20:29:08Z

Mitterdoo:

The Turtle API is used to work with your [[Turtle|Turtles]].

===Key===
{| class="wikitable"
! Color !! Turtles that can perform this
|-
| White ||All
|-{{row-lightgreen}}
|Green || Crafty
|-{{row-lightyellow}}
| Yellow || Mining, Felling, Digging, Farming
|-{{row-lightred}}
| Red || Any tool
|}


===API===
{| class="wikitable"
! width="100px" | Return
! width="200px" | Method name
! Description
! Min version
|-{{row-lightgreen}}
|{{type|boolean}} success
|[[turtle.craft]]({{type|int}} quantity)
|Craft items using ingredients anywhere in the turtle's inventory and place results in the active slot. If a quantity is specified, it will craft only up to that many items, otherwise, it will craft as many of the items as possible.
|
|-
|{{type|boolean}} success
|[[turtle.forward]]()
|Try to move the turtle forward
|
|-
|{{type|boolean}} success
|[[turtle.back]]()
|Try to move the turtle backward
|
|-
|{{type|boolean}} success
|[[turtle.up]]()
|Try to move the turtle up
|
|-
|{{type|boolean}} success
|[[turtle.down]]()
|Try to move the turtle down
|
|-
|{{type|boolean}} success
|[[turtle.turnLeft]]()
|Turn the turtle left
|
|-
|{{type|boolean}} success
|[[turtle.turnRight]]()
|Turn the turtle right
|
|-
|{{type|boolean}} success
|[[turtle.select]]({{type|int}} slotNum)
|Make the turtle select slot ''slotNum'' (1 is top left, 16 (9 in 1.33 and earlier) is bottom right)
|
|-
|{{type|int}} count
|[[turtle.getItemCount]]({{type|int}} slotNum)
|Counts how many items are in slot ''slotNum''
|
|-
|{{type|int}} count
|[[turtle.getItemSpace]]({{type|int}} slotNum)
|Counts how many remaining items you need to fill the stack in slot ''slotNum''
|
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attack]]()
|Attacks in front of the turtle.
| 1.4
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attackUp]]()
|Attacks above the turtle.
| 1.4
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attackDown]]()
|Attacks under the turtle.
| 1.4
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.dig]]()
|Breaks the block in front. With hoe: tills the dirt in front of it.
|
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.digUp]]()
|Breaks the block above. With hoe: tills the dirt above it.
|
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.digDown]]()
|Breaks the block below. With hoe: tills the dirt below it.
|
|-
|{{type|boolean}} success
|[[turtle.place]]([<nowiki></nowiki>{{type|string}} signText])
|Places a block of the selected slot in front. Engrave ''signText'' on signs if provided.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.placeUp]]()
|Places a block of the selected slot above
|
|-
|{{type|boolean}} success
|[[turtle.placeDown]]()
|Places a block of the selected slot below
|
|-
|{{type|boolean}} result
|[[turtle.detect]]()
|Detects if there is a block in front. Does not detect mobs.
|
|-
|{{type|boolean}} result
|[[turtle.detectUp]]()
|Detects if there is a block above
|
|-
|{{type|boolean}} result
|[[turtle.detectDown]]()
|Detects if there is a block below
|
|-
|{{type|boolean}} result
|[[turtle.compare]]()
|Detects if the block in front is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareUp]]()
|Detects if the block above is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareDown]]()
|Detects if the block below is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareTo]]({{type|int}} slot)
|Compare the current selected slot and the given slot to see if the items are the same. Returns true if they are the same, false if not.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.drop]]([<nowiki></nowiki>{{type|int}} count])
|Drops all items in the selected slot, or specified, drops ''count'' items. [>= 1.4 only:] If there is a inventory on the side (i.e in front of the turtle) it will try to place into the inventory, returning false if the inventory is full.
|
|-
|{{type|boolean}} success
|[[turtle.drop|turtle.dropUp]]([<nowiki></nowiki>{{type|int}} count])
|Drops all items in the selected slot, or specified, drops ''count'' items. [>= 1.4 only:] If there is a inventory on the side (i.e above the turtle) it will try to place into the inventory, returning false if the inventory is full. If below a furnace, will place item in the bottom slot.
|
|-
|{{type|boolean}} success
|[[turtle.drop|turtle.dropDown]]([<nowiki></nowiki>{{type|int}} count])
|Drops all items in the selected slot, or specified, drops ''count'' items. [>= 1.4 only:] If there is a inventory on the side (i.e below the turtle) it will try to place into the inventory, returning false if the inventory is full. If above a furnace, will place item in the top slot.
|
|-
|{{type|boolean}} success
|[[turtle.suck]]()
|Picks up an item stack of any number, from the ground or an inventory in front of the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.suck|turtle.suckUp]]()
|Picks up an item stack of any number, from the ground or an inventory above the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.suck|turtle.suckDown]]()
|Picks up an item stack of any number, from the ground or an inventory below the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.refuel]]([<nowiki></nowiki>{{type|int}} quantity])
|If the current selected slot contains a fuel item, it will consume it to give the turtle the ability to move. Added in 1.4 and is only needed in needfuel mode. If the current slot doesn't contain a fuel item, it returns false. Fuel values for different items can be found at [[Turtle.refuel#Fuel_Values]]. If a quantity is specified, it will refuel only up to that many items, otherwise, it will consume all the items in the slot.
| 1.4
|-
|{{type|int}} fuel
|[[turtle.getFuelLevel]]()
|Returns the current fuel level of the turtle, this is the number of blocks the turtle can move. If turtleNeedFuel = 0 then it returns "unlimited".
| 1.4
|-
|{{type|boolean}} success
|[[turtle.transferTo]]({{type|int}} slot [, {{type|int}} quantity])
|Transfers ''quantity'' items from the selected slot to ''slot''. If ''quantity'' isn't specified, will attempt to transfer everything in the selected slot to ''slot''.
| 1.45
|}

Trivia:
During the 1.4 beta, turtle.getFuelLevel() in softcore(that is now turtleneedsfuel = 0) returned 9000.
[[Category:APIs]]

Modem (API)

2013-03-29T11:20:36Z

Mitterdoo:

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

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

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

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

local modem = peripheral.wrap("right") --Wraps the modem on the right side.
modem.transmit(3, 1, "Hello world!")


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

==Receiving Messages==
Receiving messages requires that you be familiar with events. As of this moment, there is no api which cuts out events from the process. Here is an example of how to receive messages:

local modem = peripheral.wrap("left")
modem.open(3)--Open channel 3 so that we can listen on it
local event, modemSide, senderChannel,
replyChannel, message, senderDistance = os.pullEvent("modem_message")
print("I just received a message from: "..senderChannel)
print("I should apparently reply on: "..replyChannel)
print("The modem receiving this is located on the "..modemSide.." side")
print("The message was: "..message)
print("The sender is: "..senderDistance.." blocks away from me.")

So what did I do? Quite simply, I called os.pullEvent() with the string argument "modem_message", which blocks all other events from being returned. When the "modem_message" event is captured, it returns the arguments: event, modemSide, senderChannel, replyChannel, message, senderDistance. I captured these and then printed them out.

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

[[Category:APIs]]

Wireless Modem

2013-03-29T11:19:39Z

Mitterdoo:

{{NeedsWork|The behaviour of Rednet has changed as of 1.5 - please consider updating this page with information. (Please don't add prerelease info!)}}
:''This page is for the Modem blocks. For the modem API, see [[Modem_(API)|Modem (API)]]''
{{Block
|name=Modem
|image=WirelessModem.png
|id=4094
|damage-value=1
|is-peripheral=Yes
|peripheral-api=Modem (API)
}}
Modems are blocks which can be used to wirelessly transfer data between [[Computer|computers]] and [[Turtle|turtles]], using the [[Rednet_(API)|Rednet API]] or the [[Modem_(API)|Modem API]].
To place a modem on a side of a computer, right-click to place the modem while sneaking.

It is also possible to turn the modem on and off by typing "rednet.open ( side )" to open and "rednet.close ( side )" to close.

Modems can send messages to other modems located up to 64 meters away, or 16 meters during a thunderstorm.
As of 1.4 Modem range is increased with higher altitudes. If there is no thunderstorm, the range will always be higher than 64, and at max altitude you would have a range of 384 meters.

In 1.4 and 1.41 there is a miscalculation that causes the range to only be 381 meters at max altitude.

== Recipe ==
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_torch |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=Modem
}}

== Example (Rednet API)==
* Place 2 computers and add modems to them by clicking the right mouse button while sneaking.
* Access them, and start Lua.
* Once Lua has started, type "[[rednet_(API)|rednet]].[[rednet.open|open]] ("<relative location to modem, e.g. left, right>")" on both computers.
* Check if there exists a connection: a dim, red light should be found on the modem.
* Type on one computer "[[rednet_(API)|rednet]].[[rednet.receive|receive]] (60)". This will make the computer freeze for 60 seconds, or until it has received a signal from the other computers.
* Now, type "[[rednet_(API)|rednet]].[[rednet.broadcast|broadcast]] ('<your message>')" on the other computer. This should send your message to all computers connected.
* Opening the first computer should show the message written on the second computer.

==Modem as a Peripheral==
To use a Modem as a peripheral, you need to either call a method directly using [[peripheral.call]](), or, wrap the modem using the [[Peripheral_(API)|Peripheral API]]. Wrapped modems provide all functions listed in the [[Rednet_(API)|Rednet API]].

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

-- Immediately invoke a method without wrapping
peripheral.call("top", "open")

-- You can also "wrap" the peripheral side to a variable:
local modem = peripheral.wrap("top")
modem.open("top")

[[Category:Peripherals]]

Turtle (API)

2012-03-20T03:02:33Z

Mitterdoo:

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