ComputerCraft Wiki - User contributions [en]

Os.startTimer

2013-04-23T00:05:45Z

Viproz: it returns an int not a table

{{lowercase}}
{{Function
|name=os.startTimer
|args=[[float (type)|float]] time
|api=OS
|returns=[[int (type)|int]] timerID
|addon=ComputerCraft
|desc=Adds a timer which will fire a "timer" event once after <var>time</var> seconds have passed. It returns an int which acts as a unique ID for the timer.
|examples=
}}

[[Category:Lua_Core_Functions]]

Template:Changelog

2013-03-30T21:15:19Z

Viproz: Added 1.52

{| class="wikitable sortable" style="width: 100%"
! style="width: 15%" | Version
! class="unsortable" | New Features or Changes
! style="width: 15%" | Minecraft Version
|-
|align=center|[http://www.computercraft.info/2013/03/26/computercraft-1-52// Computercraft 1.52]
|
* Ported to Minecraft 1.5.1
|align=center|1.5.1
|-
|align=center|[http://www.computercraft.info/2013/03/15/computercraft-1-51// Computercraft 1.51]
|
* Ported to Minecraft 1.5
* Added [[Wired Modem|Wired Modems]]
* Added [[Networking Cable|Networking Cables]]
* Made [[Wireless Modem|Wireless Modems]] more expensive to craft
* New redstone API functions: getAnalogInput(), setAnalogOutput(), getAnalogOutput()
* Peripherals can now be controlled remotely over wired networks
* New peripheral API function: getNames()
* New event: “monitor_resize” when the size of a monitor changes
* Except for labelled computers and turtles, ComputerCraft blocks no longer drop items in creative mode
* The pick block function works in creative mode now works for all ComputerCraft blocks
* All blocks and items now use the IDs numbers assigned by FTB by default
* Fixed turtles sometimes placing blocks with incorrect orientations
* Fixed Wireless modems being able to send messages to themselves
* Fixed [[turtle.attack]]() having a very short range
* Various bugfixes
|align=center|1.5
|-
|align=center|[http://www.computercraft.info/2013/02/11/computercraft-1-5/ Computercraft 1.5]
|
*Redesigned Wireless Modems; they can now send and receive on multiple channels, independent of the computer ID. To use these features, interface with modem peripherals directly. The rednet API still functions as before.
*[[Floppy Disk|Floppy Disks]] can now be dyed with multiple dyes, just like armour.
*The “excavate” program now retains fuel in it’s inventory, so can run unattended.
*[[turtle.place]]() now tries all possible block orientations before failing.
*[[turtle.refuel]](0) returns true if a fuel item is selected.
*[[turtle.craft]](0) returns true if the inventory is a valid recipe.
*The in-game help system now has documentation for all the peripherals and their methods, including the new [[modem]] functionality.
*A romantic surprise.
|align=center|1.4.7
|-
|align=center|[http://www.computercraft.info/2012/12/27/computercraft-1-481-miscperipherals-fix/ Computercraft 1.481]
|
*Fixed compatibility bug with MiscPeripherals.
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/12/23/computercraft-1-48/ Computercraft 1.48]
|
*Ported to Minecraft 1.4.6
*[[Advanced Monitor|Advanced Monitors]] can now be used as touchscreens
*[[Advanced Monitor|Advanced Monitors]] are now easier to craft
*[[Turtle|Turtles]] now get slightly less movement from fuel
*[[Turtle|Turtles]] can now push items
*[[Computer|Computers]] can now control Command Blocks, if enabled in the config
*New API function: os.day()
*A Christmas surprise
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/11/15/computercraft-1-47-and-minecon-news/ ComputerCraft 1.47]
|
*Ported to Minecraft 1.4.4
*Fixed label tooltips not showing up in SMP
|align=center|1.4.4
|-
|align=center|[http://www.computercraft.info/2012/10/25/computercraft-1-46-minecraft-update/ ComputerCraft 1.46]
|
*Ported to Minecraft 1.4.2
*ComputerCraft items now have their own tab in Creative Mode
|align=center|1.4.2
|-
|align=center|[http://www.computercraft.info/2012/10/22/computercraft-1-45-now-with-colors/ ComputerCraft 1.45]
|
*Added [[Advanced Computer|Advanced Computers]]
*Added [[Advanced Monitor|Advanced Monitors]]
*New program: paint (by nitrogenfingers)
*New API: [[paintutils_(API)|paintutils]]
*New term functions: term.setBackgroundColor, term.setTextColor, term.isColor
*New [[Turtle|Turtle]] function: [[turtle.transferTo]]
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/10/04/computercraft-1-43-books/ ComputerCraft 1.43]
|
*Added Printed Pages (bind several Printed Page items into one with string)
*Added Printed Books (add a leather cover to the above)
*Labelled [[Turtle|Turtles]] now keep their fuel when broken
*Fixed incompatibility with Forge 275 and above
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/09/22/computercraft-1-42-is-released/ ComputerCraft 1.42]
|
*Ported to Minecraft 1.3.2 and the Forge mod system
*Added [[Printer|Printers]]
*Floppy Disks can now be dyed different colours
*Wireless Crafty Turtles can now be crafted
*All new textures
*New Forge config file
*Various tweaks and bug fixes
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/07/29/computercraft-1-41-bugfix-update/ ComputerCraft 1.41]
|
*Fixed labelled [[Computer|Computers]] not keeping their data when destroyed
*Fixed the “excavate” program outputting lots of spam
*File system size limits now take into account empty files and directories
*Some small changes to the Turtle Upgrade API ahead of it’s impending release.(Update: The API has now been released)
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/07/27/computercraft-1-4-is-released/ ComputerCraft 1.4]
|
*Ported to Forge Mod Loader: ComputerCraft can now be ran directly from the .zip without extraction
*Added Farming [[Turtle|Turtles]], Felling [[Turtle|Turtles]], Digging [[Turtle|Turtles]], Melee [[Turtle|Turtles]] and Crafty [[Turtle|Turtles]]
*Added 14 new[[Turtle|Turtles]] Combinations accessible by combining the turtle upgrades above
*Labelled [[Computer|Computers]] and turtles can now be crafted into turtles or other turtle types without losing their ID, label and data
*Added a [[Turtle|Turtles]] Upgrade API” for mod developers to create their own tools and peripherals for turtles
*[[Turtle|Turtles]] can now attack entities with [[turtle.attack]](), and collect their dropped items
*[[Turtle|Turtles]] can now use [[turtle.place]]() with any item the player can, and can interact with entities
*[[Turtle|Turtles]] can now craft items with [[turtle.craft]]()
*[[Turtle|Turtles]] can now place items into inventories with [[turtle.drop]]()
*Changed the behaviour of [[turtle.place]]() and [[turtle.drop]]() to only consider the currently selected slot
*[[Turtle|Turtles]] can now pick up items from the ground, or from inventories, with [[turtle.suck]]()
*[[Turtle|Turtles]] can now compare items in their inventories
*[[Turtle|Turtles]] can place signs with text on them with [[turtle.place]]( [signText] )
*[[Turtle|Turtles]] now optionally require fuel items to move, and can refuel themselves
*The size of the the [[Turtle|Turtle]] inventory has been increased to 16
*The size of the [[Turtle|Turtle]] screen has been increased
*New [[Turtle|Turtle]] functions: [[turtle.compareTo]]( [slotNum] ), [[turtle.craft]](), [[turtle.attack]](), [[turtle.attackUp]](), [[turtle.attackDown]](), [[turtle.drop|turtle.dropUp]](), [[turtle.drop|turtle.dropDown]](), [[turtle.getFuelLevel]](), [[turtle.refuel]]()
*New [[Disk]] function: [[disk.getDiskID]]()
*New [[Turtle|Turtle]] programs: craft, refuel
*“excavate” program now much smarter: Will return items to a chest when full, attack mobs, and refuel itself automatically
*New API: keys
*Added optional Floppy Disk and Hard Drive space limits for [[Computer|Computers]] and [[Turtle|Turtles]]
*New fs function: [[fs.getFreeSpace]]( path ), also [[fs.getDrive]]() works again
*The send and receive range of wireless modems now increases with altitude, allowing long range networking from high-altitude [[Computer|Computers]] (great for GPS networks)
*[[http.request]]() now supports https:// URLs
*Right clicking a [[Disk Drive]] with a [[Floppy Disk]] or a Record when sneaking will insert the item into the [[Disk Drive]] automatically
*The default size of the [[Computer]] screen has been increased
*Several stability and security fixes: LuaJ can now no longer leave dangling threads when a computer is unloaded, turtles can no longer be destroyed by tree leaves or walking off the edge of the loaded map. [[Computer|Computers]] no longer crash when used with RedPower frames
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/04/23/computercraft-updated-to-1-2-5/ ComputerCraft 1.33]
|
*Ported to Minecraft 1.2.5
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/03/30/computercraft-1-32-out-now/ ComputerCraft 1.32]
|
*Ported to Minecraft 1.2.4
*Fixed a big memory leak in LuaJ that caused extra threads to stay around forever when [[Computer|Computers]] were shut down.
|align=center|1.2.4
|-
|align=center|[http://www.computercraft.info/2012/03/13/computercraft-1-31-is-released/ ComputerCraft 1.31]
|
*Ported to Minecraft 1.2.3
*Added [[Monitor|Monitors]] (thanks to Cloudy). Build huge external displays for your [[Computer|Computers]]!
*New positioning capabilities for [[Computer|Computers]] and [[Turtle|Turtles]]. Build GPS networks and triangulate the positions of your turtles position so they never get lost!
*New [[turtle.compare]]() function for turtles for more intelligent mining.
*New programs and APIs: gps, monitor, vector
*New program: pastebin (requires enableAPI_HTTP=1 in mod_ComputerCraft.cfg), upload and download programs made by other users ingame!
*Added a new top secret program designed for use with Monitors, see if you can find it.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.2.3
|-
|align=center|[http://www.computercraft.info/2012/02/23/computercraft-1-3-trailer/ ComputerCraft 1.3]
|
*Ported to Minecraft Forge.
*Added [[Turtle|Turtles]], Mining [[Turtle|Turtles]], Wireless [[Turtle|Turtles]] and Wireless Mining [[Turtle|Turtles]] (Block ID 209).
*Added a Peripheral API to allow mod developers to create custom peripherals for ComputerCraft. Details on this will be posted in the next few days.
*Added [[Modem|Wireless Modems]]. Use the [[Rednet_(API)|rednet API]] to send data wirelessly between [[Computer|Computers]] and [[Turtle|Turtles]]!
*[[Computer|Computers]] and Disk Drives no longer get destroyed by water.
*[[Computer|Computers]] and [[Turtle|Turtles]] can now be labelled, destroyed, and moved around, keeping their state.
*[[Computer|Computers]] and [[Turtle|Turtles]] can connect to adjacent devices, and turn them on or off.
*User programs now give line numbers in their error messages, for easier debugging.
*New APIs and programs for [[Turtle|Turtles]]: turtle, excavate, tunnel, go, turn and dance.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.1
|-
|align=center|ComputerCraft 1.21
|
*Added shortcut key to shutdown the computer.
*Added a help API add-on pack.
*Various bug fixes.
|align=center|1.1
|-
|align=center|ComputerCraft 1.2
|
*Added Disk Drives
*Added shortcut keys to terminate the current program and reboot the computer.
*Added a new system for user created APIs.
*Added RedNet.
*Added [[shell.setPath]]() and [[shell.setAlias]]().
*Added a new ROM startup script.
*Added [[os.clock]](), [[os.time]](), and [[os.setAlarm]]().
*Added game: "Worm!"
*Added programs: alias, apis, copy, delete, dj, drive, eject, id, label, list, move, reboot, redset, rename, time, worm.
*Added APIs: bit, colours, disk, help, rednet, parallel, textutils
*Text can be edited with left and right arrow keys.
*Many bug fixes
|align=center|1.0
|-
|align=center|ComputerCraft 1.11
|
*Fixed bug where [[Computer|Computers]] could not read input from RedPower cables which had a bend in the immediately adjacent square.
|align=center|1.0
|-
|align=center|ComputerCraft 1.1
|
*Changed the default block ID for the [[Computer|Computer]] to 207.
*Added multiplayer support.
*Added connectivity with RedPower bundled cables.
*Added HTTP API
*Fixed support for HD textures on the front of [[Computer|Computers]].
*Added command history to the [[Computer]].
*Added config options to change the size of the [[Computer]] GUI and the text color.
*Programs with infinite loops that don't yield will no longer freeze Minecraft and will terminate after 10 seconds.
*Extended Help and fixed typos/small errors in various programs.
|align=center|1.0
|-
|align=center|ComputerCraft 1.02
|
*Fixed the MCPatcher HD textures incompatibility that was causing the computer texture to replace cobblestone blocks.
|align=center|1.0
|-
|align=center|ComputerCraft 1.01
|
*Added a ModLoader configuration file, so the computers block ID can be changed.
*Made the error message that displays when Lua files are not correctly installed much more clear, no more "Assertion failed."
|align=center|1.0
|-
|align=center|ComputerCraft 1.0
|
*First Release
|align=center|1.0
|}

Command Block (API)

2013-03-30T21:10:09Z

Viproz:

The Command Block API allows you to run commands in a Command Block, using it as a peripheral.
(The peripheral can only be used if allowed in the config, which is default to false)

Functions exposed by the Command Block, where commandBlock is warped to a command block :
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="*"|Function
!style="background:#EEE" width="*"|Description
|-
|[[commandBlock.getCommand]]( )
|Returns a string containing the command currently inside the Command Block.
|-
|[[commandBlock.setCommand]]( [[string_(type)|string]] command )
|Sets the command in the Command Block. '''This does not run it.'''
|-
|[[commandBlock.runCommand]]( )
|Runs the command inside the Command Block previously set by [[commandBlock.setCommand]]( )
|}

==Note==
All Command Block functions are to be used ''after'' wrapping the block in a peripheral.
'''example''':

commandBlock = [[peripheral.wrap]]("left")
commandBlock.setCommand("time set 1000")
commandBlock.runCommand()
local currentCommand = commandBlock.getCommand()


[[Category:Peripheral APIs]]

Command Block (API)

2013-03-30T21:09:21Z

Viproz:

The Command Block API allows you to run commands in a Command Block, using it as a peripheral.
(The peripheral can only be used if allowed in the config, which is default to false)

Functions exposed by the Command Block, where commandBlock is warped to a command block :
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Function
!style="background:#EEE" width="*"|Description
|-
|[[commandBlock.getCommand]]( )
|Returns a string containing the command currently inside the Command Block.
|-
|[[commandBlock.setCommand]]( [[string_(type)|string]] command )
|Sets the command in the Command Block. '''This does not run it.'''
|-
|[[commandBlock.runCommand]]( )
|Runs the command inside the Command Block previously set by [[commandBlock.setCommand]]( )
|}

==Note==
All Command Block functions are to be used ''after'' wrapping the block in a peripheral.
'''example''':

commandBlock = [[peripheral.wrap]]("left")
commandBlock.setCommand("time set 1000")
commandBlock.runCommand()
local currentCommand = commandBlock.getCommand()


[[Category:Peripheral APIs]]

Template:News

2013-03-30T04:34:14Z

Viproz: add a news

'''March 26, 2013'''
*Computercraft 1.52 is out for Minecraft '''1.5.1'''.
'''December 27, 2012'''
*Computercraft 1.481 is released as a quick hotfix for MiscPeripherals.
'''December 23, 2012'''
*Computercraft 1.48 is out for Minecraft '''1.4.6'''!
'''November 20th, 2012''':
*Computercraft 1.47 works just fine for Minecraft '''1.4.5'''!
'''November 15th, 2012''':
*Computercraft 1.47 is out for Minecraft '''1.4.4'''!
*Minecon news '''[http://www.computercraft.info/2012/11/15/computercraft-1-47-and-minecon-news/ here!]'''
'''October 25th, 2012''':
*ComputerCraft 1.46 is out for Minecraft '''1.4.2'''!

Template:Version

2013-03-30T04:30:26Z

Viproz: New version

<table style="width:100%">
<tr>
<td style="width:100px;">[[File:Icon_Minecraft.png]]  Minecraft:</td>
<td>ComputerCraft '''1.52''' for '''Minecraft 1.5.1'''</td>
</tr>
<tr>
<td style="width:100px;">[[File:Icon_Bukkit.png]]  Bukkit:</td>
<td>ComputerCraft '''1.41''' for '''MCPC Build 177+'''</td>
</tr>
</table>
<center>'''[[Changelog]]'''</center>

Recipes

2013-03-30T04:28:59Z

Viproz: change the presentation of the old recipe

{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Item
!style="background:#EEE" width="*"|Crafting ingredients
|-
|[[Computer]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=glass_pane |C3=Stone
|Output=Computer
}}
|-
|[[Wired Modem]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Wired_Modem
}}
|-
|[[Networking Cable]]
|{{Crafting grid
| B1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|B3=Stone
|Output=Networking_Cable
|OA=6
}}
|-
|[[Wireless Modem|Wireless Modem]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=ender_pearl |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Modem
}}
|-
|[[Wireless Modem|Wireless Modem (old recipe, changed in 1.5)]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=redstone_torch |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Modem
}}
|-
|[[Disk Drive]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=Redstone |C3=Stone
|Output=Disk_Drive
}}
|-
|[[Floppy Disk]]
|{{Crafting grid
|B1=Redstone
|B2=paper
|Output=disk
}}
|-
|[[Turtle]] (and see [[Turtle#Recipes|Turtle recipes]])
|{{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
}}
|-
|[[Monitor]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=glass_pane |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Monitor
}}
|-
|[[Printer]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=Ink_Sac |C3=Stone
|Output=printer
}}
|-
|[[Advanced Computer]]
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Redstone |C2=Gold_Ingot
|A3=Gold_Ingot |B3=glass_pane |C3=Gold_Ingot
|Output=Advanced_Computer
}}
|-
|[[Advanced Monitor]]
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=glass_pane |C2=Gold_Ingot
|A3=Gold_Ingot |B3=Gold_Ingot |C3=Gold_Ingot
|Output=Advanced_Monitor |OA=4
}}
|}
[[Category:Lists]]

Talk:Turtle (API)

2013-03-29T08:23:37Z

Viproz: /* Syntax Page */ Damn it i typed 3 times wrong

Is there a way to detect a block's type? Preferably without picking it up; it would be nice to be able to write a function to check the block about to be broken against a list of "Do not break" blocks, such as Industrial craft's MFSU, which loses all held power when picked up.

Also I request a way to set server-wide list of blocks immune to the turtle.dig() functions, such as say personal safes (Industrial Craft again).— Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:50.131.199.48|50.131.199.48]] ([[User talk:50.131.199.48|talk]] • [[Special:Contributions/50.131.199.48|contribs]]) 
:As far as I know, there's no way to check the block type with the current API. Could be a feature in the future though, never know. {{User:Scarfacial/Signature|22:17 - 8 March 2012}}
::Would be interesting to see if one could write a function for that. {{User:Banane9/Signature|22:43 - 9 March 2012}}
:::i would see it too please. But i dont think that you can make that in a function
:::[[User:Dude|Dude]] 22:13, 9 March 2012 (UTC)
::::You can determine if the block matches the one in its inventory using turtle.select(slot) and then turtle.compare() or turtle.compareUp() or turtle.compareDown()

== turtle collect ? ==

i understand that the turtle can drop items from its inventory with turtle.drop( [amount] )
but is there a way to make the turtle collect items (like a player would do) around and store it in inventory ?
(from what i understand right now the turtle collects items taken from a digged block ?
thanks
:Nope they don't collect items that are already dropped --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
:Now in 1.4 there is the [[turtle.suck|turtle.suck()]] function --[[User:Dadmob18|Dadmob18]] 12:22, 27 Sep 2012 (UTC)

== treefarm ==

i have write a big programm (120 lines) that destory the tree full (with the leaves) when the tree is grown. so the turtle can plant an new tree an beginn at the start. My problem: the programm dont work and i cant find the faults... — Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:Dude|Dude]] ([[User talk:Dude|talk]] • [[Special:Contributions/Dude|contribs]]) 
:Maybe because the leaves of the tree decay and that f*cks up the code? We cant help you without seeing your code ;) --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
::On a similar note, I have written a disassembler script which (mostly) disassembles arbitrary things from the top down, but it really gets messed up by doors and other turtles and pistons, it is basically because interacting with blocks only works well if the blocks don't change while you are trying to deal with them/use them for navigating.

== Turtle API to detect block/item ID? ==

I have a suggestion, what if you have a function like: turtle.getBlockID() which would return ID, damage value, or simmilar
:Dan doesn't want Block IDs as they'd break the 4th wall. --[[User:Pinkishu|Pinkishu]] 13:12, 16 August 2012 (CEST)
BlockIDs? Breaking the 4th wall? Weird, but fine. How about returning strings? "Wood", "Diamond", "Whatever"

== More than 1 mover per turtle.up() ==

is there a way to make a turtle go up more than once for each turtle.up() ? like maybe turtle.up(36) (i tried that but it said attempt to call nil)

You could use:
<pre>
turtleold = turtle.up
function turtlenew(times)
for i=1,times do
turtle.up()
end
end
turtle.up = turtlenew
</pre>
Then just use turtle.up(5) and stuff, because it overrides the function.

If you want to make sure, the turtle wasn't blocked, you should add a return value. I'd also recommend sticking close to the regular interface, if you replace turtle.up().
To keep most regular uses working, maybe something like:
<pre>
turtle.up = function(times)
for i=1,times do
if not turtle.up() then
return false, i
end
end
return true, times
end
ok, moves = turtle.up(5)
if not ok then
-- check for obstacles or fuel shortage etc.
end
</pre>

Can you tell the turtle to drop/not pick up unwanted items like dirt, cobble, sand and gravel?

== Detecting Fluids ==

It seems as though water or lava aren't considered as blocks, and I was wondering if it would be possible to make it possible to detect a fluid but not directly, something like a fluid temperature attachment, and
with that you could distinguish between water, lava and air and perhaps fire. As i said nothing too easy like a function that spits out a string like "water" or "lava" or "air". Just something that allows the programmer to make functions that can come to those conclusions.

--[[User:Sand|Sand]] 00:46, 7 October 2012 (EDT)

I have also just realized that if there is going to be a way to detect fluids, there will need to be a way to pick them up/ place them as well.

==Anything==

Whenever I try to do anything with a turtle, it says "No such program", and normally I am good at programming. How do I do even the simplest things with these turtles?

Please post this on the forums. It's easier to reply there. --[[User:Thesbros|Thesbros]] 17:25, 21 October 2012 (EDT)

== Fighting game ==

Check out http://en.wikipedia.org/wiki/Crobots Just adding a ranged detect() that see's mobs and other turtles and we have crobot fighting games in minecraft :-D

== Syntax Page ==

Shouldn't we use this syntax of table for all the others tables ? I think it's nice and clear ! [[User:Viproz|Viproz]] 12:22, 29 March 2013 (MSK)

(change pages like this one : [[Paintutils_(API)]])

Talk:Turtle (API)

2013-03-29T08:23:01Z

Viproz:

Talk:Turtle (API)

2013-03-29T08:22:19Z

Viproz: Nice syntax question

Is there a way to detect a block's type? Preferably without picking it up; it would be nice to be able to write a function to check the block about to be broken against a list of "Do not break" blocks, such as Industrial craft's MFSU, which loses all held power when picked up.

Also I request a way to set server-wide list of blocks immune to the turtle.dig() functions, such as say personal safes (Industrial Craft again).— Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:50.131.199.48|50.131.199.48]] ([[User talk:50.131.199.48|talk]] • [[Special:Contributions/50.131.199.48|contribs]]) 
:As far as I know, there's no way to check the block type with the current API. Could be a feature in the future though, never know. {{User:Scarfacial/Signature|22:17 - 8 March 2012}}
::Would be interesting to see if one could write a function for that. {{User:Banane9/Signature|22:43 - 9 March 2012}}
:::i would see it too please. But i dont think that you can make that in a function
:::[[User:Dude|Dude]] 22:13, 9 March 2012 (UTC)
::::You can determine if the block matches the one in its inventory using turtle.select(slot) and then turtle.compare() or turtle.compareUp() or turtle.compareDown()

== turtle collect ? ==

i understand that the turtle can drop items from its inventory with turtle.drop( [amount] )
but is there a way to make the turtle collect items (like a player would do) around and store it in inventory ?
(from what i understand right now the turtle collects items taken from a digged block ?
thanks
:Nope they don't collect items that are already dropped --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
:Now in 1.4 there is the [[turtle.suck|turtle.suck()]] function --[[User:Dadmob18|Dadmob18]] 12:22, 27 Sep 2012 (UTC)

== treefarm ==

i have write a big programm (120 lines) that destory the tree full (with the leaves) when the tree is grown. so the turtle can plant an new tree an beginn at the start. My problem: the programm dont work and i cant find the faults... — Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:Dude|Dude]] ([[User talk:Dude|talk]] • [[Special:Contributions/Dude|contribs]]) 
:Maybe because the leaves of the tree decay and that f*cks up the code? We cant help you without seeing your code ;) --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
::On a similar note, I have written a disassembler script which (mostly) disassembles arbitrary things from the top down, but it really gets messed up by doors and other turtles and pistons, it is basically because interacting with blocks only works well if the blocks don't change while you are trying to deal with them/use them for navigating.

== Turtle API to detect block/item ID? ==

I have a suggestion, what if you have a function like: turtle.getBlockID() which would return ID, damage value, or simmilar
:Dan doesn't want Block IDs as they'd break the 4th wall. --[[User:Pinkishu|Pinkishu]] 13:12, 16 August 2012 (CEST)
BlockIDs? Breaking the 4th wall? Weird, but fine. How about returning strings? "Wood", "Diamond", "Whatever"

== More than 1 mover per turtle.up() ==

is there a way to make a turtle go up more than once for each turtle.up() ? like maybe turtle.up(36) (i tried that but it said attempt to call nil)

You could use:
<pre>
turtleold = turtle.up
function turtlenew(times)
for i=1,times do
turtle.up()
end
end
turtle.up = turtlenew
</pre>
Then just use turtle.up(5) and stuff, because it overrides the function.

If you want to make sure, the turtle wasn't blocked, you should add a return value. I'd also recommend sticking close to the regular interface, if you replace turtle.up().
To keep most regular uses working, maybe something like:
<pre>
turtle.up = function(times)
for i=1,times do
if not turtle.up() then
return false, i
end
end
return true, times
end
ok, moves = turtle.up(5)
if not ok then
-- check for obstacles or fuel shortage etc.
end
</pre>

Can you tell the turtle to drop/not pick up unwanted items like dirt, cobble, sand and gravel?

== Detecting Fluids ==

It seems as though water or lava aren't considered as blocks, and I was wondering if it would be possible to make it possible to detect a fluid but not directly, something like a fluid temperature attachment, and
with that you could distinguish between water, lava and air and perhaps fire. As i said nothing too easy like a function that spits out a string like "water" or "lava" or "air". Just something that allows the programmer to make functions that can come to those conclusions.

--[[User:Sand|Sand]] 00:46, 7 October 2012 (EDT)

I have also just realized that if there is going to be a way to detect fluids, there will need to be a way to pick them up/ place them as well.

==Anything==

Whenever I try to do anything with a turtle, it says "No such program", and normally I am good at programming. How do I do even the simplest things with these turtles?

Please post this on the forums. It's easier to reply there. --[[User:Thesbros|Thesbros]] 17:25, 21 October 2012 (EDT)

== Fighting game ==

Check out http://en.wikipedia.org/wiki/Crobots Just adding a ranged detect() that see's mobs and other turtles and we have crobot fighting games in minecraft :-D

== Syntax Page ==

Shouldn't we use this syntax of table for all the others tables ? I think it's nice and clear ! [[User:Viproz|Viproz]] 12:22, 29 March 2013 (MSK)
(change pages like this one : [[Paintutils_(API]]))

Talk:Turtle (API)

2013-03-29T08:21:08Z

Viproz: Nice syntax question

Paintutils.drawPixel

2013-03-29T08:17:53Z

Viproz: BTW need someone to test what it returns

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

[[Category:API_Functions]]

Paintutils.drawPixel

2013-03-29T08:14:50Z

Viproz: edit the links to the apis

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

[[Category:API_Functions]]

Paintutils.drawPixel

2013-03-29T08:13:04Z

Viproz: Created page with "{{lowercase}} {{Function |name=paintutils.drawPixel |args=int x, int y, colour colour |api=paintutils |returns=To complete ..."

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

[[Category:API_Functions]]

User:Viproz

2013-03-24T21:56:43Z

Viproz: Created page with "Hi I'm Viproz, I'm french ! I know C/C++ and enough lua to use it with CC, I like this mod, with it we can do whatever we want !"

Hi I'm Viproz, I'm french !

I know C/C++ and enough lua to use it with CC, I like this mod, with it we can do whatever we want !

Template talk:Version

2013-03-24T21:48:24Z

Viproz: sign my comment

With the new MCPC+, i think we can remove the bukkit version, Can't we ?
[[User:Viproz|Viproz]] 01:48, 25 March 2013 (MSK) (edit)

Theoretically, yes - I'd check with Cloudy, as he was porting. Remember to sign your comments with <nowiki>~~~~</nowiki> (four tildes). ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:16, 24 March 2013 (MSK)''

Template talk:Version

2013-03-24T12:14:08Z

Viproz: about bukkit

With the new MCPC+, i think we can remove the bukkit version, Can't we ?

Template:Version

2013-03-24T12:12:04Z

Viproz: just change the version

<table style="width:100%">
<tr>
<td style="width:100px;">[[File:Icon_Minecraft.png]]  Minecraft:</td>
<td>ComputerCraft '''1.51''' for '''Minecraft 1.5'''</td>
</tr>
<tr>
<td style="width:100px;">[[File:Icon_Bukkit.png]]  Bukkit:</td>
<td>ComputerCraft '''1.41''' for '''MCPC Build 177+'''</td>
</tr>
</table>
<center>'''[[Changelog]]'''</center>

Template:Version

2013-03-24T12:10:50Z

Viproz: just change the version

<table style="width:100%">
<tr>
<td style="width:100px;">[[File:Icon_Minecraft.png]]  Minecraft:</td>
<td>ComputerCraft '''1.5'1'' for '''Minecraft 1.5'''</td>
</tr>
<tr>
<td style="width:100px;">[[File:Icon_Bukkit.png]]  Bukkit:</td>
<td>ComputerCraft '''1.41''' for '''MCPC Build 177+'''</td>
</tr>
</table>
<center>'''[[Changelog]]'''</center>

Talk:Advanced Monitor

2013-03-10T02:39:12Z

Viproz: Need some help to change the recipe.

== Recipe ==
I can't change the number of production of the recipe, it's not working like on ic2 forums. Does anyone know how to change it ?

== Exclusive Functions Section ==
I don't think the "exclusive functions" section is necessary. The notes in the peripheral functions table seems to cover that quite well enough.
     Agreed; it'll be removed now (if not, on my next pass). Anonymous wiki contributor; if you could sign your posts using four tildes (<nowiki>~~~~</nowiki>), it helps me track comments + suggestions. Thanks. ''[[User:AfterLifeLochie|AfterLifeLochie]] 23:16, 29 November 2012 (MSK)''

Template:Changelog

2013-02-22T06:03:36Z

Viproz: forget the modem link

{| class="wikitable sortable" style="width: 100%"
! style="width: 15%" | Version
! class="unsortable" | New Features or Changes
! style="width: 15%" | Minecraft Version
|-
|align=center|[http://www.computercraft.info/2013/02/11/computercraft-1-5/ Computercraft 1.5]
|
*Redesigned Wireless Modems; they can now send and receive on multiple channels, independent of the computer ID. To use these features, interface with modem peripherals directly. The rednet API still functions as before.
*[[Floppy Disk|Floppy Disks]] can now be dyed with multiple dyes, just like armour.
*The “excavate” program now retains fuel in it’s inventory, so can run unattended.
*[[turtle.place]]() now tries all possible block orientations before failing.
*[[turtle.refuel]](0) returns true if a fuel item is selected.
*[[turtle.craft]](0) returns true if the inventory is a valid recipe.
*The in-game help system now has documentation for all the peripherals and their methods, including the new [[modem]] functionality.
*A romantic surprise.
|align=center|1.4.7
|-
|align=center|[http://www.computercraft.info/2012/12/27/computercraft-1-481-miscperipherals-fix/ Computercraft 1.481]
|
*Fixed compatibility bug with MiscPeripherals.
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/12/23/computercraft-1-48/ Computercraft 1.48]
|
*Ported to Minecraft 1.4.6
*[[Advanced Monitor|Advanced Monitors]] can now be used as touchscreens
*[[Advanced Monitor|Advanced Monitors]] are now easier to craft
*[[Turtle|Turtles]] now get slightly less movement from fuel
*[[Turtle|Turtles]] can now push items
*[[Computer|Computers]] can now control Command Blocks, if enabled in the config
*New API function: os.day()
*A Christmas surprise
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/11/15/computercraft-1-47-and-minecon-news/ ComputerCraft 1.47]
|
*Ported to Minecraft 1.4.4
*Fixed label tooltips not showing up in SMP
|align=center|1.4.4
|-
|align=center|[http://www.computercraft.info/2012/10/25/computercraft-1-46-minecraft-update/ ComputerCraft 1.46]
|
*Ported to Minecraft 1.4.2
*ComputerCraft items now have their own tab in Creative Mode
|align=center|1.4.2
|-
|align=center|[http://www.computercraft.info/2012/10/22/computercraft-1-45-now-with-colors/ ComputerCraft 1.45]
|
*Added [[Advanced Computer|Advanced Computers]]
*Added [[Advanced Monitor|Advanced Monitors]]
*New program: paint (by nitrogenfingers)
*New API: [[paintutils_(API)|paintutils]]
*New term functions: term.setBackgroundColor, term.setTextColor, term.isColor
*New [[Turtle|Turtle]] function: [[turtle.transferTo]]
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/10/04/computercraft-1-43-books/ ComputerCraft 1.43]
|
*Added Printed Pages (bind several Printed Page items into one with string)
*Added Printed Books (add a leather cover to the above)
*Labelled [[Turtle|Turtles]] now keep their fuel when broken
*Fixed incompatibility with Forge 275 and above
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/09/22/computercraft-1-42-is-released/ ComputerCraft 1.42]
|
*Ported to Minecraft 1.3.2 and the Forge mod system
*Added [[Printer|Printers]]
*Floppy Disks can now be dyed different colours
*Wireless Crafty Turtles can now be crafted
*All new textures
*New Forge config file
*Various tweaks and bug fixes
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/07/29/computercraft-1-41-bugfix-update/ ComputerCraft 1.41]
|
*Fixed labelled [[Computer|Computers]] not keeping their data when destroyed
*Fixed the “excavate” program outputting lots of spam
*File system size limits now take into account empty files and directories
*Some small changes to the Turtle Upgrade API ahead of it’s impending release.(Update: The API has now been released)
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/07/27/computercraft-1-4-is-released/ ComputerCraft 1.4]
|
*Ported to Forge Mod Loader: ComputerCraft can now be ran directly from the .zip without extraction
*Added Farming [[Turtle|Turtles]], Felling [[Turtle|Turtles]], Digging [[Turtle|Turtles]], Melee [[Turtle|Turtles]] and Crafty [[Turtle|Turtles]]
*Added 14 new[[Turtle|Turtles]] Combinations accessible by combining the turtle upgrades above
*Labelled [[Computer|Computers]] and turtles can now be crafted into turtles or other turtle types without losing their ID, label and data
*Added a [[Turtle|Turtles]] Upgrade API” for mod developers to create their own tools and peripherals for turtles
*[[Turtle|Turtles]] can now attack entities with [[turtle.attack]](), and collect their dropped items
*[[Turtle|Turtles]] can now use [[turtle.place]]() with any item the player can, and can interact with entities
*[[Turtle|Turtles]] can now craft items with [[turtle.craft]]()
*[[Turtle|Turtles]] can now place items into inventories with [[turtle.drop]]()
*Changed the behaviour of [[turtle.place]]() and [[turtle.drop]]() to only consider the currently selected slot
*[[Turtle|Turtles]] can now pick up items from the ground, or from inventories, with [[turtle.suck]]()
*[[Turtle|Turtles]] can now compare items in their inventories
*[[Turtle|Turtles]] can place signs with text on them with [[turtle.place]]( [signText] )
*[[Turtle|Turtles]] now optionally require fuel items to move, and can refuel themselves
*The size of the the [[Turtle|Turtle]] inventory has been increased to 16
*The size of the [[Turtle|Turtle]] screen has been increased
*New [[Turtle|Turtle]] functions: [[turtle.compareTo]]( [slotNum] ), [[turtle.craft]](), [[turtle.attack]](), [[turtle.attackUp]](), [[turtle.attackDown]](), [[turtle.drop|turtle.dropUp]](), [[turtle.drop|turtle.dropDown]](), [[turtle.getFuelLevel]](), [[turtle.refuel]]()
*New [[Disk]] function: [[disk.getDiskID]]()
*New [[Turtle|Turtle]] programs: craft, refuel
*“excavate” program now much smarter: Will return items to a chest when full, attack mobs, and refuel itself automatically
*New API: keys
*Added optional Floppy Disk and Hard Drive space limits for [[Computer|Computers]] and [[Turtle|Turtles]]
*New fs function: [[fs.getFreeSpace]]( path ), also [[fs.getDrive]]() works again
*The send and receive range of wireless modems now increases with altitude, allowing long range networking from high-altitude [[Computer|Computers]] (great for GPS networks)
*[[http.request]]() now supports https:// URLs
*Right clicking a [[Disk Drive]] with a [[Floppy Disk]] or a Record when sneaking will insert the item into the [[Disk Drive]] automatically
*The default size of the [[Computer]] screen has been increased
*Several stability and security fixes: LuaJ can now no longer leave dangling threads when a computer is unloaded, turtles can no longer be destroyed by tree leaves or walking off the edge of the loaded map. [[Computer|Computers]] no longer crash when used with RedPower frames
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/04/23/computercraft-updated-to-1-2-5/ ComputerCraft 1.33]
|
*Ported to Minecraft 1.2.5
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/03/30/computercraft-1-32-out-now/ ComputerCraft 1.32]
|
*Ported to Minecraft 1.2.4
*Fixed a big memory leak in LuaJ that caused extra threads to stay around forever when [[Computer|Computers]] were shut down.
|align=center|1.2.4
|-
|align=center|[http://www.computercraft.info/2012/03/13/computercraft-1-31-is-released/ ComputerCraft 1.31]
|
*Ported to Minecraft 1.2.3
*Added [[Monitor|Monitors]] (thanks to Cloudy). Build huge external displays for your [[Computer|Computers]]!
*New positioning capabilities for [[Computer|Computers]] and [[Turtle|Turtles]]. Build GPS networks and triangulate the positions of your turtles position so they never get lost!
*New [[turtle.compare]]() function for turtles for more intelligent mining.
*New programs and APIs: gps, monitor, vector
*New program: pastebin (requires enableAPI_HTTP=1 in mod_ComputerCraft.cfg), upload and download programs made by other users ingame!
*Added a new top secret program designed for use with Monitors, see if you can find it.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.2.3
|-
|align=center|[http://www.computercraft.info/2012/02/23/computercraft-1-3-trailer/ ComputerCraft 1.3]
|
*Ported to Minecraft Forge.
*Added [[Turtle|Turtles]], Mining [[Turtle|Turtles]], Wireless [[Turtle|Turtles]] and Wireless Mining [[Turtle|Turtles]] (Block ID 209).
*Added a Peripheral API to allow mod developers to create custom peripherals for ComputerCraft. Details on this will be posted in the next few days.
*Added [[Modem|Wireless Modems]]. Use the [[Rednet_(API)|rednet API]] to send data wirelessly between [[Computer|Computers]] and [[Turtle|Turtles]]!
*[[Computer|Computers]] and Disk Drives no longer get destroyed by water.
*[[Computer|Computers]] and [[Turtle|Turtles]] can now be labelled, destroyed, and moved around, keeping their state.
*[[Computer|Computers]] and [[Turtle|Turtles]] can connect to adjacent devices, and turn them on or off.
*User programs now give line numbers in their error messages, for easier debugging.
*New APIs and programs for [[Turtle|Turtles]]: turtle, excavate, tunnel, go, turn and dance.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.1
|-
|align=center|ComputerCraft 1.21
|
*Added shortcut key to shutdown the computer.
*Added a help API add-on pack.
*Various bug fixes.
|align=center|1.1
|-
|align=center|ComputerCraft 1.2
|
*Added Disk Drives
*Added shortcut keys to terminate the current program and reboot the computer.
*Added a new system for user created APIs.
*Added RedNet.
*Added [[shell.setPath]]() and [[shell.setAlias]]().
*Added a new ROM startup script.
*Added [[os.clock]](), [[os.time]](), and [[os.setAlarm]]().
*Added game: "Worm!"
*Added programs: alias, apis, copy, delete, dj, drive, eject, id, label, list, move, reboot, redset, rename, time, worm.
*Added APIs: bit, colours, disk, help, rednet, parallel, textutils
*Text can be edited with left and right arrow keys.
*Many bug fixes
|align=center|1.0
|-
|align=center|ComputerCraft 1.11
|
*Fixed bug where [[Computer|Computers]] could not read input from RedPower cables which had a bend in the immediately adjacent square.
|align=center|1.0
|-
|align=center|ComputerCraft 1.1
|
*Changed the default block ID for the [[Computer|Computer]] to 207.
*Added multiplayer support.
*Added connectivity with RedPower bundled cables.
*Added HTTP API
*Fixed support for HD textures on the front of [[Computer|Computers]].
*Added command history to the [[Computer]].
*Added config options to change the size of the [[Computer]] GUI and the text color.
*Programs with infinite loops that don't yield will no longer freeze Minecraft and will terminate after 10 seconds.
*Extended Help and fixed typos/small errors in various programs.
|align=center|1.0
|-
|align=center|ComputerCraft 1.02
|
*Fixed the MCPatcher HD textures incompatibility that was causing the computer texture to replace cobblestone blocks.
|align=center|1.0
|-
|align=center|ComputerCraft 1.01
|
*Added a ModLoader configuration file, so the computers block ID can be changed.
*Made the error message that displays when Lua files are not correctly installed much more clear, no more "Assertion failed."
|align=center|1.0
|-
|align=center|ComputerCraft 1.0
|
*First Release
|align=center|1.0
|}

Template:Changelog

2013-02-22T06:02:30Z

Viproz: add links to functions

{| class="wikitable sortable" style="width: 100%"
! style="width: 15%" | Version
! class="unsortable" | New Features or Changes
! style="width: 15%" | Minecraft Version
|-
|align=center|[http://www.computercraft.info/2013/02/11/computercraft-1-5/ Computercraft 1.5]
|
*Redesigned Wireless Modems; they can now send and receive on multiple channels, independent of the computer ID. To use these features, interface with modem peripherals directly. The rednet API still functions as before.
*[[Floppy Disk|Floppy Disks]] can now be dyed with multiple dyes, just like armour.
*The “excavate” program now retains fuel in it’s inventory, so can run unattended.
*[[turtle.place]]() now tries all possible block orientations before failing.
*[[turtle.refuel]](0) returns true if a fuel item is selected.
*[[turtle.craft]](0) returns true if the inventory is a valid recipe.
*The in-game help system now has documentation for all the peripherals and their methods, including the new modem functionality.
*A romantic surprise.
|align=center|1.4.7
|-
|align=center|[http://www.computercraft.info/2012/12/27/computercraft-1-481-miscperipherals-fix/ Computercraft 1.481]
|
*Fixed compatibility bug with MiscPeripherals.
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/12/23/computercraft-1-48/ Computercraft 1.48]
|
*Ported to Minecraft 1.4.6
*[[Advanced Monitor|Advanced Monitors]] can now be used as touchscreens
*[[Advanced Monitor|Advanced Monitors]] are now easier to craft
*[[Turtle|Turtles]] now get slightly less movement from fuel
*[[Turtle|Turtles]] can now push items
*[[Computer|Computers]] can now control Command Blocks, if enabled in the config
*New API function: os.day()
*A Christmas surprise
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/11/15/computercraft-1-47-and-minecon-news/ ComputerCraft 1.47]
|
*Ported to Minecraft 1.4.4
*Fixed label tooltips not showing up in SMP
|align=center|1.4.4
|-
|align=center|[http://www.computercraft.info/2012/10/25/computercraft-1-46-minecraft-update/ ComputerCraft 1.46]
|
*Ported to Minecraft 1.4.2
*ComputerCraft items now have their own tab in Creative Mode
|align=center|1.4.2
|-
|align=center|[http://www.computercraft.info/2012/10/22/computercraft-1-45-now-with-colors/ ComputerCraft 1.45]
|
*Added [[Advanced Computer|Advanced Computers]]
*Added [[Advanced Monitor|Advanced Monitors]]
*New program: paint (by nitrogenfingers)
*New API: [[paintutils_(API)|paintutils]]
*New term functions: term.setBackgroundColor, term.setTextColor, term.isColor
*New [[Turtle|Turtle]] function: [[turtle.transferTo]]
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/10/04/computercraft-1-43-books/ ComputerCraft 1.43]
|
*Added Printed Pages (bind several Printed Page items into one with string)
*Added Printed Books (add a leather cover to the above)
*Labelled [[Turtle|Turtles]] now keep their fuel when broken
*Fixed incompatibility with Forge 275 and above
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/09/22/computercraft-1-42-is-released/ ComputerCraft 1.42]
|
*Ported to Minecraft 1.3.2 and the Forge mod system
*Added [[Printer|Printers]]
*Floppy Disks can now be dyed different colours
*Wireless Crafty Turtles can now be crafted
*All new textures
*New Forge config file
*Various tweaks and bug fixes
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/07/29/computercraft-1-41-bugfix-update/ ComputerCraft 1.41]
|
*Fixed labelled [[Computer|Computers]] not keeping their data when destroyed
*Fixed the “excavate” program outputting lots of spam
*File system size limits now take into account empty files and directories
*Some small changes to the Turtle Upgrade API ahead of it’s impending release.(Update: The API has now been released)
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/07/27/computercraft-1-4-is-released/ ComputerCraft 1.4]
|
*Ported to Forge Mod Loader: ComputerCraft can now be ran directly from the .zip without extraction
*Added Farming [[Turtle|Turtles]], Felling [[Turtle|Turtles]], Digging [[Turtle|Turtles]], Melee [[Turtle|Turtles]] and Crafty [[Turtle|Turtles]]
*Added 14 new[[Turtle|Turtles]] Combinations accessible by combining the turtle upgrades above
*Labelled [[Computer|Computers]] and turtles can now be crafted into turtles or other turtle types without losing their ID, label and data
*Added a [[Turtle|Turtles]] Upgrade API” for mod developers to create their own tools and peripherals for turtles
*[[Turtle|Turtles]] can now attack entities with [[turtle.attack]](), and collect their dropped items
*[[Turtle|Turtles]] can now use [[turtle.place]]() with any item the player can, and can interact with entities
*[[Turtle|Turtles]] can now craft items with [[turtle.craft]]()
*[[Turtle|Turtles]] can now place items into inventories with [[turtle.drop]]()
*Changed the behaviour of [[turtle.place]]() and [[turtle.drop]]() to only consider the currently selected slot
*[[Turtle|Turtles]] can now pick up items from the ground, or from inventories, with [[turtle.suck]]()
*[[Turtle|Turtles]] can now compare items in their inventories
*[[Turtle|Turtles]] can place signs with text on them with [[turtle.place]]( [signText] )
*[[Turtle|Turtles]] now optionally require fuel items to move, and can refuel themselves
*The size of the the [[Turtle|Turtle]] inventory has been increased to 16
*The size of the [[Turtle|Turtle]] screen has been increased
*New [[Turtle|Turtle]] functions: [[turtle.compareTo]]( [slotNum] ), [[turtle.craft]](), [[turtle.attack]](), [[turtle.attackUp]](), [[turtle.attackDown]](), [[turtle.drop|turtle.dropUp]](), [[turtle.drop|turtle.dropDown]](), [[turtle.getFuelLevel]](), [[turtle.refuel]]()
*New [[Disk]] function: [[disk.getDiskID]]()
*New [[Turtle|Turtle]] programs: craft, refuel
*“excavate” program now much smarter: Will return items to a chest when full, attack mobs, and refuel itself automatically
*New API: keys
*Added optional Floppy Disk and Hard Drive space limits for [[Computer|Computers]] and [[Turtle|Turtles]]
*New fs function: [[fs.getFreeSpace]]( path ), also [[fs.getDrive]]() works again
*The send and receive range of wireless modems now increases with altitude, allowing long range networking from high-altitude [[Computer|Computers]] (great for GPS networks)
*[[http.request]]() now supports https:// URLs
*Right clicking a [[Disk Drive]] with a [[Floppy Disk]] or a Record when sneaking will insert the item into the [[Disk Drive]] automatically
*The default size of the [[Computer]] screen has been increased
*Several stability and security fixes: LuaJ can now no longer leave dangling threads when a computer is unloaded, turtles can no longer be destroyed by tree leaves or walking off the edge of the loaded map. [[Computer|Computers]] no longer crash when used with RedPower frames
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/04/23/computercraft-updated-to-1-2-5/ ComputerCraft 1.33]
|
*Ported to Minecraft 1.2.5
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/03/30/computercraft-1-32-out-now/ ComputerCraft 1.32]
|
*Ported to Minecraft 1.2.4
*Fixed a big memory leak in LuaJ that caused extra threads to stay around forever when [[Computer|Computers]] were shut down.
|align=center|1.2.4
|-
|align=center|[http://www.computercraft.info/2012/03/13/computercraft-1-31-is-released/ ComputerCraft 1.31]
|
*Ported to Minecraft 1.2.3
*Added [[Monitor|Monitors]] (thanks to Cloudy). Build huge external displays for your [[Computer|Computers]]!
*New positioning capabilities for [[Computer|Computers]] and [[Turtle|Turtles]]. Build GPS networks and triangulate the positions of your turtles position so they never get lost!
*New [[turtle.compare]]() function for turtles for more intelligent mining.
*New programs and APIs: gps, monitor, vector
*New program: pastebin (requires enableAPI_HTTP=1 in mod_ComputerCraft.cfg), upload and download programs made by other users ingame!
*Added a new top secret program designed for use with Monitors, see if you can find it.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.2.3
|-
|align=center|[http://www.computercraft.info/2012/02/23/computercraft-1-3-trailer/ ComputerCraft 1.3]
|
*Ported to Minecraft Forge.
*Added [[Turtle|Turtles]], Mining [[Turtle|Turtles]], Wireless [[Turtle|Turtles]] and Wireless Mining [[Turtle|Turtles]] (Block ID 209).
*Added a Peripheral API to allow mod developers to create custom peripherals for ComputerCraft. Details on this will be posted in the next few days.
*Added [[Modem|Wireless Modems]]. Use the [[Rednet_(API)|rednet API]] to send data wirelessly between [[Computer|Computers]] and [[Turtle|Turtles]]!
*[[Computer|Computers]] and Disk Drives no longer get destroyed by water.
*[[Computer|Computers]] and [[Turtle|Turtles]] can now be labelled, destroyed, and moved around, keeping their state.
*[[Computer|Computers]] and [[Turtle|Turtles]] can connect to adjacent devices, and turn them on or off.
*User programs now give line numbers in their error messages, for easier debugging.
*New APIs and programs for [[Turtle|Turtles]]: turtle, excavate, tunnel, go, turn and dance.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.1
|-
|align=center|ComputerCraft 1.21
|
*Added shortcut key to shutdown the computer.
*Added a help API add-on pack.
*Various bug fixes.
|align=center|1.1
|-
|align=center|ComputerCraft 1.2
|
*Added Disk Drives
*Added shortcut keys to terminate the current program and reboot the computer.
*Added a new system for user created APIs.
*Added RedNet.
*Added [[shell.setPath]]() and [[shell.setAlias]]().
*Added a new ROM startup script.
*Added [[os.clock]](), [[os.time]](), and [[os.setAlarm]]().
*Added game: "Worm!"
*Added programs: alias, apis, copy, delete, dj, drive, eject, id, label, list, move, reboot, redset, rename, time, worm.
*Added APIs: bit, colours, disk, help, rednet, parallel, textutils
*Text can be edited with left and right arrow keys.
*Many bug fixes
|align=center|1.0
|-
|align=center|ComputerCraft 1.11
|
*Fixed bug where [[Computer|Computers]] could not read input from RedPower cables which had a bend in the immediately adjacent square.
|align=center|1.0
|-
|align=center|ComputerCraft 1.1
|
*Changed the default block ID for the [[Computer|Computer]] to 207.
*Added multiplayer support.
*Added connectivity with RedPower bundled cables.
*Added HTTP API
*Fixed support for HD textures on the front of [[Computer|Computers]].
*Added command history to the [[Computer]].
*Added config options to change the size of the [[Computer]] GUI and the text color.
*Programs with infinite loops that don't yield will no longer freeze Minecraft and will terminate after 10 seconds.
*Extended Help and fixed typos/small errors in various programs.
|align=center|1.0
|-
|align=center|ComputerCraft 1.02
|
*Fixed the MCPatcher HD textures incompatibility that was causing the computer texture to replace cobblestone blocks.
|align=center|1.0
|-
|align=center|ComputerCraft 1.01
|
*Added a ModLoader configuration file, so the computers block ID can be changed.
*Made the error message that displays when Lua files are not correctly installed much more clear, no more "Assertion failed."
|align=center|1.0
|-
|align=center|ComputerCraft 1.0
|
*First Release
|align=center|1.0
|}

Template:Version

2013-02-22T05:58:58Z

Viproz: Edit version number

<table style="width:100%">
<tr>
<td style="width:100px;">[[File:Icon_Minecraft.png]]  Minecraft:</td>
<td>ComputerCraft '''1.5''' for '''Minecraft 1.4.7 & 1.4.6'''</td>
</tr>
<tr>
<td style="width:100px;">[[File:Icon_Bukkit.png]]  Bukkit:</td>
<td>ComputerCraft '''1.41''' for '''MCPC Build 177+'''</td>
</tr>
</table>
<center>'''[[Changelog]]'''</center>

Template:Changelog

2013-02-22T05:56:19Z

Viproz: Add version 1.5

{| class="wikitable sortable" style="width: 100%"
! style="width: 15%" | Version
! class="unsortable" | New Features or Changes
! style="width: 15%" | Minecraft Version
|-
|align=center|[http://www.computercraft.info/2013/02/11/computercraft-1-5/ Computercraft 1.5]
|
*Redesigned Wireless Modems; they can now send and receive on multiple channels, independent of the computer ID. To use these features, interface with modem peripherals directly. The rednet API still functions as before.
*Floppy Disks can now be dyed with multiple dyes, just like armour.
*The “excavate” program now retains fuel in it’s inventory, so can run unattended.
*turtle.place() now tries all possible block orientations before failing.
*turtle.refuel(0) returns true if a fuel item is selected.
*turtle.craft(0) returns true if the inventory is a valid recipe.
*The in-game help system now has documentation for all the peripherals and their methods, including the new modem functionality.
*A romantic surprise.
|align=center|1.4.7
|-
|align=center|[http://www.computercraft.info/2012/12/27/computercraft-1-481-miscperipherals-fix/ Computercraft 1.481]
|
*Fixed compatibility bug with MiscPeripherals.
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/12/23/computercraft-1-48/ Computercraft 1.48]
|
*Ported to Minecraft 1.4.6
*[[Advanced Monitor|Advanced Monitors]] can now be used as touchscreens
*[[Advanced Monitor|Advanced Monitors]] are now easier to craft
*[[Turtle|Turtles]] now get slightly less movement from fuel
*[[Turtle|Turtles]] can now push items
*[[Computer|Computers]] can now control Command Blocks, if enabled in the config
*New API function: os.day()
*A Christmas surprise
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/11/15/computercraft-1-47-and-minecon-news/ ComputerCraft 1.47]
|
*Ported to Minecraft 1.4.4
*Fixed label tooltips not showing up in SMP
|align=center|1.4.4
|-
|align=center|[http://www.computercraft.info/2012/10/25/computercraft-1-46-minecraft-update/ ComputerCraft 1.46]
|
*Ported to Minecraft 1.4.2
*ComputerCraft items now have their own tab in Creative Mode
|align=center|1.4.2
|-
|align=center|[http://www.computercraft.info/2012/10/22/computercraft-1-45-now-with-colors/ ComputerCraft 1.45]
|
*Added [[Advanced Computer|Advanced Computers]]
*Added [[Advanced Monitor|Advanced Monitors]]
*New program: paint (by nitrogenfingers)
*New API: [[paintutils_(API)|paintutils]]
*New term functions: term.setBackgroundColor, term.setTextColor, term.isColor
*New [[Turtle|Turtle]] function: [[turtle.transferTo]]
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/10/04/computercraft-1-43-books/ ComputerCraft 1.43]
|
*Added Printed Pages (bind several Printed Page items into one with string)
*Added Printed Books (add a leather cover to the above)
*Labelled [[Turtle|Turtles]] now keep their fuel when broken
*Fixed incompatibility with Forge 275 and above
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/09/22/computercraft-1-42-is-released/ ComputerCraft 1.42]
|
*Ported to Minecraft 1.3.2 and the Forge mod system
*Added [[Printer|Printers]]
*Floppy Disks can now be dyed different colours
*Wireless Crafty Turtles can now be crafted
*All new textures
*New Forge config file
*Various tweaks and bug fixes
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/07/29/computercraft-1-41-bugfix-update/ ComputerCraft 1.41]
|
*Fixed labelled [[Computer|Computers]] not keeping their data when destroyed
*Fixed the “excavate” program outputting lots of spam
*File system size limits now take into account empty files and directories
*Some small changes to the Turtle Upgrade API ahead of it’s impending release.(Update: The API has now been released)
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/07/27/computercraft-1-4-is-released/ ComputerCraft 1.4]
|
*Ported to Forge Mod Loader: ComputerCraft can now be ran directly from the .zip without extraction
*Added Farming [[Turtle|Turtles]], Felling [[Turtle|Turtles]], Digging [[Turtle|Turtles]], Melee [[Turtle|Turtles]] and Crafty [[Turtle|Turtles]]
*Added 14 new[[Turtle|Turtles]] Combinations accessible by combining the turtle upgrades above
*Labelled [[Computer|Computers]] and turtles can now be crafted into turtles or other turtle types without losing their ID, label and data
*Added a [[Turtle|Turtles]] Upgrade API” for mod developers to create their own tools and peripherals for turtles
*[[Turtle|Turtles]] can now attack entities with [[turtle.attack]](), and collect their dropped items
*[[Turtle|Turtles]] can now use [[turtle.place]]() with any item the player can, and can interact with entities
*[[Turtle|Turtles]] can now craft items with [[turtle.craft]]()
*[[Turtle|Turtles]] can now place items into inventories with [[turtle.drop]]()
*Changed the behaviour of [[turtle.place]]() and [[turtle.drop]]() to only consider the currently selected slot
*[[Turtle|Turtles]] can now pick up items from the ground, or from inventories, with [[turtle.suck]]()
*[[Turtle|Turtles]] can now compare items in their inventories
*[[Turtle|Turtles]] can place signs with text on them with [[turtle.place]]( [signText] )
*[[Turtle|Turtles]] now optionally require fuel items to move, and can refuel themselves
*The size of the the [[Turtle|Turtle]] inventory has been increased to 16
*The size of the [[Turtle|Turtle]] screen has been increased
*New [[Turtle|Turtle]] functions: [[turtle.compareTo]]( [slotNum] ), [[turtle.craft]](), [[turtle.attack]](), [[turtle.attackUp]](), [[turtle.attackDown]](), [[turtle.drop|turtle.dropUp]](), [[turtle.drop|turtle.dropDown]](), [[turtle.getFuelLevel]](), [[turtle.refuel]]()
*New [[Disk]] function: [[disk.getDiskID]]()
*New [[Turtle|Turtle]] programs: craft, refuel
*“excavate” program now much smarter: Will return items to a chest when full, attack mobs, and refuel itself automatically
*New API: keys
*Added optional Floppy Disk and Hard Drive space limits for [[Computer|Computers]] and [[Turtle|Turtles]]
*New fs function: [[fs.getFreeSpace]]( path ), also [[fs.getDrive]]() works again
*The send and receive range of wireless modems now increases with altitude, allowing long range networking from high-altitude [[Computer|Computers]] (great for GPS networks)
*[[http.request]]() now supports https:// URLs
*Right clicking a [[Disk Drive]] with a [[Floppy Disk]] or a Record when sneaking will insert the item into the [[Disk Drive]] automatically
*The default size of the [[Computer]] screen has been increased
*Several stability and security fixes: LuaJ can now no longer leave dangling threads when a computer is unloaded, turtles can no longer be destroyed by tree leaves or walking off the edge of the loaded map. [[Computer|Computers]] no longer crash when used with RedPower frames
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/04/23/computercraft-updated-to-1-2-5/ ComputerCraft 1.33]
|
*Ported to Minecraft 1.2.5
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/03/30/computercraft-1-32-out-now/ ComputerCraft 1.32]
|
*Ported to Minecraft 1.2.4
*Fixed a big memory leak in LuaJ that caused extra threads to stay around forever when [[Computer|Computers]] were shut down.
|align=center|1.2.4
|-
|align=center|[http://www.computercraft.info/2012/03/13/computercraft-1-31-is-released/ ComputerCraft 1.31]
|
*Ported to Minecraft 1.2.3
*Added [[Monitor|Monitors]] (thanks to Cloudy). Build huge external displays for your [[Computer|Computers]]!
*New positioning capabilities for [[Computer|Computers]] and [[Turtle|Turtles]]. Build GPS networks and triangulate the positions of your turtles position so they never get lost!
*New [[turtle.compare]]() function for turtles for more intelligent mining.
*New programs and APIs: gps, monitor, vector
*New program: pastebin (requires enableAPI_HTTP=1 in mod_ComputerCraft.cfg), upload and download programs made by other users ingame!
*Added a new top secret program designed for use with Monitors, see if you can find it.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.2.3
|-
|align=center|[http://www.computercraft.info/2012/02/23/computercraft-1-3-trailer/ ComputerCraft 1.3]
|
*Ported to Minecraft Forge.
*Added [[Turtle|Turtles]], Mining [[Turtle|Turtles]], Wireless [[Turtle|Turtles]] and Wireless Mining [[Turtle|Turtles]] (Block ID 209).
*Added a Peripheral API to allow mod developers to create custom peripherals for ComputerCraft. Details on this will be posted in the next few days.
*Added [[Modem|Wireless Modems]]. Use the [[Rednet_(API)|rednet API]] to send data wirelessly between [[Computer|Computers]] and [[Turtle|Turtles]]!
*[[Computer|Computers]] and Disk Drives no longer get destroyed by water.
*[[Computer|Computers]] and [[Turtle|Turtles]] can now be labelled, destroyed, and moved around, keeping their state.
*[[Computer|Computers]] and [[Turtle|Turtles]] can connect to adjacent devices, and turn them on or off.
*User programs now give line numbers in their error messages, for easier debugging.
*New APIs and programs for [[Turtle|Turtles]]: turtle, excavate, tunnel, go, turn and dance.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.1
|-
|align=center|ComputerCraft 1.21
|
*Added shortcut key to shutdown the computer.
*Added a help API add-on pack.
*Various bug fixes.
|align=center|1.1
|-
|align=center|ComputerCraft 1.2
|
*Added Disk Drives
*Added shortcut keys to terminate the current program and reboot the computer.
*Added a new system for user created APIs.
*Added RedNet.
*Added [[shell.setPath]]() and [[shell.setAlias]]().
*Added a new ROM startup script.
*Added [[os.clock]](), [[os.time]](), and [[os.setAlarm]]().
*Added game: "Worm!"
*Added programs: alias, apis, copy, delete, dj, drive, eject, id, label, list, move, reboot, redset, rename, time, worm.
*Added APIs: bit, colours, disk, help, rednet, parallel, textutils
*Text can be edited with left and right arrow keys.
*Many bug fixes
|align=center|1.0
|-
|align=center|ComputerCraft 1.11
|
*Fixed bug where [[Computer|Computers]] could not read input from RedPower cables which had a bend in the immediately adjacent square.
|align=center|1.0
|-
|align=center|ComputerCraft 1.1
|
*Changed the default block ID for the [[Computer|Computer]] to 207.
*Added multiplayer support.
*Added connectivity with RedPower bundled cables.
*Added HTTP API
*Fixed support for HD textures on the front of [[Computer|Computers]].
*Added command history to the [[Computer]].
*Added config options to change the size of the [[Computer]] GUI and the text color.
*Programs with infinite loops that don't yield will no longer freeze Minecraft and will terminate after 10 seconds.
*Extended Help and fixed typos/small errors in various programs.
|align=center|1.0
|-
|align=center|ComputerCraft 1.02
|
*Fixed the MCPatcher HD textures incompatibility that was causing the computer texture to replace cobblestone blocks.
|align=center|1.0
|-
|align=center|ComputerCraft 1.01
|
*Added a ModLoader configuration file, so the computers block ID can be changed.
*Made the error message that displays when Lua files are not correctly installed much more clear, no more "Assertion failed."
|align=center|1.0
|-
|align=center|ComputerCraft 1.0
|
*First Release
|align=center|1.0
|}

Turtle (API)

2013-02-12T07:22:16Z

Viproz:

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|bool}} success
|[[turtle.craft]]( 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|bool}} success
|[[turtle.forward]]()
|Let the Turtle move forward
|
|-
|{{type|bool}} success
|[[turtle.back]]()
|Let the Turtle move back
|
|-
|{{type|bool}} success
|[[turtle.up]]()
|Let the Turtle move up
|
|-
|{{type|bool}} success
|[[turtle.down]]()
|Let the Turtle move down
|
|-
|{{type|bool}} success
|[[turtle.turnLeft]]()
|Let the Turtle turn left
|
|-
|{{type|bool}} success
|[[turtle.turnRight]]()
|Let the Turtle turn right
|
|-
|{{type|bool}} success
|[[turtle.select]](slotNum)
|The Turtle selects the given Slot (1 is top left, 16 (9 in 1.33 and earlier) is bottom right)
|
|-
|{{type|int}} result
|[[turtle.getItemCount]](slotNum)
|Counts how many items are in the given Slot
|
|-
|{{type|int}} result
|[[turtle.getItemSpace]](slotNum)
|Counts how many remaining items you need to fill the stack in the given Slot
|
|-{{row-lightred}}
|{{type|bool}} success
|[[turtle.attack]]()
|Attacks in front of the turtle.
| 1.4
|-{{row-lightred}}
|{{type|bool}} success
|[[turtle.attackUp]]()
|Attacks over the turtle.
| 1.4
|-{{row-lightred}}
|{{type|bool}} success
|[[turtle.attackDown]]()
|Attacks under the turtle.
| 1.4
|-{{row-lightyellow}}
|{{type|bool}} success
|[[turtle.dig]]()
|Breaks the Block in front. With hoe: tills the dirt in front of it.
|
|-{{row-lightyellow}}
|{{type|bool}} success
|[[turtle.digUp]]()
|Breaks the Block above. With hoe: tills the dirt above it.
|
|-{{row-lightyellow}}
|{{type|bool}} success
|[[turtle.digDown]]()
|Breaks the Block below. With hoe: tills the dirt below it.
|
|-
|{{type|bool}} success
|[[turtle.place]](signText)
|Places a Block of the selected slot in front. Engrave signText on signs if provided.
| 1.4
|-
|{{type|bool}} success
|[[turtle.placeUp]]()
|Places a Block of the selected slot above
|
|-
|{{type|bool}} success
|[[turtle.placeDown]]()
|Places a Block of the selected slot below
|
|-
|{{type|bool}} result
|[[turtle.detect]]()
|Detects if there is a Block in front. Does not detect mobs.
|
|-
|{{type|bool}} result
|[[turtle.detectUp]]()
|Detects if there is a Block above
|
|-
|{{type|bool}} result
|[[turtle.detectDown]]()
|Detects if there is a Block below
|
|-
|{{type|bool}} result
|[[turtle.compare]]()
|Detects if the block in front is the same as the one in the currently selected slot
|
|-
|{{type|bool}} result
|[[turtle.compareUp]]()
|Detects if the block above is the same as the one in the currently selected slot
|
|-
|{{type|bool}} result
|[[turtle.compareDown]]()
|Detects if the block below is the same as the one in the currently selected slot
|
|-
|{{type|bool}} result
|[[turtle.compareTo]](slot)
|Compare the current selected slot and the given slot to see if the items are the same, yields true if they are the same, and false if not.
| 1.4
|-
|{{type|bool}} success
|[[turtle.drop]](count)
|Drops all items in the selected slot, or if count is specified, drops that many 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|bool}} success
|[[turtle.drop|turtle.dropUp]](count)
|Drops all items in the selected slot, or if count is specified, drops that many 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|bool}} success
|[[turtle.drop|turtle.dropDown]](count)
|Drops all items in the selected slot, or if count is specified, drops that many 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|bool}} success
|[[turtle.suck]]()
|Picks up an item stack of any number, from the ground or an inventory in front of the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|{{type|bool}} success
|[[turtle.suckUp]]()
|Picks up an item stack of any number, from the ground or an inventory above the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|{{type|bool}} success
|[[turtle.suckDown]]()
|Picks up an item stack of any number, from the ground or an inventory below the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|{{type|bool}} success
|[[turtle.refuel]](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 yields 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 yields "unlimited".
| 1.4
|-
|{{type|bool}} success
|[[turtle.transferTo]](slot, quantity)
|Transfers items from the selected slot to the specified slot in the [quantity] inputted.
| 1.45
|}

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

Turtle (API)

2013-02-12T07:20:44Z

Viproz:

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|bool}} success
|[[turtle.craft]]( 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|bool}} success
|[[turtle.forward]]()
|Let the Turtle move forward
|
|-
|{{type|bool}} success
|[[turtle.back]]()
|Let the Turtle move back
|
|-
|{{type|bool}} success
|[[turtle.up]]()
|Let the Turtle move up
|
|-
|{{type|bool}} success
|[[turtle.down]]()
|Let the Turtle move down
|
|-
|{{type|bool}} success
|[[turtle.turnLeft]]()
|The Turtle turns left
|
|-
|{{type|bool}} success
|[[turtle.turnRight]]()
|The Turtle turns right
|
|-
|{{type|bool}} success
|[[turtle.select]](slotNum)
|The Turtle selects the given Slot (1 is top left, 16 (9 in 1.33 and earlier) is bottom right)
|
|-
|{{type|int}} result
|[[turtle.getItemCount]](slotNum)
|Counts how many items are in the given Slot
|
|-
|{{type|int}} result
|[[turtle.getItemSpace]](slotNum)
|Counts how many remaining items you need to fill the stack in the given Slot
|
|-{{row-lightred}}
|{{type|bool}} success
|[[turtle.attack]]()
|Attacks in front of the turtle.
| 1.4
|-{{row-lightred}}
|{{type|bool}} success
|[[turtle.attackUp]]()
|Attacks over the turtle.
| 1.4
|-{{row-lightred}}
|{{type|bool}} success
|[[turtle.attackDown]]()
|Attacks under the turtle.
| 1.4
|-{{row-lightyellow}}
|{{type|bool}} success
|[[turtle.dig]]()
|Breaks the Block in front. With hoe: tills the dirt in front of it.
|
|-{{row-lightyellow}}
|{{type|bool}} success
|[[turtle.digUp]]()
|Breaks the Block above. With hoe: tills the dirt above it.
|
|-{{row-lightyellow}}
|{{type|bool}} success
|[[turtle.digDown]]()
|Breaks the Block below. With hoe: tills the dirt below it.
|
|-
|{{type|bool}} success
|[[turtle.place]](signText)
|Places a Block of the selected slot in front. Engrave signText on signs if provided.
| 1.4
|-
|{{type|bool}} success
|[[turtle.placeUp]]()
|Places a Block of the selected slot above
|
|-
|{{type|bool}} success
|[[turtle.placeDown]]()
|Places a Block of the selected slot below
|
|-
|{{type|bool}} result
|[[turtle.detect]]()
|Detects if there is a Block in front. Does not detect mobs.
|
|-
|{{type|bool}} result
|[[turtle.detectUp]]()
|Detects if there is a Block above
|
|-
|{{type|bool}} result
|[[turtle.detectDown]]()
|Detects if there is a Block below
|
|-
|{{type|bool}} result
|[[turtle.compare]]()
|Detects if the block in front is the same as the one in the currently selected slot
|
|-
|{{type|bool}} result
|[[turtle.compareUp]]()
|Detects if the block above is the same as the one in the currently selected slot
|
|-
|{{type|bool}} result
|[[turtle.compareDown]]()
|Detects if the block below is the same as the one in the currently selected slot
|
|-
|{{type|bool}} result
|[[turtle.compareTo]](slot)
|Compare the current selected slot and the given slot to see if the items are the same, yields true if they are the same, and false if not.
| 1.4
|-
|{{type|bool}} success
|[[turtle.drop]](count)
|Drops all items in the selected slot, or if count is specified, drops that many 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|bool}} success
|[[turtle.drop|turtle.dropUp]](count)
|Drops all items in the selected slot, or if count is specified, drops that many 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|bool}} success
|[[turtle.drop|turtle.dropDown]](count)
|Drops all items in the selected slot, or if count is specified, drops that many 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|bool}} success
|[[turtle.suck]]()
|Picks up an item stack of any number, from the ground or an inventory in front of the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|{{type|bool}} success
|[[turtle.suckUp]]()
|Picks up an item stack of any number, from the ground or an inventory above the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|{{type|bool}} success
|[[turtle.suckDown]]()
|Picks up an item stack of any number, from the ground or an inventory below the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|{{type|bool}} success
|[[turtle.refuel]](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 yields 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 yields "unlimited".
| 1.4
|-
|{{type|bool}} success
|[[turtle.transferTo]](slot, quantity)
|Transfers items from the selected slot to the specified slot in the [quantity] inputted.
| 1.45
|}

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

Os.pullEvent

2013-01-08T01:32:18Z

Viproz: /* Event types */

{{lowercase}}
{{Function
|name=os.pullEvent
|args=([[string]]) filter
|api=OS
|returns=(string)event, variable parameters(see table below)
|addon=ComputerCraft
|desc=Waits (yields) until an event occurs
|examples=
{{Example
|desc=The program requires to wait for a keypress to do something:
|code=[[Function (type)|function]] clear()
[[term.clear]]()
[[term.setCursorPos]] (1,1)
end
while true do
clear()
[[print]] ("Press E to do something.")
local event, param1 = os.pullEvent ("char") -- limit os.pullEvent to the char event
if param1 == "e" then -- if the returned value was 'e'
clear()
[[write]] ("Name: ")
local name = [[read]]()
[[print]] (name)
break
else
clear()
[[print]] ("Wrong button!")
[[os.sleep|sleep]] (1.5) -- I don't like a whole 2 seconds but 1 second is too short
end
end
}}
}}

=== Common syntax ===

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

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

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

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

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

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

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

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

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

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

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

which will ignore any events that are not mouse clicks.

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

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

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

[[Category:Lua_Core_Functions]]

Mouse click (event)

2013-01-08T01:31:01Z

Viproz: changed os.pullEvent to os.pullEvent

{{Event
|name=mouse_click
|desc=Fired when the terminal is clicked.
|return1=The mouse button that was clicked.
|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
event, button, xPos, yPos = [[os.pullEvent]]("[[mouse_click_(event)|mouse_click]]")
[[print]](event .. " => " .. tostring(button) .. ": " .. [[tostring]](button) .. ", " ..
"X: " .. [[tostring]](xPos) .. ", " ..
"Y: " .. [[tostring]](yPos))
end
|output=The button that was pressed, followed by the X and Y position of the event.
}}
}}

Monitor touch (event)

2013-01-08T01:30:11Z

Viproz: Created page with "{{Event |name=monitor_touch |desc=Fired when the player right click on an advanced monitor connected. |return1=The side of the advanced monitor. |return2=The X-coordinate of t..."

{{Event
|name=monitor_touch
|desc=Fired when the player right click on an advanced monitor connected.
|return1=The side of the advanced monitor.
|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 side of the monitor and the co-ordinates of every mouse click we receive a ''monitor_touch'' event.
|code=
while true do
event, side, xPos, yPos = [[os.pullEvent]]("[[monitor_touch_(event)|monitor_touch]]")
[[print]](event .. " => Side: " .. [[tostring]](side) .. ", " ..
"X: " .. [[tostring]](xPos) .. ", " ..
"Y: " .. [[tostring]](yPos))
end
|output=The side of the advanced monitor, followed by the X and Y position of the event.
}}
}}

Os.pullEvent

2013-01-08T01:19:33Z

Viproz: /* Event types */ Add the new event monitor_touch

{{lowercase}}
{{Function
|name=os.pullEvent
|args=([[string]]) filter
|api=OS
|returns=(string)event, variable parameters(see table below)
|addon=ComputerCraft
|desc=Waits (yields) until an event occurs
|examples=
{{Example
|desc=The program requires to wait for a keypress to do something:
|code=[[Function (type)|function]] clear()
[[term.clear]]()
[[term.setCursorPos]] (1,1)
end
while true do
clear()
[[print]] ("Press E to do something.")
local event, param1 = os.pullEvent ("char") -- limit os.pullEvent to the char event
if param1 == "e" then -- if the returned value was 'e'
clear()
[[write]] ("Name: ")
local name = [[read]]()
[[print]] (name)
break
else
clear()
[[print]] ("Wrong button!")
[[os.sleep|sleep]] (1.5) -- I don't like a whole 2 seconds but 1 second is too short
end
end
}}
}}

=== Common syntax ===

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

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

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

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

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

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

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

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

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

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

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

which will ignore any events that are not mouse clicks.

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

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

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

[[Category:Lua_Core_Functions]]

Advanced Monitor

2013-01-08T01:08:21Z

Viproz: Changed the number of advancedMonitor made in one recipe

{{Block
|name=Advanced Monitor
|image=Iso_Advanced_Monitor.png
|id=4094
|damage-value=Un-used (clarify?)
|is-peripheral=Yes
}}
The Advanced Monitor is a new, improved version of the [[Monitor]].

In contrast with the standard [[Monitor]], the Advanced Monitor has the ability to show colored text and programs on the screen, and the Advanced Monitor is golden (like the [[Advanced Computer]]), rather than the default stone grey color of the standard [[Monitor]].

For a list of the available colors on both [[Advanced Computer|Advanced Computers]] and the [[Advanced Monitor|Advanced Monitors]], see [[Colors_(API)#Colors|Colors API]].

==Recipe==
{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=glass_pane |C2=Gold_Ingot
|A3=Gold_Ingot |B3=Gold_Ingot |C3=Gold_Ingot
|Output=Advanced_Monitor |OA=4
}}

==Using an Advanced Monitor==
The Advanced Monitor behaves exactly the same as the standard [[Monitor]] - except the Advanced Monitor is able to render text with a foreground and background [[Colors (API)#color|color]].

The Advanced Monitor introduces two new methods: ''[[term.setTextColor|monitor.setTextColor]]([[colors (API)#colors|color]])'' and ''[[term.setBackgroundColor|monitor.setBackgroundColor]]([[colors (API)#colors|color]])''. These functions allow you to draw text with a specific foreground and background color. Please note that both spellings of the word color are accepted.

To use an Advanced Monitor, you need to either call a method, or wrap the monitor using the Peripheral API. For this example, we have an Advanced Monitor connected to the top of our [[Computer]]:

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

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

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

Methods in ''italic'' are available on [[Advanced Monitor|Advanced Monitors]] only.

{| class="wikitable"
!style="background:#EEE" width="210px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[term.write|monitor.write]]()
|Write to the Monitor's screen.
|-
|[[term.scroll|monitor.scroll]](n)
|Scrolls the monitor screen.
|-
|[[term.setCursorPos|monitor.setCursorPos]](x, y)
|Sets the cursor position on the Monitor.
|-
|[[term.setCursorBlink|monitor.setCursorBlink]](b)
|Enables or disables cursor blinking.
|-
|[[term.getCursorPos|monitor.getCursorPos]]()
|Returns two arguments containing the x and the y position of the cursor on the Monitor.
|-
|[[term.getSize|monitor.getSize]]()
|Returns two arguments containing the x and the y values stating the size of the Monitor.
|-
|[[term.clear|monitor.clear]]()
|Clears the Monitor.
|-
|[[term.clearLine|monitor.clearLine]]()
|Clears the line the cursor is on.
|-
|[[monitor.setTextScale|monitor.setTextScale]](scale)
|Sets the size of the text on the Monitor. Textscale can be between 0.5 and 5.0, with increments of 0.5
|-
|''[[term.setTextColor|monitor.setTextColor]]([[colors (API)#colors|color]])''
|Sets the text-color of the [[Advanced Monitor]]. Available only to [[Advanced Monitor|Advanced Monitors]]
|-
|''[[term.setBackgroundColor|monitor.setBackgroundColor]]([[colors (API)#colors|color]])''
|Sets the background-color of the [[Advanced Monitor]]. Available only to [[Advanced Monitor|Advanced Monitors]]
|}

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