ComputerCraft Wiki - User contributions [en]

Advanced Monitor

2013-09-14T09:20:13Z

AfterLifeLochie: Neutrality edit

{{Block
|name=Advanced Monitor
|image=Iso_Advanced_Monitor.png
|id=4094
|damage-value=Un-used
|is-peripheral=Yes
|peripheral-api=Term (API)
}}
The Advanced Monitor is a [[Monitor]] that has mouse (as 'punches') support, and can use the [[Color_(API)|Color API]] for screen colors. They resemble the traditional computer console, but are golden coloured to match their crafting [[recipes|recipe]].

==Recipe==
{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=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 directly using [[peripheral.call]](), or, wrap the monitor using the [[Peripheral_(API)|Peripheral API]]. Wrapped monitors provide all functions listed in the [[Term_(API)|Term API]], with the exception of [[Monitor.setTextScale|monitor.setTextScale(size)]], which is native to monitors only.

For this example, we have 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!")

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

Advanced Computer

2013-09-14T09:17:43Z

AfterLifeLochie: Neutrality edit

{{Block
|name=Advanced Computer
|image=Iso_Advanced_Computer.png
|id=4095
|damage-value=The ID of the Computer.
|is-peripheral=Yes
}}
The Advanced Computer is a [[Computer]] that has mouse support and can use the [[Color_(API)|Color API]] for screen colors. They resemble the traditional computer console, but are golden coloured to match their crafting [[recipes|recipe]].
==Recipe==
{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Redstone |C2=Gold_Ingot
|A3=Gold_Ingot |B3=glass_pane |C3=Gold_Ingot
|Output=Advanced_Computer
}}

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

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

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

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

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

User talk:AfterLifeLochie

2013-08-28T05:52:53Z

AfterLifeLochie: /* Why did you revert my edits? */

Another test. Ignore this.

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

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

== APT Minecraft Tekkit window. ==

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

== Program Listing? ==

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

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

== Why did you revert my edits? ==

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

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

User talk:AfterLifeLochie

2013-08-28T05:50:18Z

AfterLifeLochie: /* Why did you revert my edits? */ Copyrighted content.

Login with Roaming Profiles

2013-08-28T03:59:49Z

AfterLifeLochie: Reverted edits by Latias1290 (talk) to last revision by Bwhodle

This tutorial covers how to make a password server and a password client. The server will host a Lua table of usernames and passwords and the client will remotely connect each start up, ask the user for their username and password and compare it to that on the password server.

__TOC__

== Setting Up ==
As I'm sure you're aware, writing code directly into the computer terminal can be difficult, slow, and therefore annoying. I highly recommend writing/copying the following code into a Lua editor and then using FTP to transfer the documents across to the computer or disk. Please ensure you do not add the .lua extension. Programs are saved in your minecraft world under the "computer" directory, with one folder for each computer plus the folder "disk" which contains a directory for each disk.

First craft two or more computers. One will act as your password server, any others will be connecting to that computer. Find the computer ID of your password server. This is important as we don't want to broadcast password requests and replies. In the following code I have also locked the requests to certain computers to ensure security but it is not a needed component of the code. If you decide to take the security as well, make a note of all of the ID's of the client computers. I found it useful to give each computer a label and then search for labels.txt on the server to map it out easily.

Each computer you craft needs a [[modem|rednet modem]].

== Server ==

os.pullEvent = os.pullEventRaw
term.clear()
term.setCursorPos(1,1)
print("This is a password server. There is no user interaction here.")
print("Please find a computer and login there.")
local firstCycle = true
local validSender = false
local modemSide = "left" -- change to the side of the computer your modem is on
local valid = false
users = {"username1", "username2" } --make sure users and passwords line up
passwords = {"password1", "password2" }
senders = { 1, 2, 3, 4 } -- computer ID's of the computers you want to accept requests from
function bootUp()
rednet.open(modemSide)
end
while true do
validSender = false
if firstCycle then
bootUp()
firstCycle = false
end
senderId, message, distance = rednet.receive()
for i,v in ipairs(senders) do
if v == senderId then
validSender = true
break
end
end
if validSender then
for i,v in ipairs(users) do
if message == v then
valid = true
password = passwords[i]
break
else
valid = false
end
end
if valid then
rednet.send(senderId, password, true)
else
rednet.send(senderId, "Not Valid", true)
end
end
end

== Client ==

os.pullEvent = os.pullEventRaw
local locker = true
local failed = true
local attempted_login = true
local password_server = 0 -- change to the ID of your password server computer
rednet.open("left") -- change to the side your rednet modem is on
while locker do
attempted_login = false
term.clear()
term.setCursorPos(1,1)
print("Welcome to a USERS PC : Roaming Profile Enabled")
print("What would you like to do?")
print("[1] Login (*)")
print("[2] Shutdown")
write("> ")
local input = read()
if input == "2" then
os.shutdown()
elseif input == "1" then
attempted_login = true
print("Please login...")
write("Username: ")
local username = read()
write("Password: ")
local password = read("*")
rednet.send(password_server, username, true)
senderId, message, distance = rednet.receive(5)
if password == message then
failed = false
locker = false
term.clear()
term.setCursorPos(1,1)
print("Welcome ", username)
else
print("Invalid Username or Password.")
sleep(3)
end
else
print("Command not recognised...")
sleep(2)
end
end

== Thoughts and Notes ==
Although this may work very well as a login system, it is insecure by the flaw that a malicious sniffer can unnoticeably obtain a copy of the password while it is being sent as described on the [[Rednet_(API)|Rednet API]] page, and use the password to login.

If you change the client code, to "startup" and put it in the root directory, it works very well as a login system.
You may also want to put in the line
os.pullEvent = os.pullEventRaw -- disables Ctrl+T
as if it doesn't work first time it can be difficult to get out of the program.

If you have either Railcraft or Additional Pipes, find the 'World Anchor' or 'Teleport Tether' block. If your server can afford the resources, place the block within a 3x3 grid of your password server. It will ensure that even if you leave the chunk, the password server still is operational. Otherwise you may find that you cannot login because you've left the chunk and the password server is no longer dealing with requests.

This is a minor security flaw but it is only if someone has access to a computer that is 'whitelisted' to access the password server. The security flaw is that if they use the password Not Valid on that computer they are allowed access;

if valid then
--send client password
else
--send client Not Valid
end

to fix remove the else statement

[[Category:Programs]]

Nil (type)

2013-08-25T02:46:26Z

AfterLifeLochie: moved Nil to Nil (type): It's a type, not an anything.

'''nil''' is Lua's ''null''. It is different from any other value and represents ''false'' in a logical expression. Most of the time, it is used to indicate the lack of a useful value.

Check Wikipedia's page on the [https://en.wikipedia.org/wiki/Null_pointer#Null_pointer null pointer] for more informations.

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

[[Category:Lua_Types]]

Nil

2013-08-25T02:46:26Z

AfterLifeLochie: moved Nil to Nil (type): It's a type, not an anything.

#REDIRECT [[Nil (type)]]

Template:API table

2013-08-25T02:41:36Z

AfterLifeLochie: Un-breaking, you forgot colspan= items.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><th colspan="3" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px; text-align: left">
[[File:{{{image}}}|24px]]  {{{1}}} (API)</th></tr>
<tr>
<td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Function</td>
<td style="width: 250px; background: #E0E0E0; padding: .4em; font-weight:bold;">Return values</td>
<td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>
{{{2}}}
</table>

Peripheral

2013-08-25T02:28:18Z

AfterLifeLochie: `OpenPeripherals` => `OpenPeripheral` (name), apply name convention, add reference to Category:Peripherals, add to Category:Disambiguation_Pages (de-facto). (I probably missed something)

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

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

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

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

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

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

[[Category:Disambiguation Pages]]

User:Watcher7

2013-07-12T00:41:37Z

AfterLifeLochie: moved User:Cocks to User:Watcher7: Automatically moved page while renaming the user "Cocks" to "Watcher7"

wangs

Paintutils.drawPixel

2013-07-12T00:38:47Z

AfterLifeLochie: Int -> {{type|number}}

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

[[Category:API_Functions]]

Paintutils.drawImage

2013-07-12T00:38:35Z

AfterLifeLochie: Int -> {{type|number}}

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

[[Category:API_Functions]]

Colors (API)

2013-07-12T00:37:50Z

AfterLifeLochie: {{Type|Int}} -> {{Type|Number}} (I may make Template:Type allow only certain datatypes.)

The Colors API allows you to utilize Bundled Cables from the RedPower mod, and colors on [[Advanced Computer|Advanced Computers]] and [[Advanced Monitor|Advanced Monitors]].

For the non-American English version just replace 'colors' with 'colours' and it will use the other API, colours—which is exactly the same, except in non-American English (e.g. gray is spelt grey and lightGray is spelt lightGrey).
<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="3" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
colors (API)
</td></tr>

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|number}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[colors.combine]]({{Type|number}} color1, {{Type|number}} color2, …)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Combines a set of colors (or sets of colors) into a larger set.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|number}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[colors.subtract]]({{Type|number}} colors, {{Type|number}} color1, {{Type|number}} color2, …)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Removes one or more colors (or sets of colors) from an initial set.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|boolean}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[colors.test]]({{Type|number}} colors, {{Type|number}} color)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tests whether <var>color</var> is contained within <var>colors</var>.</td></tr>

</table>

Note: Since the colors are just integers, the standard addition (+) and subtraction (-) operators may be used on colors instead of colors.combine and colors.subtract.

Furthermore, the [[Bit (API)]] may be used on sets of colors. For example,
<pre>
bCableLeft = rs.getBundledInput("left")
bCableRight = rs.getBundledInput("right")

-- Get a number representing colors on in both right and left bundled cables
commonColors = bit.band(bCableLeft, bCableRight)

-- Get all the colors active on either right or left
totalColors = bit.bor(bCableLeft, bCableRight)

-- Get the colors which are active on right, or left, but not both at the same time
exclusiveColors = bit.bxor(bCableLeft, bCableRight)

-- Get the colors that are not active on the left
offColorsA = bit.bnot(bCableLeft)
</pre>

==Colors==
Color constants include, in ascending bit order:

{| class="wikitable" width="200px"
! Color
! Decimal
! Hexadecimal
! Binary
|-
| colors.white
| align="right" | 1
| align="right" | 0x1
| align="right" | 0000000000000001
|-
| colors.orange
| align="right" | 2
| align="right" | 0x2
| align="right" | 0000000000000010
|-
| colors.magenta
| align="right" | 4
| align="right" | 0x4
| align="right" | 0000000000000100
|-
| colors.lightBlue
| align="right" | 8
| align="right" | 0x8
| align="right" | 0000000000001000
|-
| colors.yellow
| align="right" | 16
| align="right" | 0x10
| align="right" | 0000000000010000
|-
| colors.lime
| align="right" | 32
| align="right" | 0x20
| align="right" | 0000000000100000
|-
| colors.pink
| align="right" | 64
| align="right" | 0x40
| align="right" | 0000000001000000
|-
| colors.gray
| align="right" | 128
| align="right" | 0x80
| align="right" | 0000000010000000
|-
| colors.lightGray
| align="right" | 256
| align="right" | 0x100
| align="right" | 0000000100000000
|-
| colors.cyan
| align="right" | 512
| align="right" | 0x200
| align="right" | 0000001000000000
|-
| colors.purple
| align="right" | 1024
| align="right" | 0x400
| align="right" | 0000010000000000
|-
| colors.blue
| align="right" | 2048
| align="right" | 0x800
| align="right" | 0000100000000000
|-
| colors.brown
| align="right" | 4096
| align="right" | 0x1000
| align="right" | 0001000000000000
|-
| colors.green
| align="right" | 8192
| align="right" | 0x2000
| align="right" | 0010000000000000
|-
| colors.red
| align="right" | 16384
| align="right" | 0x4000
| align="right" | 0100000000000000
|-
| colors.black
| align="right" | 32768
| align="right" | 0x8000
| align="right" | 1000000000000000
|}
[[Category:APIs]]

Paintutils.drawLine

2013-07-12T00:35:45Z

AfterLifeLochie: The color argument is not typeof color, it's an int representing a color-API value.

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

[[Category:API_Functions]]

Timer (event)

2013-07-08T00:12:57Z

AfterLifeLochie: Not 'numerical representation', 'unique ID'. os.startTimer() returns an ID.

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

{{Event
|name=timer
|desc=Fired when a timer completes.
|return1=The timer's unique ID value (returned when [[os.startTimer|os.startTimer()]] is called).
}}
{{Example
|desc=This code will continuously start an internal timer and fire an event. If the event is not the timer, then it will break the loop
|code= while true do<br/> os.startTimer(1)<br/> event = os.pullEvent()<br/> if event == "timer" then <br/> print("Too slow!")<br/> else<br/> print("Darn, you beat me!")<br/> break<br/> end<br/>end
}}

Shell.aliases

2013-07-08T00:11:15Z

AfterLifeLochie: Actually explained what this function does.

{{lowercase}}
{{Function
|name=shell.aliases
|api=Shell
|returns=A table containing default and user-specified program aliases.
|addon=ComputerCraft
|desc=Returns a table containing the default aliases and any user-specified aliases. The key of each entry is the 'alias name', and the value the physical program.
|examples=
{{Example
|desc=This code will return all set aliases and the programs they refer to.
|code= for alias, programName in pairs(shell.aliases()) do<br/> print(alias .. " => " .. programName)<br/>end
|output=<pre>mv => move
dir => list
cp => copy
rm => delete
ls => list</pre>}}
}}

[[Category:API_Functions]]

Printer.getPaperLevel

2013-07-07T23:54:00Z

AfterLifeLochie: If there are no args, leave the |args= field empty.

{{lowercase}}
{{Function
|name=printer.getPaperLevel
|returns=[[int (type)|int]] the amount of paper in the printer
|api=printer
|addon=ComputerCraft
|desc=Returns the total amount of paper in the printer.
|examples=
{{Example
|desc=Prints paper level
|code=print(printer.getPaperLevel())
}}
}}

[[Category:Lua_Core_Functions]]

Term.clear

2013-07-07T23:53:11Z

AfterLifeLochie: Grammar, we use it.

{{lowercase}}
{{Function
|name=term.clear
|returns=[[nil]]
|api=term
|addon=ComputerCraft
|desc=Clears the screen
|examples=
{{Example
|desc=Clears all text on the console or monitor and sets the cursor to coordinate (1, 1) on the screen.
|code=[[term.clear]]()<br />[[term.setCursorPos]](1,1)
}}
{{Example
|desc=Turns the screen a specified colour
|code=[[term.setBackgroundColor]]([[Color_(API)|colors]].blue)<br>[[term.clear]]()
}}
}}

[[Category:API_Functions]]

Os.pullEvent

2013-07-07T23:49:36Z

AfterLifeLochie: No, os.pullEvent() does not return a metamethod __call for use in for-expressions. Check your code.

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

=== Common syntax ===

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

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

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

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

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

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

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

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

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

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

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

which will ignore any events that are not mouse clicks.

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

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

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

[[Category:Lua_Core_Functions]]

Main Page

2013-07-06T22:05:07Z

AfterLifeLochie: Typo - remove incorrect apostrophe

<div id="mp-header-block"
style="position: relative; width: 600px; margin: 0 auto; background-color: #DBE5FF; border: 1px solid #CCC; border-radius:5px; text-align: center; padding: 0.4em; box-shadow: 3px 3px 3px #B5B5B5;">
<div style="position:absolute; top:8%; left:0.4em">[[File:Grid_wireless_mining_turtle.png|48px]]</div>
<div style="position:absolute; top:8%; right:0.4em">[[File:Iso_Computer.png|48px]]</div>
<div style="font-size:150%; font-weight:bold; margin-top: 0.6em" id="mp-header">Welcome to the ComputerCraft Wiki!</div>
<div id="mp-header-articles" style="font-size:85%">'''''{{NUMBEROFARTICLES}} pages and {{NUMBEROFEDITS}} edits since January 27th, 2012.'''''</div>
</div>

<table style="width:100%;" cellspacing="1" cellpadding="1">


<tr style="vertical-align:top;">
<td style="vertical-align:top;">
{{Heading|[[File:Iso_Computer.png|24px]]  What is ComputerCraft?}}
'''ComputerCraft''' is a mod created for [http://minecraft.net Minecraft] by [http://www.computercraft.info/dan200/ dan200] that adds [[Computer|Computers]], [[Monitor|Monitors]], [[Modem|Modems]], [[Turtle|Turtles]] and more! ComputerCraft's [[Computer|Computers]] and [[Turtle|Turtles]] are programmed with the easy-to-learn [http://www.lua.org/ Lua programming language]. You can use [[Redstone]], [http://eloraam.com/ RedPower] or even [http://www.minecraftforum.net/topic/1629898-151152-powercrystals-mods-15-updates-are-here-rednet-logic-is-here-100-upvotes/#mfr MineFactory Reloaded] alongside with your devices for the best experience.
</td>
<td style="vertical-align:top; width:350px;">
<h2 style="overflow:auto; padding:0.2em 0.4em; margin:10px 0 10px 0; border:1px solid #696969; color:#000000; font-size:120%; box-shadow: 3px 3px 3px #B5B5B5; font-weight:bold; text-align:left; -moz-border-radius:5px; border-radius:5px; background-color: #E0E0E0;"><span class="mw-headline">
<div style="width:24px; height:24px; float:left;">[[File:Iso_Printer.png|24px]]</div><center><b>[http://www.computercraft.info ComputerCraft News]</b></center>
</span></h2>
<h2 style="overflow:auto; padding:0.2em 0.4em; margin:10px 0 10px 0; border:1px solid #696969; color:#000000; font-size:120%; box-shadow: 3px 3px 3px #B5B5B5; font-weight:bold; text-align:left; -moz-border-radius:5px; border-radius:5px; background-color: #E0E0E0;"><span class="mw-headline">
<div style="width:24px; height:24px;float:left;">[[File:Grid_Redstone.png|24px]]</div><center><b>[http://www.minecraftforum.net/topic/892282- Download ComputerCraft!]</b></center>
</span></h2>
</td>
</tr>


<tr style="vertical-align:top;">
<td style="vertical-align:top;">
{{Heading|[[File:Grid_chest.png|24px]]  Wiki Contents}}
<table style="width:99%; text-align:center;">
<tr>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Download|Download ComputerCraft]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Tutorials|Tutorial List]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[:Category:Programs|Program List]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[:Category:APIs|API List]]</td>
</tr>
<tr>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Recipes|Recipe List]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[:Category:Peripherals|Peripherals & Addons]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[:Category:Notable_Programs|Notable Programs]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[:Category:OSes|Operating Systems]]</td>
</tr>
<tr>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Changelog|ComputerCraft Changelog]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Wiki Todo]]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[http://www.computercraft.info/forums2/index.php?/forum/29-wiki-discussion/ Wiki Discussion]</td>
<td style="width:20%; text-align:center; border-bottom:1px solid #E2E2E2;">[http://www.computercraft.info/forums2/index.php?/topic/6919-wiki-edit-privileges/page__view__findpost__p__58435 Editor Access]</td>
</tr>
</table>
</td>
<td style="vertical-align:top;">
{{Heading|[[File:Grid_diamond_pickaxe.png|24px]]  Latest Version}}
{{Version}}
</td>
</tr>


<tr style="vertical-align:top;">
<td style="vertical-align:top;">
{{Heading|[[File:Grid_disk.png|24px]]  Examples}}
Some examples of the many powerful uses of ComputerCraft are:
<table style="width:99%; text-align:center;">
<tr>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Making a Password Protected Door|Password locks for doors without complicated redstone]]</td>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">Making a [[Login_with_Roaming_Profiles|user control system]] for computer users</td>
</tr>
<tr>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">The use of [[Turtle|Turtles]] to mine</td>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">[[CraftOS_Shell#cmd-redset|Piston doors]]</td>
</tr>
<tr>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">Using a [[Computer]] to control your TNT Cannons</td>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">Make a [[Turtle_Lumberjack_(tutorial)|Turtle Lumberjack]]</td>
<tr>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">Using [[Computer|Computers]] as a [[Disk.playAudio|jukebox]] or even as a [[CraftOS_Shell#cmd-dj|DJ]]</td>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Turtle]] powered [[Cobble Generator]]</td>
</tr>
<tr>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Computer|Computer-Powered]] Adventure Maps</td>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">Using a [[Computer]] outfitted with Minepedia for Minecraft help in-game</td>
</tr>
<tr>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">[[Worm|Epic games]] and [[Adventure|RPGs]]</td>
<td style="width:50%; text-align:center; border-bottom:1px solid #E2E2E2;">Make a turtle [[CraftOS_Shell#cmd-dance|dance]]</td>
</tr>
<tr>
<td colspan="2" style="text-align:right; font-weight:bold;">...and much, much more - so why not [[Getting Started|get started]]!</td>
</tr>
</table>
</td>
<td style="vertical-align:top;">
{{Heading|[[File:Grid_paper.png|24px]]  ComputerCraft History}}
{{News}}
</td>
</tr>



</table>

[[Category:Lists]]
__NOTOC__

User:AfterLifeLochie/Sandbox

2013-07-03T20:45:42Z

AfterLifeLochie: This change occurred 01:45 GMT (time test)

Time fixing, again.

Template:List of Administrators

2013-06-22T20:51:16Z

AfterLifeLochie:

{| cellspacing="0" cellpadding="2px" style="background: #FFF; text-align: center; border: 1px solid #CCCCCC; width: 300px; font-size: 90%; margin: 0 auto 1em; padding: 2px"
! colspan="2" style="padding: 2px" | Administrators
|-
| [[User:AfterLifeLochie|AfterLifeLochie]] || ''[[User talk:AfterLifeLochie|talk]] • [[Special:Contributions/AfterLifeLochie|contribs]]''
|-
| [[User:Cloudy|Cloudy]] || ''[[User talk:Cloudy|talk]] • [[Special:Contributions/Cloudy|contribs]]''
|-
| [[User:Dan200|Dan200]] || ''[[User talk:Dan200|talk]] • [[Special:Contributions/Dan200|contribs]]''
|-
| [[User:FuzzyPurp|FuzzyPurp]] || ''[[User talk:FuzzyPurp|talk]] • [[Special:Contributions/FuzzyPurp|contribs]]''
|-
| [[User:Lyqyd|Lyqyd]] || ''[[User talk:Lyqyd|talk]] • [[Special:Contributions/Lyqyd|contribs]]''
|-
! colspan="2" style="padding: 2px" | Bureaucrats
|-
|}

Turtle

2013-06-15T21:41:52Z

AfterLifeLochie: {nobukkit:cloudy}

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

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

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

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

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

==Floppy Disks and Peripherals==
Turtles do not have a built-in [[Disk Drive]]. As such, they need a [[Disk Drive]] placed beside them to access [[Floppy Disk|Floppy Disks]]. However, if the Turtle is of the Wireless family, the [[Disk Drive]] (and other peripherals) must be placed on a side other than the side the [[Wireless Modem|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|Printers]] can be interacted using the peripheral API.

==Power source==
Turtles require fuel to operate - this means Turtles must be powered from any item that works in a regular furnace, like coal and lava. The turtle gains 0.6 "movement" per half second the fuel would have burnt in a furnace. The Turtle can move 1 block for each fuel count it has, for example, coal yields 96 block movements. For more information, go to the [[Turtle.refuel]] page.

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

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

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

==Crafting==
Turtles with a [http://www.minecraftwiki.net/wiki/Crafting_Table Crafting Table] can craft items if they have the correct materials to do so, and all other slots outside the crafting-zone are empty.

==Melee==
Turtles equipped with a [[diamond sword]] can attack players and mobs. When a Turtle kills a mob it will leave the experience orbs on the ground, but add the loot to its inventory. Turtles can also attack with any tool, where the [[diamond axe]] is the second best after the [[diamond sword]].

==Inventory Interaction==
Turtles can interact with blocks that have inventories. This includes chests, furnaces, [[Printer|printers]] and even blocks with inventories in other mods. (This means a turtle cannot interact with a player's inventory). Turtles can interact with such inventories by using [[Turtle.suck|turtle.suck, turtle.suckDown, turtle.suckUp]] (To retrieve the first item in the inventory. The turtle finds the first item by scanning the first row from left to right, then the second row from left to right, ect.) Turtles can also place items inside inventories, by using [[Turtle.drop|turtle.drop, turtle.dropUp, turtle.dropDown]], which places items on the first item slot available (Using the same system as the one described for retrieving items).

In special inventories, with just a few slots on the top or bottom, for example furnaces, you can specify which slot to place an item in by positioning the turtle in the corresponding location to the front face of the inventory. For example in a furnace, you would use a turtle at the bottom of the furnace for it to place fuel in the furnace, a turtle at the top to place objects to smelt, and a turtle to the right to retrieve the smelted objects (Note that you can do this with just 1 turtle moving around)

==Recipes==

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

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

Modem (API)

2013-06-06T09:11:45Z

AfterLifeLochie: Changing context: 'I will' => 'the modem will'.

{{NeedsWork|Need to add pages for missing functions --[[User:Cranium|Cranium]] 17:13, 10 May 2013 (MSK)}}

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

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

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

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[modem.isOpen]]({{type|int}} channel)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Checks to see if ''channel'' is open</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[modem.open]]({{type|int}} channel)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Opens ''channel'' to allow for listening. The channel specified must be larger than 0 and less than 65535</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[modem.close]]({{type|int}} channel)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Closes an open channel to disallow listening</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[modem.closeAll]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Closes all open channels</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[modem.transmit]]({{type|int}} channel, {{type|int}} replyChannel, {{type|string}} message)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Transmits a message on the specified channel</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[modem.isWireless]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns true if the modem is wireless; false if it is wired</td></tr>
</table>

==Sending Messages==
Sending messages is simple and does not require that you open any channels. Simply use the transmit function like so:
local modem = peripheral.wrap("right") --Wraps the modem on the right side.
modem.transmit(3, 1, "Hello world!")
peripheral.call("right", "transmit", 3, 1, "This will also work!")

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

==Receiving Messages==
Receiving messages requires that you be familiar with events. As of this moment, there is no API which cuts out events from the process. Here is an example of how to receive messages:
local modem = peripheral.wrap("left")
modem.open(3)--Open channel 3 so that we can listen on it
local event, modemSide, senderChannel,
replyChannel, message, senderDistance = os.pullEvent("modem_message")
print("I just received a message from: "..senderChannel)
print("I should apparently reply on: "..replyChannel)
print("The modem receiving this is located on the "..modemSide.." side")
print("The message was: "..message)
print("The sender is: "..senderDistance.." blocks away from me.")

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

== Modem Limitations ==
* You can only open 128 channels at any given time.
* The maximum channel you can open is 65535.
* You can listen on more than one channel at a time. For example, if the modem has channel 3 and channel 5 open, and somebody sends a message on channel 5, the modem will receive it. If a message is sent on channel 3, the modem will also receive the message.
* Sending messages does not require you to open any channels prior to sending it.
* If you aren't receiving a message when you think you should, check to make sure that you have opened the channel first.
* Modems and channels are not secure - if you are sending a message using the Rednet API, messages are still available to any computer listening on the sent channel.

[[Category:Peripheral APIs]]

Turtle.suck

2013-06-06T09:00:40Z

AfterLifeLochie: Reworded to remove 'turtle' versus 'chest'/'ground' ambiguity.

{{lowercase}}
{{Function
|name=turtle.suck
|args=
|returns=[[boolean_(type)|boolean]] true if at least one item was moved into the turtle's inventory; false otherwise.
|api=turtle
|addon=ComputerCraft
|desc=
Moves one or more items from either the ground in front of the turtle, or, from an inventory-enabled block (such as a chest) in front of the turtle.
* If an item is in the square directly in front of the turtle, it picks up one of those items.
* If a chest is in the square directly in front of the turtle, it picks up the items from the first non-empty chest slot, moving from top left to bottom right. The items are moved into the currently selected turtle slot if there is room.
* If the currently selected turtle slot is filled up before all of the items are picked up, the remaining picked up items are put in the next available turtle slot.
* If the currently selected turtle slot is 16 and the next slot is required, it will loop around and try turtle slot 1, and so on.
|examples=
{{Example
|desc=Picks up some items.
|code=turtle.suck()
}}
}}

[[Category:Lua_Core_Functions]]

Wiki Todo

2013-06-03T06:27:55Z

AfterLifeLochie: /* Additional Tasks */ Update tasklist.

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

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

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

__TOC__

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

== Additional Tasks ==
*[[Textutils_(API)|Textutils]] (Needs <s>5</s> 3 function pages, <s>2</s> 1 function description)
*[[Vector_(API)|Vector]] <s>(Needs link to page explaining or description explaining what a vector is and function pages)</s>
** <s>It now has a link to Wikipedia, but it doesn't use any of the method or example templates. Can we get this rectified? ''[[User:AfterLifeLochie|AfterLifeLochie]] 02:14, 29 November 2012 (MSK)''</s>
** Now has pages to every function in a standard template. May need to double check work for any broken links or missing pages. Examples and descriptions probably need work. ''[[User:MafiaMoe|MafiaMoe]] 18:38, 23 February 2013 (MSK)''
*[[Paintutils_(API)|Paintutils]] (Needs 3 function pages)
** <s>It also doesn't use any of the methods or example templates. Can we get this rectified? ''[[User:AfterLifeLochie|AfterLifeLochie]] 02:14, 29 November 2012 (MSK)''</s>
** Apparently the thre new functions have been added, and are waiting on approval? Do we need approval for these things? --[[User:Cranium|Cranium]] 15:49, 23 April 2013 (MSK)
*** Nope, go ahead, they've been waiting to be created for a long time now. ''[[User:AfterLifeLochie|AfterLifeLochie]] 10:27, 3 June 2013 (MSK)''
* Some links don't link to their correct pages, resulting in page duplication and wasting time deleting pages. Can sometimes be found in the [[Special:WantedPages| Wanted Pages.]]
* Since {{type|int}} is intended to be deleted, are we to be switching those links to {{type|number}}? --[[User:Cranium|Cranium]] 19:57, 10 May 2013 (MSK)
** Yes. All links will need to be moved from int => number in templates and text. Use the 'What Links Here' tool to quickly locate referencing pages. ''[[User:AfterLifeLochie|AfterLifeLochie]] 10:27, 3 June 2013 (MSK)''
*<s>[[Coroutine_(API)|Coroutine]] (Bottom section on interaction with other APIs is completely misleading; needs either re-write or removal) [[User:Lyqyd|Lyqyd]] 01:44, 27 May 2013 (MSK)</s>
** Fixed by Hawk777 at 17:41, 28 May 2013 (MSK). ''[[User:AfterLifeLochie|AfterLifeLochie]] 10:27, 3 June 2013 (MSK)''

== Wiki Admin Things ==
=== General Wiki Stuff ===
* <s>Random Links, such as mining_turtle via image links, any chance of removing them? </s>
** Uh, no. They're generated through templates doing weird things, and fixing them is a real pain (template re factorization, renaming files, etc). I have fixed some but not all. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:46, 29 December 2012 (MSK)''
[[Category:Lists]]

Diamond axe

2013-06-03T06:22:00Z

AfterLifeLochie: Add |Output-link to crafting.

The diamond axe can be equipped on a turtle and is a tool that is both effective for mining and attacking. The axe is the second best weapon for the turtle and can also mine blocks. The turtle cannot get the resources for mining ores and stone.
{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle
|Output-link=Turtle
}}
For more information on the "Diamond Axe", please go the the Minecraft official wiki.

[http://www.minecraftwiki.net/wiki/Diamond_Axe Diamond Axe]

[[Category:Vanilla_Minecraft]]

User:MathManiac0/Templates

2013-06-03T06:21:32Z

AfterLifeLochie: Remove weird Peripherals wikilink (hurr?)

''Look in the source code to see how the tables are made.''

''These pieces of data isn't real; they are instead examples how the templates can be made.''


{{Function
|name=foo.Bar
|args= [[int (type)|int]] number
|returns=[[int (type)|int]] number
|api=
|addon=ComputerCraft
|desc=Returns the given number
|examples=
{{Example
|desc=Prints the number wrapped by foo.Bar()
|code=print(foo.Bar(2))
|output=2
}}
}}

Template:Type

2013-06-03T06:19:35Z

AfterLifeLochie: Added <includeonly> to properly handle behaviour and remove deadlinks.

<includeonly>[[{{{1|}}} (type)|<span style="color: darkgreen; font-style: italic">{{lcfirst:{{{1|}}}}}</span>]]</includeonly>

Diamond pickaxe

2013-06-03T06:17:47Z

AfterLifeLochie: Add |Output-link to crafting.

The diamond pickaxe can be equipped on a turtle. The pickaxe is the best tool for mining that can be equipped on a turtle. Because of the high cost of the pickaxe, it can mine anything and get the resources for it. The turtle can also attack with the pickaxe, and has the same damage output as a [[diamond shovel]] and [[diamond hoe]].
{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle
|Output-link=Turtle
}}
For more information on the "Diamond Pickaxe", please go the the Minecraft official wiki.

[http://www.minecraftwiki.net/wiki/Diamond_Pickaxe Diamond Pickaxe]

[[Category:Vanilla_Minecraft]]

Turtle Tutorial

2013-06-03T06:17:12Z

AfterLifeLochie: |Output-link param to crafting.

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

== Turtle ==

The Turtle API is used to work with your Turtles.
[[Turtle (API)|Here is a list of the complete Turtle API]]

For our program, we will use turtle.refuel(),turtle.detectDown(), turtle.digDown(), turtle.down(), turtle.forward(), and turtle.placeDown(). It is recommended that you learn what these method do before messing with Turtles.

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

{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle
}}

Then make a Mining Turtle.

{{Crafting grid
|A2=turtle |B2=diamond_pickaxe
|Output=mining_turtle
|Output-link=Turtle
}}

Then, place it anywhere you want. Right click it and type 'edit MyFirstTurtleProgram'. You don't have to call it 'MyFirstTurtleProgram'; It can be whatever you want.
So, inside the file, type
turtle.refuel()
print("Refueled turtle!")
while turtle.detectDown() do
print("Digging down!")
turtle.digDown()
print("Going down!")
turtle.down()
print("Digging forward!")
turtle.dig()
print("Going forward!")
turtle.forward()
end

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

If you want a spiral drill formation that allows you to be able to retrieve the turtle after its done mining, do the same as above but when editing the program type:
turtle.refuel()
while turtle.detectDown() do
turtle.dig()
turtle.digDown()
turtle.down()
turtle.dig()
turtle.forward()
turtle.turnLeft()
end

== Explanation ==

The line turtle.refuel() refuels the Turtle so that it can move.

The line while turtle.detectDown() do makes the program run until there is no block underneath the Turtle.

The turtle.digDown() will make the Turtle dig down.

The part where it says turtle.forward() will make the Turtle go forward.

The line that says turtle.dig() will make the Turtle dig forward.

NOTE: this should be running on a mining turtle, or it wont work!

Template:Crafting grid

2013-06-03T06:16:34Z

AfterLifeLochie: Un-breaking the template.

<includeonly>
<div style="float:{{#if:{{{float|}}}|{{{float}}}|left}};"><div style="left:0px; top:0px; width:256px; height:132px; position:relative;">
<div style="left:0px; top:0px; width:256px; height:132px;">[[Image:Empty-crafting-table.png|256px|link=|alt=]]</div>

{{#if:{{{A1|}}}|<div style="left:14px; top:9px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{A1-image|}}}|{{{A1-image}}}|Grid_{{{A1}}}.png}}|32px|link={{#if:{{{A1-link|}}}|{{{A1-link}}}|{{{A1}}}}}|alt={{{A1}}}]]
</div>}}
{{#if:{{{A2|}}}|<div style="left:14px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{A2-image|}}}|{{{A2-image}}}|Grid_{{{A2}}}.png}}|32px|link={{#if:{{{A2-link|}}}|{{{A2-link}}}|{{{A2}}}}}|alt={{{A2}}}]]
</div>}}
{{#if:{{{A3|}}}|<div style="left:14px; top:81px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{A3-image|}}}|{{{A3-image}}}|Grid_{{{A3}}}.png}}|32px|link={{#if:{{{A3-link|}}}|{{{A3-link}}}|{{{A3}}}}}|alt={{{A3}}}]]
</div>}}

{{#if:{{{B1|}}}|<div style="left:50px; top:9px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{B1-image|}}}|{{{B1-image}}}|Grid_{{{B1}}}.png}}|32px|link={{#if:{{{B1-link|}}}|{{{B1-link}}}|{{{B1}}}}}|alt={{{B1}}}]]
</div>}}
{{#if:{{{B2|}}}|<div style="left:50px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{B2-image|}}}|{{{B2-image}}}|Grid_{{{B2}}}.png}}|32px|link={{#if:{{{B2-link|}}}|{{{B2-link}}}|{{{B2}}}}}|alt={{{B2}}}]]
</div>}}
{{#if:{{{B3|}}}|<div style="left:50px; top:81px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{B3-image|}}}|{{{B3-image}}}|Grid_{{{B3}}}.png}}|32px|link={{#if:{{{B3-link|}}}|{{{B3-link}}}|{{{B3}}}}}|alt={{{B3}}}]]
</div>}}

{{#if:{{{C1|}}}|<div style="left:86px; top:9px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{C1-image|}}}|{{{C1-image}}}|Grid_{{{C1}}}.png}}|32px|link={{#if:{{{C1-link|}}}|{{{C1-link}}}|{{{C1}}}}}|alt={{{C1}}}]]
</div>}}
{{#if:{{{C2|}}}|<div style="left:86px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{C2-image|}}}|{{{C2-image}}}|Grid_{{{C2}}}.png}}|32px|link={{#if:{{{C2-link|}}}|{{{C2-link}}}|{{{C2}}}}}|alt={{{C2}}}]]
</div>}}
{{#if:{{{C3|}}}|<div style="left:86px; top:81px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{C3-image|}}}|{{{C3-image}}}|Grid_{{{C3}}}.png}}|32px|link={{#if:{{{C3-link|}}}|{{{C3-link}}}|{{{C3}}}}}|alt={{{C3}}}]]
</div>}}

{{#if:{{{Output|}}}|<div style="left:202px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{Output-image|}}}|{{{Output-image}}}|Grid_{{{Output|}}}.png}}|32px|link={{#if:{{{Output-link|}}}|{{{Output-link}}}|{{{Output}}}}}|alt={{{Output}}}]]
</div>}}
{{#if:{{{OA|}}}|
<div style="left:210px; top:68px; width:16px; height:16px; position:absolute; overflow:hidden;">
<div style="left:{{#expr:-16 * (floor({{{OA|}}}/10) - 1)}}px; top:-8px; width:160px; height:16px; position:absolute;">
[[Image:GridNumbersCSS.png|160px|link={{#if:{{{Output-link|}}}|{{{Output-link}}}|{{{Output}}}}}|alt={{{Output}}}]]
</div>
</div>
<div style="left:222px; top:68px; width:16px; height:16px; position:absolute; overflow:hidden;">
<div style="left:{{#expr:-16 * (({{{OA|}}} - 1) mod 10)}}px; top:-8px; width:160px; height:16px; position:absolute;">
[[Image:GridNumbersCSS.png|160px|link={{#if:{{{Output-link|}}}|{{{Output-link}}}|{{{Output}}}}}|alt={{{Output}}}]]
</div>
</div>
}}
</div></div><br style="clear: both" />
</includeonly>
<noinclude>
This is the standard Minecraft crafting grid. The code is borrowed from the IndustrialCraft wiki.

Usage:<br />
<nowiki>
{{Crafting grid
|A1=Computer
|B3=Disk_Drive
|Output=Computer
}}
</nowiki>

Results in:

{{Crafting grid
|A1=Computer
|B3=Disk_Drive
|Output=Computer
}}
<br />
The name of the images should be in the form of "grid_<name of the item>.png".
E.g. the Computer image is named "Grid_Computer.png". Clicking on it will go to the page Computer.
</noinclude>

CCLights2

2013-06-03T06:14:29Z

AfterLifeLochie: {{Crafting Grid}} template needs custom link parameters even on |Cell rows.

[http://www.computercraft.info/forums2/index.php?/topic/10216-wip-cclights2-opensource-now-on-github/ CCLights2] is an Open Source Minecraft mod that adds a GPU peripheral, and monitors to suit your need. Unlike CCGPU, this mod does not use OpenGL, but it is Multiplayer Compatible.

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">GPU Peripheral</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

The GPU Peripheral needs to be placed next to a computer. It will autoconnect with the first monitor that connects with it, and will auto disconnect when the monitor detaches.

{{Crafting grid
|A1=iron ingot |B1=iron ingot |C1=iron ingot
|A2=Redstone |B2=Gold Ingot |C2=Redstone
|A3=Gold Ingot |B3=Gold Ingot |C3=Gold Ingot
|Output=CCLights2 GPU
|Output-image=Grid_CCLights2_GPU.gif
|Output-link=CCLights2
}}
</td></tr>

<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
CCLights2 Monitors
</td></tr>

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

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Normal Monitor</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

The basic Monitor. It sports an elegant resolution of 256x144.

{{Crafting grid
|A1=iron ingot |B1=iron ingot |C1=iron ingot
|A2=Redstone |B2=glass pane |C2=Redstone
|A3=Gold Ingot |B3=Gold Ingot |C3=Gold Ingot
|Output=CCLights2 Monitor
|Output-link=CCLights2
}}
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">External Monitor</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

An external Monitor. It suports a resolution up to 512x288.

{{Crafting grid
|A1=glass pane |B1=glass pane |C1=glass pane
|A2=glass pane |B2=CCLights2 Monitor |C2=glass pane
|A3=glass pane |B3=glass pane |C3=glass pane
|Output=CCLights2 External Monitor
|Output-link=CCLights2
|B2-link=CCLights2
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">RAM</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

Yep. You can craft more Ram.

{{Crafting grid
|A1=iron ingot |B1=iron ingot |C1=iron ingot
|A2=Redstone |C2=Redstone
|A3=Gold Ingot |B3=Gold Ingot |C3=Gold Ingot
|Output=CCLights2 Ram
|Output-link=CCLights2
}}
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tablet</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

Hold it in your hand! Go caving! Watch your life leech away as you stare into this tablet! NOTE: Watch out for Creepers.

{{Crafting grid
|A1=Gold Ingot |B1=iron ingot |C1=Gold Ingot
|A2=Redstone |B2=CCLights2 External Monitor |C2=Redstone
|A3=Gold Ingot |B3=iron ingot |C3=Gold Ingot
|Output=CCLights2 Tablet
|Output-link=CCLights2
|B2-link=CCLights2
}}
</td></tr>

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.fill({{Type|int}} red, {{Type|int}} green, {{Type|int}} blue)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Fills the binded texture with the color specified by <var>red</var>, <var>green</var>, and <var>blue</var></td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} textureid</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.createTexture({{Type|int}} width, {{Type|int}} height)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Creates a new texture and returns it.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} freeMemory</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getFreeMemory()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the amount of free memory the GPU has available.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} totalMemory</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getTotalMemory()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the amount of total memory. This is the equivalent of gpu.getFreeMemory()+gpu.getUsedMemory()</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} usedMemory</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getUsedMemory()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the amount of memory the GPU has already used.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.bindTexture({{Type|int}} textureid)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Binds the texture <var>textureid</var> for drawing. A <var>textureid</var> of 0 will rebind the screen texture.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">(Depreciated: Use gpu.plot instead) gpu.setColorRGB({{Type|int}} x, {{Type|int}} y, {{Type|int}} red, {{Type|int}} green, {{Type|int}} blue)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Plots the color <var>red</var>, <var>green</var>, and <var>blue</var> at the location <var>x</var>, <var>y</var>.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.plot({{Type|int}} x, {{Type|int}} y, {{Type|int}} red, {{Type|int}} green, {{Type|int}} blue)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Plots the color <var>red</var>, <var>green</var>, and <var>blue</var> at the location <var>x</var>, <var>y</var>.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.drawTexture({{Type|int}} textureid, {{Type|int}} x, {{Type|int}} y[, {{Type|int}} startX, {{Type|int}} startY, {{Type|int}} width, {{Type|int}} height[, {{Type|int}} red, {{Type|int}} green, {{Type|int}} blue] ])</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Draws the texture <var>textureid</var> at position <var>x</var>,<var>y</var> starting at <var>startX</var>,<var>startY</var> (Default: 0, 0) with the size of <var>width</var>,<var>height</var> (Default: Texture size) with the color <var>red</var>, <var>green</var>, and <var>blue</var> (Default: 255,255,255).</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.freeTexture({{Type|int}} textureid)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Removes the texture <var>textureid</var> from the GPU's memory.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.line({{Type|int}} red, {{Type|int}} green, {{Type|int}} blue, {{Type|int}} x0, {{Type|int}} y0, {{Type|int}} x1, {{Type|int}} y1)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the amount of free memory the GPU has available.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} width, {{Type|int}} height</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getTextureSize()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the size of the currently binded texture.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} width, {{Type|int}} height</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getSize()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Does the same as above.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.setTransparent({{Type|int}} textureid, {{Type|boolean}} transparent)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets the texture <var>textureid</var> as transparent</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.setTransparencyColor({{Type|int}} textureid, {{Type|int}} red, {{Type|int}} green, {{Type|int}} blue)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets the texture <var>textureid</var>'s transparency color to <var>red</var>, <var>green</var>, and <var>blue</var>. NOTE: This will not make that color transparent on a monitor. Sorry.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} red, {{Type|int}} green, {{Type|int}} blue</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">(Depreciated: Use gpu.getPixel instead) gpu.getColorRGB({{Type|int}} x, {{Type|int}} y)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the colors at the location <var>x</var>, <var>y</var>.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} red, {{Type|int}} green, {{Type|int}} blue</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getPixel({{Type|int}} x, {{Type|int}} y)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the colors at the location <var>x</var>, <var>y</var>.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.rectangle({{Type|int}} red, {{Type|int}} green, {{Type|int}} blue, {{Type|int}} x, {{Type|int}} y, {{Type|int}} width, {{Type|int}} height)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Draws an outlined rectangle with the color <var>red</var>, <var>green</var>, and <var>blue</var> at the location <var>x</var>, <var>y</var> with the size <var>width</var>, <var>height</var>.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.filledRectangle({{Type|int}} red, {{Type|int}} green, {{Type|int}} blue, {{Type|int}} x, {{Type|int}} y, {{Type|int}} width, {{Type|int}} height)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Draws a filled rectangle with the color <var>red</var>, <var>green</var>, and <var>blue</var> at the location <var>x</var>, <var>y</var> with the size <var>width</var>, <var>height</var>.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.setBPP((1,2 or 4))</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets the Bits Per Pixel for the GPU. This directly effects memory usage. When called, all textures will go black.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} bindedTextureid</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getBindedTexture()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the Binded Texture.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} BPP</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getBPP()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the Bits Per Pixel.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">({{Type|int}} nativePixelColor)*Bits Per Pixel</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">gpu.getNativePixel({{Type|int}} x, {{Type|int}} y)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the native pixel data for the location <var>x</var>, <var>y</var>. The BPP will be the number of values returned</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">(BETA) gpu.setPixels({{Type|int}} w, {{Type|int}} h, {{Type|int}} x, {{Type|int}} y[, {{Type|int}} red, {{Type|int}} green, {{Type|int}} blue]...)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets the pixels in the area of <var>w</var> and <var>h</var> starting at <var>x</var>,<var>y</var> using the rest of the given pixeldata. NOTE: This function is a BETA function. Do not expect it to work 100%!</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">(BETA) gpu.setPixelsYX({{Type|int}} w, {{Type|int}} h, {{Type|int}} x, {{Type|int}} y[, {{Type|int}} red, {{Type|int}} green, {{Type|int}} blue]...)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets the pixels in the area of <var>w</var> and <var>h</var> starting at <var>x</var>,<var>y</var> using the rest of the given pixeldata in the order of Y,X instead of X,Y. NOTE: This function is a BETA function. Do not expect it to work 100%!</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">nil</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">(BETA) gpu.flipTextureV({{Type|int}} textureid)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Flips the texture <var>textureid</var> verticaly. NOTE: This function is a BETA function. Do not expect it to work 100%!</td></tr>

</table>
[[Category:User Created Peripherals]]

OpenCCSensors

2013-06-03T06:11:15Z

AfterLifeLochie: (misfired:) For the love of god, {{Crafting Grid}} template NEEDS custom link parameters; stop creating BROKEN pages! >:|

[http://www.computercraft.info/forums2/index.php?/topic/5996-144-cc-147-openccsensors/ OpenCCSensors] is a new, open-source, up to date replacement for [[CcSensors|CcSensors (outdated)]], allowing monitoring and gathering information from the Minecraft environment - including players, entities, proximity, world info, IndustrialCraft 2, BuildCraft 2, liquids, inventories - and more!

OpenCCSensors comes with its own API, and automatically installs a new program for you at /ocs/programs/sensorview. sensorview is a handy program for very quickly looking at the information gathered from your sensors.

Forum thread and download: [http://www.computercraft.info/forums2/index.php?/topic/5996-144-cc-147-openccsensors/ OpenCCSensors]

http://www.youtube.com/watch?v=i8Bv7uKkIOM&feature=youtu.be

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sensor Peripheral</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

The Sensor Peripheral needs to be placed next to a computer and it has a single slot to insert a Sensor Card

{{Crafting grid
|A1=Obsidian |B1=Obsidian |C1=Obsidian
|A2=Redstone |B2=Obsidian |C2=Redstone
|A3=Stone |B3=Stone |C3=Stone
|Output=Sensor Peripheral
|Output-link=OpenCCSensors
}}
<table style="width: 100%; border-spacing: 0px;">

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">os.loadAPI("ocs/apis/sensor")</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Load the sensor API</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">mySensor = sensor.wrap(side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the wrapped sensor on the side specified.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">mySensor.getTargets()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a a table of all the targets for mySensor, where the keys are used as a numerical index, and the values are each a table of basic details.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">mySensor.getTargetDetails(key)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a table of full details for that particular target from the sensor mySensor - where the the "key" is the key returned from getTargets()</td></tr>

</table>
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Gauge Peripheral</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

The Gauge Peripheral can be placed onto the side of certain machines to get instant readings from them. Right now this only supports Batboxes, MFE's, MFSU, Mass fabricators and Nuclear reactors. We hope to expand this in the future as well as offer an API to re-program the gauge from a computer.

{{Crafting grid
|A1=glass_pane |B1=Redstone |C1=Monitor
|Output=Gauge Peripheral
|Output-link=OpenCCSensors
}}

</td></tr>
</table>

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Proximity Sensor Block</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">

This block outputs a redstone signal if players/mobs are within 16 blocks. The strength of the signal depends on how close the entity is to the block.

This block has 3 different modes: "Any Living Entity", "Any Player" or "Owner Only". To switch between modes, the owner of the block must right click on the block.

{{Crafting grid
|A1= |B1= |C1=
|A2=Comparator |B2=Proximity Sensor Card MKIV |C2=Comparator
|A3=Redstone |B3=Block of Iron |C3=Redstone
|Output=Proximity Sensor Block
|Output-link=OpenCCSensors
|B2-link=OpenCCSensors
}}
</td></tr>
</table>
<br />
<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
OpenCCSensors Sensor Cards
</td></tr>

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Inventory Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Inventory Sensor Card is capable of reading inventories of any chests or machines around the sensor. It gives full information about what item is in each slot.

{{Crafting grid
|A1=Redstone |B1=chest |C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Inventory Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Proximity Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Proximity Sensor Card is capable of detecting players and entities within it's range.

{{Crafting grid
|A1=Redstone |B1=pressure_plate |C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Proximity Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Machine Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Machine Sensor Card can read information from IC2 devices.

{{Crafting grid
|A1=Redstone |B1=Redstone |C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Buildcraft Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Power Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Power Sensor Card can read power information from IC2 and Applied Energistics devices.

{{Crafting grid
|A1=Redstone |B1=Coal |C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Power Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tank Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Tank sensor card is far more powerful than it first seems. This card not only reads actual tanks, but reads internal tanks within a variety of different machines, such as:

Railcraft: Iron Tanks, Buildcraft: Tanks, Thermal Expansion: Aqueous Accumulator, Thermal Expansion: Igneous Extruder, Thermal Expansion: Glacial Precipitator, Thermal Expansion: Liquid Transposer, Thermal Expansion: Magma Crucible, Thermal Expansion: Magmatic Engine, Thermal Expansion: Steam Engine, Industrial Craft: Geothermal Generator, Thaumcraft: Crucible, Buildcraft: Tank, Buildcraft: Combustion Engine, Buildcraft: Pump, Buildcraft: Refinery, Forestry: Biogas Engine, Forestry: Fermenter, Forestry: Still, Forestry: Bottler, Forestry: Raintank, Forestry: Bio Generator, Forestry: Carpenter, Forestry: Moistener, Forestry: Squeezer, Forestry: Thermonic Fabricator, Extra Bees: Analyser, Extra Bees: Purifier, Extra Bees: Synthesizer, Extra Bees: Genepool, Extra Bees: Splicer, Railcraft: Hobbyist's Steam Engine, Railcraft: Commercial Steam Engine, Railcraft: Industrial Steam Engine, GregTech: Quantum Tank, GregTech: Thermal Generator

{{Crafting grid
|A1=Redstone |B1=Bucket |C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Liquid Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">World Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The World Sensor Card is able to tell the time, weather, and more about the world.

{{Crafting grid
|A1=Redstone |B1=ender_pearl |C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=World Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Dropped Item Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Dropped Item Sensor Card is able to locate and identify dropped items.

{{Crafting grid
|A1=Redstone |B1=slime_ball |C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Dropped Item Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sign Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Sign Sensor Card is capable of reading signs within it's range.

{{Crafting grid
|A1=Redstone |B1=sign|C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Sign Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Minecart Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Minecart Sensor Card can detect minecarts in the area and give basic information about them

{{Crafting grid
|A1=Redstone |B1=Minecart|C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Minecart Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sonic Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Sonic Sensor Card can detect blocks in the area and report if they're solid or liquid.

{{Crafting grid
|A1=Redstone |B1=Jukebox|C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Sonic Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Crop Sensor Card</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The crop sensor card can detect the growth status of crops within range. IndustrialCraft2 crops are also supported (+extra!)

{{Crafting grid
|A1=Redstone |B1=Wheat|C1=Redstone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=paper |B3=paper |C3=paper
|Output=Crop Sensor Card
|Output-link=OpenCCSensors
}}
</td></tr>

</table>

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Range Extension Antenna</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Range Extension Antenna is used to upgrade sensor cards to Mk1, Mk2, and Mk3.

{{Crafting grid
|B1=redstone_torch
|A2=stone |B2=Redstone |C2=stone
|A3=stone |B3=iron_ingot |C3=stone
|Output=Range Extension Antenna
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Signal Amplifier</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Signal Amplifier is used to upgrade sensor cards to Mk3 and Mk4.

{{Crafting grid
|A1=stone |B1=Gold_Ingot|C1=stone
|A2=Redstone |B2=Redstone |C2=Redstone
|A3=stone |B3=Gold_Ingot |C3=stone
|Output=Signal Amplifier
|Output-link=OpenCCSensors
}}
</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">Advanced Amplifier</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The Advanced Amplifier is used to upgrade sensor cards to Mk4.

{{Crafting grid
|A1=iron_ingot |B1=Gold_Ingot|C1=iron_ingot
|A2=Redstone |B2=Diamond |C2=Redstone
|A3=iron_ingot |B3=Gold_Ingot |C3=iron_ingot
|Output=Advanced Amplifier
|Output-link=OpenCCSensors
}}
</td></tr>

</table>

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">'''Mk 1'''</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">The recipes for Mk 1 sensors are all different. (See above sensor card lists)
Special-type sensor cards (Currently only the World Sensor Card) only exist as Mk 1, as they do not have a range.

'''Ranges:'''

<table>
<tr><td>Type</td><td>Range</td><td>Sensor types</td></tr>
<tr><td>Block<td>'''1''' block away (3x3x3)</td><td>
[[File:Grid_Inventory_Sensor_Card.png|24px|Inventory Sensor]]
[[File:Grid_Industrial_Craft_2_Sensor_Card.png|24px|Industrial Craft 2 Sensor]]
[[File:Grid_Buildcraft_Sensor_Card.png|24px|Buildcraft Sensor]]
[[File:Grid_Liquid_Sensor_Card.png|24px|Liquid Sensor]]
[[File:Grid_Sign_Sensor_Card.png|24px|Sign Sensor]]
[[File:Grid_Thaumcraft_Sensor_Card.png|24px|Thaumcraft Sensor]]
[[File:Grid_Sonic_Sensor_Card.png|24px|Sonic Sensor]]
[[File:Grid_Crop_Sensor_Card.png|24px|Crop Sensor]]
</td></tr>
<tr><td>Entity<td>'''4''' block-radius sphere</td><td>
[[File:Grid_Proximity_Sensor_Card.png|24px|Proximity Sensor]]
[[File:Grid_Dropped_Item_Sensor_Card.png|24px|Dropped Item Sensor]]
[[File:Grid_Minecart_Sensor_Card.png|24px|Minecart Sensor]]
</td></tr>
<tr><td>Special</td><td>N/A</td><td>
[[File:Grid_World_Sensor_Card.png|24px|World Sensor]]
</td></tr>
</table>

</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">'''Mk 2'''</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Mk 2 is the first upgrade to sensor cards. Simply combine a Range Extension Antenna with a Mk 1 sensor card (The recipe is shapeless)

{{Crafting grid
|A1=Inventory Sensor Card |B1=Range Extension Antenna
|Output=Inventory Sensor Card Mk2
|Output-link=OpenCCSensors
|A1-link=OpenCCSensors
|B1-link=OpenCCSensors
}}

'''Ranges:'''
<table>
<tr><td>Type</td><td>Range</td><td>Sensor types</td></tr>
<tr><td>Block<td>'''3''' blocks away (7x7x7)</td><td>
[[File:Grid_Inventory_Sensor_Card.png|24px|Inventory Sensor]]
[[File:Grid_Industrial_Craft_2_Sensor_Card.png|24px|Industrial Craft 2 Sensor]]
[[File:Grid_Buildcraft_Sensor_Card.png|24px|Buildcraft Sensor]]
[[File:Grid_Liquid_Sensor_Card.png|24px|Liquid Sensor]]
[[File:Grid_Sign_Sensor_Card.png|24px|Sign Sensor]]
[[File:Grid_Thaumcraft_Sensor_Card.png|24px|Thaumcraft Sensor]]
[[File:Grid_Sonic_Sensor_Card.png|24px|Sonic Sensor]]
[[File:Grid_Crop_Sensor_Card.png|24px|Crop Sensor]]
</td></tr>
<tr><td>Entity<td>'''12''' block-radius sphere</td><td>
[[File:Grid_Proximity_Sensor_Card.png|24px|Proximity Sensor]]
[[File:Grid_Dropped_Item_Sensor_Card.png|24px|Dropped Item Sensor]]
[[File:Grid_Minecart_Sensor_Card.png|24px|Minecart Sensor]]
</td></tr>
</table>

</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">'''Mk 3'''</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Mk 3 is the second upgrade to sensor cards. Note that the recipe is no longer shapeless.

{{Crafting grid
|A1=Range Extension Antenna |B1=Inventory Sensor Card Mk2|C1=Range Extension Antenna
|B2=Signal Amplifier
|Output=Inventory Sensor Card Mk3
|Output-link=OpenCCSensors
|A1-link=OpenCCSensors
|B1-link=OpenCCSensors
|B2-link=OpenCCSensors
|C1-link=OpenCCSensors
}}

'''Ranges:'''
<table>
<tr><td>Type</td><td>Range</td><td>Sensor types</td></tr>
<tr><td>Block<td>'''5''' blocks away (11x11x11)</td><td>
[[File:Grid_Inventory_Sensor_Card.png|24px|Inventory Sensor]]
[[File:Grid_Industrial_Craft_2_Sensor_Card.png|24px|Industrial Craft 2 Sensor]]
[[File:Grid_Buildcraft_Sensor_Card.png|24px|Buildcraft Sensor]]
[[File:Grid_Liquid_Sensor_Card.png|24px|Liquid Sensor]]
[[File:Grid_Sign_Sensor_Card.png|24px|Sign Sensor]]
[[File:Grid_Thaumcraft_Sensor_Card.png|24px|Thaumcraft Sensor]]
[[File:Grid_Sonic_Sensor_Card.png|24px|Sonic Sensor]]
[[File:Grid_Crop_Sensor_Card.png|24px|Crop Sensor]]
</td></tr>
<tr><td>Entity<td>'''20''' block-radius sphere</td><td>
[[File:Grid_Proximity_Sensor_Card.png|24px|Proximity Sensor]]
[[File:Grid_Dropped_Item_Sensor_Card.png|24px|Dropped Item Sensor]]
[[File:Grid_Minecart_Sensor_Card.png|24px|Minecart Sensor]]
</td></tr>
</table>

</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">'''Mk 4'''</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Mk 4 is the highest tier of sensor card upgrades

{{Crafting grid
|B1=Range Extension Antenna
|A2=Range Extension Antenna |B2=Inventory Sensor Card Mk3|C2=Range Extension Antenna
|A3=Signal Amplifier|B3=Advanced Amplifier|C3=Signal Amplifier
|Output=Inventory Sensor Card Mk4
|Output-link=OpenCCSensors
|B1-link=OpenCCSensors
|A2-link=OpenCCSensors
|B2-link=OpenCCSensors
|C2-link=OpenCCSensors
|A3-link=OpenCCSensors
|B3-link=OpenCCSensors
|C3-link=OpenCCSensors
}}

'''Ranges:'''
<table>
<tr><td>Type</td><td>Range</td><td>Sensor types</td></tr>
<tr><td>Block<td>'''7''' blocks away (15x15x15)</td><td>
[[File:Grid_Inventory_Sensor_Card.png|24px|Inventory Sensor]]
[[File:Grid_Industrial_Craft_2_Sensor_Card.png|24px|Industrial Craft 2 Sensor]]
[[File:Grid_Buildcraft_Sensor_Card.png|24px|Buildcraft Sensor]]
[[File:Grid_Liquid_Sensor_Card.png|24px|Liquid Sensor]]
[[File:Grid_Sign_Sensor_Card.png|24px|Sign Sensor]]
[[File:Grid_Thaumcraft_Sensor_Card.png|24px|Thaumcraft Sensor]]
[[File:Grid_Sonic_Sensor_Card.png|24px|Sonic Sensor]]
[[File:Grid_Crop_Sensor_Card.png|24px|Crop Sensor]]
</td></tr>
<tr><td>Entity<td>'''28''' block-radius sphere</td><td>
[[File:Grid_Proximity_Sensor_Card.png|24px|Proximity Sensor]]
[[File:Grid_Dropped_Item_Sensor_Card.png|24px|Dropped Item Sensor]]
[[File:Grid_Minecart_Sensor_Card.png|24px|Minecart Sensor]]
</td></tr>
</table>

</td></tr>

</table>

= Usage Examples =
{{Example
|desc=List all available targets on a Proximity Sensor on the left of the Computer.
|code=os.loadAPI("ocs/apis/sensor")
local prox = sensor.wrap("left")
print(textutils.serialize(prox.getTargets()))
|output=A huge blob of text with all nearby available targets to the sensor, and some basic details.
}}
{{Example
|desc=Turn on a Redstone lamp when a player is within a certain distance from it. The sensor is placed to the left of the computer and the lamp is placed on top of the computer.
|code=
os.loadAPI("ocs/apis/sensor")

-- the location of the redstone lamp relative to the sensor
local offset = {
X = 1,
Y = 1,
Z = 0
}

-- how close a player has to be to activate the lamp
local radius = 5

-- find the distance from the player position to the offset
function distance(pos)
local xd = pos.X - offset.X
local yd = pos.Y - offset.Y
local zd = pos.Z - offset.Z
return math.sqrt(xd*xd + yd*yd + zd*zd)
end

local proximity = sensor.wrap("left")
while true do
local signal = false
local targets = proximity.getTargets()
for k, v in pairs(targets) do
if distance(v.Position) < radius then
signal = true
end
end
rs.setOutput("top", signal)
end
}}

[[Category:User_Created_Peripherals]][[Category:Unofficial_APIs]]

Template:Crafting grid

2013-06-03T06:09:57Z

AfterLifeLochie: Reverted edits by AfterLifeLochie (talk) to last revision by Thesbros

<includeonly>
<div style="float:{{#if:{{{float|}}}|{{{float}}}|left}};"><div style="left:0px; top:0px; width:256px; height:132px; position:relative;">
<div style="left:0px; top:0px; width:256px; height:132px;">[[Image:Empty-crafting-table.png|256px|link=|alt=]]</div>

{{#if:{{{A1|}}}|<div style="left:14px; top:9px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{A1-image|}}}|{{{A1-image}}}|Grid_{{{A1}}}.png}}|32px|link={{#if:{{{A1-link|}}}|{{{A1-link}}}|{{{A1}}}}}|alt={{{A1}}}]]
</div>}}
{{#if:{{{A2|}}}|<div style="left:14px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{A2-image|}}}|{{{A2-image}}}|Grid_{{{A2}}}.png}}|32px|link={{#if:{{{A2-link|}}}|{{{A2-link}}}|{{{A2}}}}}|alt={{{A2}}}]]
</div>}}
{{#if:{{{A3|}}}|<div style="left:14px; top:81px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{A3-image|}}}|{{{A3-image}}}|Grid_{{{A3}}}.png}}|32px|link={{#if:{{{A3-link|}}}|{{{A3-link}}}|{{{A3}}}}}|alt={{{A3}}}]]
</div>}}

{{#if:{{{B1|}}}|<div style="left:50px; top:9px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{B1-image|}}}|{{{B1-image}}}|Grid_{{{B1}}}.png}}|32px|link={{#if:{{{B1-link|}}}|{{{B1-link}}}|{{{B1}}}}}|alt={{{B1}}}]]
</div>}}
{{#if:{{{B2|}}}|<div style="left:50px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{B2-image|}}}|{{{B2-image}}}|Grid_{{{B2}}}.png}}|32px|link={{#if:{{{B2-link|}}}|{{{B2-link}}}|{{{B2}}}}}|alt={{{B2}}}]]
</div>}}
{{#if:{{{B3|}}}|<div style="left:50px; top:81px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{B3-image|}}}|{{{B3-image}}}|Grid_{{{B3}}}.png}}|32px|link={{#if:{{{B3-link|}}}|{{{B3-link}}}|{{{B3}}}}}|alt={{{B3}}}]]
</div>}}

{{#if:{{{C1|}}}|<div style="left:86px; top:9px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{C1-image|}}}|{{{C1-image}}}|Grid_{{{C1}}}.png}}|32px|link={{#if:{{{C1-link|}}}|{{{C1-link}}}|{{{C1}}}}}|alt={{{C1}}}]]
</div>}}
{{#if:{{{C2|}}}|<div style="left:86px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{C2-image|}}}|{{{C2-image}}}|Grid_{{{C2}}}.png}}|32px|link={{#if:{{{C2-link|}}}|{{{C2-link}}}|{{{C2}}}}}|alt={{{C2}}}]]
</div>}}
{{#if:{{{C3|}}}|<div style="left:86px; top:81px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{C3-image|}}}|{{{C3-image}}}|Grid_{{{C3}}}.png}}|32px|link={{#if:{{{C3-link|}}}|{{{C3-link}}}|{{{C3}}}}}|alt={{{C3}}}]]
</div>}}

{{#if:{{{Output|}}}|<div style="left:202px; top:45px; width:32px; height:32px; position:absolute;">
[[Image:{{#if:{{{Output-image|}}}|{{{Output-image}}}|Grid_{{{Output|}}}.png}}|32px|link={{#if:{{{Output-link|}}}|{{{Output-link}}}|{{{Output}}}}}|alt={{{Output}}}]]
</div>}}
{{#if:{{{OA|}}}|
<div style="left:210px; top:68px; width:16px; height:16px; position:absolute; overflow:hidden;">
<div style="left:{{#expr:-16 * (floor({{{OA|}}}/10) - 1)}}px; top:-8px; width:160px; height:16px; position:absolute;">
[[Image:GridNumbersCSS.png|160px|link={{#if:{{{Output-link|}}}|{{{Output-link}}}|{{{Output}}}}}|alt={{{Output}}}]]
</div>
</div>
<div style="left:222px; top:68px; width:16px; height:16px; position:absolute; overflow:hidden;">
<div style="left:{{#expr:-16 * (({{{OA|}}} - 1) mod 10)}}px; top:-8px; width:160px; height:16px; position:absolute;">
[[Image:GridNumbersCSS.png|160px|link={{#if:{{{Output-link|}}}|{{{Output-link}}}|{{{Output}}}}}|alt={{{Output}}}]]
</div>
</div>
}}
</div></div><br style="clear: both" />
</includeonly>
<noinclude>
This is the standard Minecraft crafting grid. The code is borrowed from the IndustrialCraft wiki.

Usage:<br />
<nowiki>
{{Crafting grid
|A1=console
|B3=disk drive
|Output=console
}}
</nowiki>

Results in:

{{Crafting grid
|A1=console
|B3=disk drive
|Output=console
}}
<br />
The name of the images should be in the form of "grid_<name of the item>.png".
E.g. the console image is named "grid_console.png". Clicking on it will go to the page console.
</noinclude>

Template:Crafting grid

2013-06-03T06:09:28Z

AfterLifeLochie: For the love of god, {{Crafting Grid}} template NEEDS custom link parameters; stop creating BROKEN pages! >:|

Read

2013-06-01T18:44:08Z

AfterLifeLochie: Added history argument, clarified doesn't actually return 'nil'...

{{lowercase}}
{{Function
|name=read
|args= <nowiki>[</nowiki> [[char (type)|char]] replacement <nowiki>[, </nowiki>[[table (type)|table]] history<nowiki>]</nowiki> <nowiki>]</nowiki>
|api=
|returns=[[string (type)|string]] The user's input
|addon=ComputerCraft
|desc=Lets you get input of the user.
|examples=
{{Example
|desc=Prints what the user wrote.
|code=[[print]] (read())
|output=Whatever the user wrote.
}}
{{Example
|desc=Ask for a Password and lets the user enter it. The letters are hidden by '*'.
|code=local password = "computercraft"
[[print]] ("Enter Password")
local input = read("*")
if input == password then
[[print]]("Password is correct. Access granted.")
else
[[print]]("Password is incorrect. Access denied.")
end
|output=Enter Password
<nowiki>*******</nowiki>
Password is correct. Access granted. or Password is incorrect. Access denied.
}}
}}

[[Category:Tutorials]]

Bit.tonumb

2013-06-01T18:37:12Z

AfterLifeLochie: Now perhaps jesusthekiller won't submit false bugreports.

{{lowercase}}

{{Deprecated
|type=This function
|version=1.42
}}

{{Function
|name=bit.tonumb
|args={{Type|table}} bit_tbl
|api=bit
|returns={{Type|int}} the number resulting from the conversion of <var>bit_tbl</var> from binary
|addon=ComputerCraft
|desc=Converts an array (numerically-indexed table) containing binary bit values to a number (the inverse of [[bit.tobits]])
|examples=
{{Example
|desc=Convert the binary representation 10010 into its corresponding value, 18
|code=t = {}<br>t[1] = 0<br>t[2] = 1<br>t[3] = 0<br>t[4] = 0<br>t[5] = 1<br>print(bit.tonumb(t))
|output=18
}}
}}

[[Category:API_Functions]]

Bit.tobits

2013-06-01T18:36:17Z

AfterLifeLochie: Now perhaps jesusthekiller won't submit false bugreports.

{{lowercase}}

{{Deprecated
|type=This function
}}

{{Function
|name=bit.tobits
|args={{Type|int}} n
|api=bit
|returns={{Type|table}} the bits making up the value <var>n</var>, with entries up to the most-significant 1 bit in <var>n</var>
|addon=ComputerCraft
|desc=Converts a number to an array (numerically-indexed table) containing the corresponding binary bit values (the inverse of [[bit.tonumb]])
|examples=
{{Example
|desc=Convert the number 18 into its binary representation (10010)
|code=for k, v in pairs(bit.tobits(18)) do print(k, ", ", v) end
|output=1, 0<br>2, 1<br>3, 0<br>4, 0<br>5, 1
}}
}}
As of ComputerCraft 1.42 the bit library has moved to Java code, and as such this function is no longer required or included.

[[Category:API_Functions]]

Bit (API)

2013-06-01T18:35:48Z

AfterLifeLochie: Now perhaps jesusthekiller won't submit false bugreports.

The Bit API is for manipulating numbers using bitwise binary operations.

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.blshift]]({{Type|int}} n, {{Type|int}} bits)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Shifts a number left by a specified number of bits.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.brshift]]({{Type|int}} n, {{Type|int}} bits)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Shifts a number right arithmetically by a specified number of bits.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.blogic_rshift]]({{Type|int}} n, {{Type|int}} bits)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Shifts a number right logically by a specified number of bits.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.bxor]]({{Type|int}} m, {{Type|int}} n)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Computes the bitwise exclusive OR of two numbers.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.bor]]({{Type|int}} m, {{Type|int}} n)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Computes the bitwise inclusive OR of two numbers.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.band]]({{Type|int}} m, {{Type|int}} n)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Computes the bitwise AND of two numbers.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.bnot]]({{Type|int}} n)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Computes the bitwise NOT of a number.</td></tr>
</table>

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

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

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|table}} bit_tbl</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.tobits]]({{Type|int}} n)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Converts a number to an array (numerically-indexed table) containing the corresponding binary bit values.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">{{Type|int}} value</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[bit.tonumb]]({{Type|table}} bit_tbl)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Converts an array (numerically-indexed table) of 0 and 1 values representing a number in binary into that number.</td></tr>
</table>

[[Category:APIs]]

Template:Deprecated

2013-06-01T18:34:28Z

AfterLifeLochie: Created clear deprecation template.

{{msgbox
| title = {{{type}}} {{#if:{{{plural|}}}|have|has}} been deprecated.
| text = {{{type}}} {{#if:{{{plural|}}}|have|has}} been removed from ComputerCraft{{#if:{{{version|}}}| in version {{{version}}}}}.
}}

Floppy Disk

2013-05-24T19:25:57Z

AfterLifeLochie: Implement {{BlocksItemsList}}

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

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

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

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

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

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

Wired Modem

2013-05-24T19:25:20Z

AfterLifeLochie: Implement {{BlocksItemsList}}

{{NeedsWork|Needs correction and more examples -alekso56)}}
:''This page is for the Modem blocks. For the modem API, see [[Modem_(API)|Modem (API)]]''
{{Block
|name=Cable Modem
|image=
|id=???
|damage-value= ???
|is-peripheral=Yes
|peripheral-api=Modem (API)
}}
Modems are blocks which can be used to transfer data between [[Computer|computers]], using the [[Rednet_(API)|Rednet API]] or the [[Modem_(API)|Modem API]].
To place a modem on a side of a computer, right-click to place the modem while sneaking.
To use the modems, you need to connect the modems to each other by placing cables.
==Recipes==

{{Crafting grid
| B1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|B3=Stone
|Output=Networking_Cable
|OA=6}}
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=Redstone |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=Wired_Modem
}}

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

== Example 2 (Modem and peripheral) ==
* If you want to use a modem to communicate with a peripheral you might want to take a look at the [[Peripheral_(API)#Remote_Peripherals_using_Networking_Cables|Peripheral API]]

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

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

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

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

{{BlocksItemsList}}

Wired Modem

2013-05-24T19:25:13Z

AfterLifeLochie: Implement {{BlocksItemsList}}

Wireless Modem

2013-05-24T19:25:00Z

AfterLifeLochie: Implement {{BlocksItemsList}}

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

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

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

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

As of the 1.5 update for ComputerCraft, Wireless Modems can send messages on specific channels.

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

== Example (Modem API)==
* Place 2 computers and add modems to them by clicking the right mouse button while sneaking.
* Access them, and start Lua.
* Once Lua has started, wrap your modem using peripheral.wrap() (something like "modem = peripheral.wrap("<side of modem>")
* Type "[[modem_(API)|modem.open]] (<A modem port number, anything from 1 to 65535>)" on one computer.
* Check if there exists a connection: a dim, red light should be found on the modem.
* Now, type "[[modem_(API)|modem.transmit]] (<Same number as above>, <Also the same number>, 'Your message')" on the other computer. This should send your message to all computers connected.
* Opening the first computer should show the message written on the second computer.

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

For this example, we have a Modem connected to the top of our [[Computer]], we are going to open channel 5:

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

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

{{BlocksItemsList}}

Turtle

2013-05-24T19:24:53Z

AfterLifeLochie: Implement {{BlocksItemsList}}

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

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

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

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

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

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

==Floppy Disks and Peripherals==
Turtles do not have a built-in [[Disk Drive]]. As such, they need a [[Disk Drive]] placed beside them to access [[Floppy Disk|Floppy Disks]]. However, if the Turtle is of the Wireless family, the [[Disk Drive]] (and other peripherals) must be placed on a side other than the side the [[Wireless Modem|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|Printers]] can be interacted using the peripheral API.

==Power source==
Turtles require fuel to operate - this means Turtles must be powered from any item that works in a regular furnace, like coal and lava. The turtle gains 0.6 "movement" per half second the fuel would have burnt in a furnace. The Turtle can move 1 block for each fuel count it has, for example, coal yields 96 block movements. For more information, go to the [[Turtle.refuel]] page.

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

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

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

==Crafting==
Turtles with a [http://www.minecraftwiki.net/wiki/Crafting_Table Crafting Table] can craft items if they have the correct materials to do so, and all other slots outside the crafting-zone are empty.

==Melee==
Turtles equipped with a [[diamond sword]] can attack players and mobs. When a Turtle kills a mob it will leave the experience orbs on the ground, but add the loot to its inventory. Turtles can also attack with any tool, where the [[diamond axe]] is the second best after the [[diamond sword]].

==Inventory Interaction==
Turtles can interact with blocks that have inventories. This includes chests, furnaces, [[Printer|printers]] and even blocks with inventories in other mods. (This means a turtle cannot interact with a player's inventory). Turtles can interact with such inventories by using [[Turtle.suck|turtle.suck, turtle.suckDown, turtle.suckUp]] (To retrieve the first item in the inventory. The turtle finds the first item by scanning the first row from left to right, then the second row from left to right, ect.) Turtles can also place items inside inventories, by using [[Turtle.drop|turtle.drop, turtle.dropUp, turtle.dropDown]], which places items on the first item slot available (Using the same system as the one described for retrieving items).

In special inventories, with just a few slots on the top or bottom, for example furnaces, you can specify which slot to place an item in by positioning the turtle in the corresponding location to the front face of the inventory. For example in a furnace, you would use a turtle at the bottom of the furnace for it to place fuel in the furnace, a turtle at the top to place objects to smelt, and a turtle to the right to retrieve the smelted objects (Note that you can do this with just 1 turtle moving around)

==Recipes==

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

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

Printer

2013-05-24T19:24:38Z

AfterLifeLochie: Implement {{BlocksItemsList}}

{{Block
|name=Printer
|image=Iso_Printer.png
|id=4094
|damage-value=Un-used.
|is-peripheral=Yes
|peripheral-api=Printer (API)
}}
The printer was added in the [[ComputerCraft]] 1.42 update. The printer is placed next to a computer, and allows for printing text onto paper with any color of ink.

== Recipes ==
Using the printer will produce [[Printed Page]]. These pages can be used in two different shapeless recipes: [[Printed Pages]] and [[Printed Book]]. Using any of these when on your hotbar will allow you to view their contents (much like with signed books in vanilla).
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=Redstone |C2=stone
|A3=stone |B3=Ink_Sac |C3=stone
|Output=printer
}}
{{Crafting grid
|B1=printed_page
|A2=String |B2=printed_page
|B3=printed_page
|Output=printed_pages
}}
{{Crafting grid
|A1=printed_pages |B1=printed_pages |C1=printed_pages
|A2=printed_page |B2=printed_page |C2=printed_page
|B3=String
|Output=printed_pages
}}
{{Crafting grid
|A1=printed_page |B1=printed_page |C1=printed_page
|A2=String |B2=Leather
|Output=printed_book_
}}
{{Crafting grid
|A1=printed_pages |B1=printed_pages |C1=printed_pages
|A2=printed_page |B2=printed_page |C2=printed_page
|A3=String |B3=Leather
|Output=printed_book_
}}
== Usage ==
To use a printer, place it adjacently but not diagonally next to a computer (left, right, top, bottom, front, or back side). Place any color ink in the single left slot, and paper in any of the top slots.

If you are using blocks to pull/insert items from the printer the different slots are available from these sides:
Paper tray is accessible from the top, output paper tray is accessible from the front or bottom, and the ink slot is accessible from the back or sides.

== Printer API ==
The printer API allows programs to interact in various ways with the printer. In order for these functions to become available, you must first wrap the printer as a peripheral using [[peripheral.wrap]]().
<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Printer API
</td></tr>

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

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.getPaperLevel]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the amount of paper available in the paper tray.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.newPage]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Starts a new page. Returns true if page got started, false if not.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.endPage]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Ends the page and prints the page to the output tray. Returns true if page was ended, false if not.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.write]]([[string]] text)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Writes text to the paper, works the same way as [[term.write|term.write()]]</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.setPageTitle]]([[string]] title)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets the title of the page.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.getInkLevel]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the amount of ink in the ink slot.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.getCursorPos]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the coordinates of the cursor on the paper, works the same way as [[term.getCursorPos|term.getCursorPos()]]</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.setCursorPos]]([[int (type)|int]] x, [[int (type)|int]] y)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets the cursor pos, works the same way as [[term.setCursorPos|term.setCursorPos()]]</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[printer.getPageSize]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the size of the paper, works the same way as [[term.getSize|term.getSize()]]</td></tr>
</table>

[[File:PrinterGUI.png|thumb|256px|GUI of the Printer]]

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

Advanced Monitor

2013-05-24T19:24:26Z

AfterLifeLochie: Implement {{BlocksItemsList}}

{{Block
|name=Advanced Monitor
|image=Iso_Advanced_Monitor.png
|id=4094
|damage-value=Un-used (clarify?)
|is-peripheral=Yes
|peripheral-api=Term (API)
}}
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 directly using [[peripheral.call]](), or, wrap the monitor using the [[Peripheral_(API)|Peripheral API]]. Wrapped monitors provide all functions listed in the [[Term_(API)|Term API]], with the exception of [[Monitor.setTextScale|monitor.setTextScale(size)]], which is native to monitors only.

For this example, we have 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!")

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

Monitor

2013-05-24T19:23:51Z

AfterLifeLochie: Implement {{BlocksItemsList}}

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

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

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

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

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

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

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

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

Disk Drive

2013-05-24T19:23:37Z

AfterLifeLochie: Implement {{BlocksItemsList}}

{{Block
|name=Disk Drive
|image=Iso_DiskDrive.png
|id=4094
|damage-value=Un-used.
|is-peripheral=Yes
|peripheral-api=Disk (API)
}}
The Disk Drive arrived with the [[ComputerCraft]] 1.2 update and with that also came [[Floppy Disk]]s. The Disk Drive is an object that, when placed adjacently but not diagonally next to a [[computer]], does the same as a disk drive for real computers in the real world would do: they allow the access to portable data storage devices ([[Floppy Disk]]s).
== Recipe ==
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=Redstone |C2=stone
|A3=stone |B3=Redstone |C3=stone
|Output=Disk_Drive
}}
== Usage ==
[[File:Computer_w_DiskDrive_w_Monitor.png|frame|428x241px|right|A 2x2 [[Monitor]], connected to a [[Computer]], with a [[Disk Drive]] connected.]]
[[File:DiskDriveGUI.png|thumb|350px|GUI of the Disk Drive]]
To use a disk drive, place it adjacently but not diagonally next to a computer (left, right, top, bottom, front, or back side). Insert a disk by right-clicking on the disk drive and placing the disk in the slot above the inventory.

If you sneak and right click the disk drive with a disk/music disc in 1.4+ it will place it into it without needing to open the disk drives interface.

== API ==
See [[Disk (API)]] for the disk API.

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