ComputerCraft Wiki - User contributions [en]

Textutils.urlEncode

2012-11-05T01:44:06Z

Wukl:

{{lowercase}}
{{Function
|name=textutils.urlEncode
|args= [[String (type)|string]]
|returns=A string safe for use on the internet
|api=textutils
|addon=ComputerCraft
|desc=Replaces certain characters in a string to make it safe for use on the internet. Note that it is a string function and will even replace characters that are allowed in URLs. Use this only for text to be inserted in an URL, not the URL itself.
|examples=
{{Example
|desc=Create a safe string from another string full of invalid characters. '''This is incorrect usage!'''
|code=<pre>sUnsafe = "http://example.com/?view=€ @!! 3-g_dvv[gf"
sSafe = textutils.urlEncode(sUnsafe)
print(sSafe)</pre>
|output=(to be specified - I don't have CC on this computer)
}}
{{Example
|desc=Create a safe URL from a base URL and a string to be inserted.
|code=<pre>sUnsafe = "€ @!! 3-g_dvv[gf"
sBaseURL = "http://example.com/?view="
sSafe = textutils.urlencode(sUnsafe)
sURL = sBaseURL .. sSafe
print(sURL)</pre>
|output=(same here)
}}
}}

Template:Example

2012-11-05T01:42:52Z

Wukl: I give up

<includeonly>
<table style="border-spacing: 0px;">
<tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px; border-bottom: solid #DDD 1px;">'''Description'''</td>
<td style="padding-left: .5em; border-bottom: solid #DDD 1px;">{{{desc}}}</td>
</tr>
<tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px;">'''Code'''</td>
<td style="padding-left: .5em;">
{{{code}}}
</td>
</tr>
{{#if: {{{output|}}} | <tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px;">'''Output'''</td>
<td style="padding-left: .5em;">{{{output}}}</td>
</tr>}}
</table>
</includeonly>
<noinclude>
== Wiki code ==
<nowiki>{{Example
|desc=Prints a message
|code=print("Hello world!")
|output=Hello world!
}}</nowiki>

== Result ==
{{Example
|desc=Prints a message
|code=print("Hello world!")
|output=Hello world!
}}
</noinclude>

Template:Example

2012-11-05T01:41:25Z

Wukl:

Template:Example

2012-11-05T01:40:20Z

Wukl:

<includeonly>
<table style="border-spacing: 0px;">
<tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px; border-bottom: solid #DDD 1px;">'''Description'''</td>
<td style="padding-left: .5em; border-bottom: solid #DDD 1px;">{{{desc}}}</td>
</tr>
<tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px;">'''Code'''</td>
<td style="padding-left: .5em;">
<pre>
{{{code}}}
</pre>
</td>
</tr>
{{#if: {{{output|}}} | <tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px;">'''Output'''</td>
<td style="padding-left: .5em;">{{{output}}}</td>
</tr>}}
</table>
</includeonly>
<noinclude>
== Wiki code ==
<nowiki>{{Example
|desc=Prints a message
|code=print("Hello world!")
|output=Hello world!
}}</nowiki>

== Result ==
{{Example
|desc=Prints a message
|code=print("Hello world!")
|output=Hello world!
}}
</noinclude>

Template:Example

2012-11-05T01:39:45Z

Wukl:

<includeonly>
<table style="border-spacing: 0px;">
<tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px; border-bottom: solid #DDD 1px;">'''Description'''</td>
<td style="padding-left: .5em; border-bottom: solid #DDD 1px;">{{{desc}}}</td>
</tr>
<tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px;">'''Code'''</td>
<td style="padding-left: .5em;">
<nowiki>
{{{code}}}
</nowiki>
</td>
</tr>
{{#if: {{{output|}}} | <tr>
<td style="padding-right: .5em; border-right: solid #DDD 1px;">'''Output'''</td>
<td style="padding-left: .5em;">{{{output}}}</td>
</tr>}}
</table>
</includeonly>
<noinclude>
== Wiki code ==
<nowiki>{{Example
|desc=Prints a message
|code=print("Hello world!")
|output=Hello world!
}}</nowiki>

== Result ==
{{Example
|desc=Prints a message
|code=print("Hello world!")
|output=Hello world!
}}
</noinclude>

Textutils.urlEncode

2012-11-05T01:39:05Z

Wukl: Created page, but not the outputs of the functions, as I can't run Minecraft on this computer

{{lowercase}}
{{Function
|name=textutils.urlEncode
|args= [[String (type)|string]]
|returns=A string safe for use on the internet
|api=textutils
|addon=ComputerCraft
|desc=Replaces certain characters in a string to make it safe for use on the internet. Note that it is a string function and will even replace characters that are allowed in URLs. Use this only for text to be inserted in an URL, not the URL itself.
|examples=
{{Example
|desc=Create a safe string from another string full of invalid characters. '''This is incorrect usage!'''
|code=sUnsafe = "http://example.com/?view=€ @!! 3-g_dvv[gf" sSafe = textutils.urlEncode(sUnsafe) print(sSafe)
|output=(to be specified - I don't have CC on this computer)
}}
{{Example
|desc=Create a safe URL from a base URL and a string to be inserted.
|code=sUnsafe = "€ @!! 3-g_dvv[gf" sBaseURL = "http://example.com/?view=" sSafe = textutils.urlencode(sUnsafe) sURL = sBaseURL .. sSafe print(sURL)
|output=(same here)
}}
}}

Worm

2012-08-01T12:38:19Z

Wukl:

[[image:2012-01-30 22.51.36.png|thumb|400px|Gameplay of Worm.]]Worm is a built-in program. It is essentially Snake without walls; instead of hitting a wall and dying, the worm will wrap around the screen. It has three difficulty levels.

[[Category:Notable Programs]]
[[Category:Games]]

Category:Games

2012-08-01T12:37:39Z

Wukl: Created page with "Playing Minecraft in Minecraft is the best idea ever. Category:Programs"

Playing Minecraft in Minecraft is the best idea ever.
[[Category:Programs]]

Adventure

2012-08-01T12:35:53Z

Wukl:

[[image:2012-01-30 22.51.59.png|frame|right|Gameplay of Adventure.]]Adventure is one of the default programs in CraftOs. Adventure emulates a text adventure, but it takes place in MineCraft. Therefore, it is possible to play MineCraft, on a computer, in MineCraft, on a computer. This is referred to as "recursion". Also most LPs consist of LPers playing Adventure.

For more ingame info type: "help"
[[Category:Notable Programs]]
[[Category:Games]]

Login with Roaming Profiles

2012-08-01T12:34:00Z

Wukl:

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.

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]].

== The Code ==

=== Server Code ===

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 = {}
users = { username1="password", username2="password2" }
senders = {}
senders = { 13, 14, 15, 17 } -- 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()
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 k,v in pairs(users) do
if message == k then
valid = true
password = v
else
valid = false
end
end
if valid then
rednet.send(senderId, password)
else
rednet.send(senderId, "Not Valid")
end
end
end

=== Client Code ===

os.pullEvent = os.pullEventRaw
local locker = true
local failed = true
local attempted_login = true
local password_server = 17 -- 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)
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("Not authorised.")
sleep(1)
end
else
print("Command not recognised...")
sleep(2)
end
end

== Thoughts and Notes ==
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 not 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 run Tekkit, find the 'World Anchor' 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.

[[Category:User Management]]

Category:Programs

2012-08-01T12:32:18Z

Wukl: Created page with "Lists all programs"

Lists all programs

Category:Notable Programs

2012-08-01T12:31:20Z

Wukl:

This lists all notable programs that are ''not'' OSes.
[[Category:Lists]]
[[Category:Programs]]

Redstone

2012-06-25T13:22:36Z

Wukl: Because the crafting grid links to the page Redstone.

'''Redstone may refer to:'''
* The [[Redstone_(API)|Redstone API]]
* [http://www.minecraftwiki.net/wiki/Redstone_Dust Redstone dust]

IO (API)

2012-06-24T14:46:29Z

Wukl:

IO is a reimplementation of the default Lua input / output API defined [http://www.lua.org/manual/5.1/manual.html#5.7 here], with some features trimmed. Most features should work. If you find a non-working feature, please list it here.

List of non-working features from IO:

* file:seek(...) - Doesn't exist.

[[Category:APIs]]

Term.clearLine

2012-06-24T14:26:39Z

Wukl: Undo revision 1794 by 37.59.80.67 (talk)

{{lowercase}}
{{Function
|name=term.clearLine
|args=none
|returns=none
|api=term
|addon=ComputerCraft
|desc=Clears the line that the cursor is currently on.
|examples=
{{Example
|desc=Clears the line that the cursor is currently on.
|code=term.clearLine()
}}
}}

Disk.getLabel

2012-06-24T14:26:11Z

Wukl: Undo revision 1795 by 37.59.80.67 (talk)

{{lowercase}}
{{Function
|name=disk.getLabel
|args=[[string (type)|string]] side
|api=disk
|returns=[[string (type)|string]] disk label
|addon=ComputerCraft
|examples=
{{Example
|desc=Checks for data saved on the disk in the bottom drive
|code=print(disk.getLabel("bottom"))
|output=Floppy --'''Output changes according to the disk label'''
}}
}}

TurtleOS

2012-06-24T14:25:54Z

Wukl: Undo revision 1796 by 37.59.80.67 (talk)

[[File:8EPlc.png|400px|thumb|right|TurtleOS interface]]
TurtleOS is the default OS for [[Turtle|turtles]]. The difference with the default OS for [[Console|consoles]] is that TurtleOS works with the new [[Turtle API]], which can be used to code turtles.
Its features include...
* Default; guaranteed to work across updates unlike the others.
* DOS style interface
* Only OS for turtles at time of writing
* Do It Yourself: letting you customize what you want on your Turtle.
[[Category:OSes]]

Wireless Modem

2012-06-24T14:25:39Z

Wukl: Undo revision 1797 by 37.59.80.67 (talk)

[[File:QJrCF.png|frame|right|The recipe for a modem.]]
== Description ==
'''Modems''' are blocks which can be used to wirelessly transfer data between [[Console|consoles]] and [[Turtle|turtles]], using "rednet" commands.
To place a modem on a side of your console, click on the console with the right mouse button while sneaking (with standard settings: holding the left shift button).

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 metres away, or 17 metres during a thunderstorm.[http://www.computercraft.info/forums2/index.php?/topic/464-wireless-distance/page__hl__distance__fromsearch__1]

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

[[Rednet (API)|More help on Rednet]]

Os.clock

2012-06-24T14:24:52Z

Wukl: Undo revision 1799 by 37.59.80.67 (talk)

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

Bit.blshift

2012-06-24T14:23:10Z

Wukl: Undo revision 1809 by 37.59.80.67 (talk)

{{lowercase}}
{{Function
|name=bit.blshift
|args=[[int (type)|int]] n, [[int (type)|int]] bits
|api=bit
|returns=[[int]] the value of <var>n</var> shifted left by <var>bits</var> bits, which is equivalent to <var>n</var>×2<var>bits</var>
|addon=ComputerCraft
|desc=Shifts a number left by a specified number of bits
|examples=
{{Example
|desc=Shift the number 18 (10010) left by 2 bits, yielding 72 (1001000)
|code=print(bit.blshift(18, 2))
|output=72
}}
}}

CCGPU

2012-06-24T14:22:29Z

Wukl: Blanked the page

Redstone

2012-06-24T13:29:50Z

Wukl:

See the Minecraft Wiki for more information about redstone.

User:Wukl

2012-06-24T12:06:27Z

Wukl:

Hi.
I'm Wukl, a (somewhat nerdy) programmer from The Netherlands.
 
I'm an irregular contributor to the wiki, meaning that I contribute when I have time. Maybe I'll stop contributing at one moment and never come back. I don't know.
 
See you next time! (Maybe ;-) )

== Mah Libraries ==
=== Decimal to 7-segment decoder ===
The decoder assumes that the computer uses RedPower wires, connected to lamps as shown:
[http://banaanvraag.co.cc/pg/8.png Colour key]
The colours are white, orange, magenta, light blue, yellow, lime and pink in clockwise, inwards spiraling order.
<pre>
sevenSeg = {63, 18, 79, 102, 109, 125, 7, 127, 111, 119, 121, 112, 57, 80, 96, 88}
function decode(_sSide, _iNum)
rs.setBundledOutput(_sSide, sevenSeg[_iNum])
end
</pre>

Rednet (API)

2012-06-24T11:34:52Z

Wukl: Fixed formatting

The rednet API provides a simple computer networking model over RedPower bundled cables or the Wireless Modems of Computercraft 1.3. 
With the table below, 'side' refers to a string that represents a side of the computer ("front", "back", "left", "right", "bottom", "top"). All message sent with rednet are and must be strings.

==Methods==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
!style="background:#EEE" width="80px"|Return type
|-
|[[rednet.open|rednet.open]](side)
|Tells the computer that the side can be used for networking.
|nil
|-
|[[rednet.close]](side)
|Tells the computer that the side can no longer be used for networking.
|nil
|-
|[[rednet.announce]]()
|Broadcasts an empty rednet message.
|nil
|-
|[[rednet.send]](receiverID, message)
|Sends a message to the computer using the opened sides. The receiver ID is the ID (number, not string) of the computer you're sending the message to.
|success
|-
|[[rednet.broadcast]](message)
|Sends the message to ALL connected and open computers.
|success
|-
|[[rednet.receive]](timeout)
|Waits until it received a rednet message or <var>timeout</var> has passed. Leave args empty to wait for a message forever.
|senderId, message, distance
|}

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

Category:Templates

2012-06-24T11:21:29Z

Wukl:

Due to a templating bug all functions became listed here. It's fixed now, but the list stays here for some reason.

Template:Function

2012-06-24T11:20:21Z

Wukl:

<includeonly>
<table style="width: 70%; border: solid 2px black; margin: 2px; padding: .3em; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid black 1px;">Function {{{name}}}</td></tr>
<tr style="background-color: #E8E8E8;"><td style="border-right: solid black 1px; padding: .2em; width: 10%; font-weight: bold;">Syntax</td>
<td style="border-color: black; padding: .2em; padding-left: .4em;">{{{name}}}({{{args|}}})</td></tr>
<tr style="background-color: #FFFFFF;"><td style="border-right: solid black 1px; padding: .2em; width: 10%; font-weight: bold;">Returns</td>
<td style="border-color: black; padding: .2em; padding-left: .4em;">{{{returns|[[nil]]}}}</td></tr>
<tr style="background-color: #E8E8E8;"><td style="border-right: solid black 1px; padding: .2em; width: 10%; font-weight: bold;">Part of</td>
<td style="border-color: black; padding: .2em; padding-left: .4em;">[[{{{addon|ComputerCraft}}}]]</td></tr>
<tr style="background-color: #FFFFFF;"><td style="border-right: solid black 1px; padding: .2em; width: 10%; font-weight: bold;">API</td>
<td style="border-color: black; padding: .2em; padding-left: .4em;">[[{{{api}}} (API)|{{{api}}}]]</td></tr>
<tr style="background-color: #E8E8E8;"><td style="border-right: solid black 1px; padding: .2em; width: 10%; font-weight: bold;">Description</td>
<td style="border-color: black; padding: .2em; padding-left: .4em;">{{{desc|No description provided.}}}</td></tr>
</table>

{{#if:{{{examples|}}}|
== Examples ==
{{{examples|}}}
|}}

{{#if:{{{notes|}}}|
== Additional Notes ==
{{{notes}}}
|}}
</includeonly>
<noinclude>
__NOTOC__
== Wiki code ==
<nowiki>{{Function
|name=redstone.setOutput
|args=[[string]] side, [[boolean]] value
|api=redstone
|returns=[[nil]]
|addon=ComputerCraft
|desc=Sets a redstone output
|examples=Examples go here
|notes=
* Note 1
* Note 2
}}</nowiki>

Note that ''args'', ''returns'', ''addon'', ''examples'' and ''notes'' are optional.

== Result ==
{{Function
|name=redstone.setOutput
|args=[[string]] side, [[boolean]] value
|api=redstone
|returns=[[nil]]
|addon=ComputerCraft
|desc=Sets a redstone output
|examples=Examples go here
|notes=
* Note 1
* Note 2
}}
[[Category:Templates]]
</noinclude>

Http.post

2012-06-24T11:19:38Z

Wukl: Created page with "{{lowercase}} {{Function |name=http.post |args=string url, string post |api=HTTP |returns=The response of the server or nil on failure. |addon=ComputerCraft }}"

{{lowercase}}
{{Function
|name=http.post
|args=[[string]] url, [[string]] post
|api=HTTP
|returns=The response of the server or nil on failure.
|addon=ComputerCraft
}}

Http.get

2012-06-24T10:45:18Z

Wukl:

{{lowercase}}
{{Function
|name=http.get
|args=[[string]] url
|api=HTTP
|returns=The response of the server or nil on failure.
|addon=ComputerCraft
|examples=
===Basic usage===
{{Example
|desc=Gets the content of example.com (in HTML)
|code=local sExample = http.get("http://example.com/") write(sExample)
|output=The source of example.com
}}
}}

Http.request

2012-06-24T10:44:43Z

Wukl: oops, wrong page

Http.request

2012-06-24T10:43:52Z

Wukl: Created page with "{{lowercase}} {{Function |name=http.request |args=string url |api=HTTP |returns=The response of the server or nil on failure. |addon=ComputerCraft |examples= ===Basic usag..."

{{lowercase}}
{{Function
|name=http.request
|args=[[string]] url
|api=HTTP
|returns=The response of the server or nil on failure.
|addon=ComputerCraft
|examples=
===Basic usage===
{{Example
|desc=Gets the content of example.com (in HTML)
|code=local sExample = http.get("http://example.com/") write(sExample)
|output=The source of example.com
}}
}}

User:Wukl

2012-05-08T20:54:41Z

Wukl:

Redstone.setBundledOutput

2012-04-17T19:37:37Z

Wukl:

{{lowercase}}
{{Function
|name=redstone.setBundledOutput
|args=[[string]] side, [[int]] colors
|api=redstone
|returns=?
|addon=ComputerCraft
|examples=
===Basic usage===
{{Example
|desc=Toggles between the black and white wires every two seconds
|code=while(true) do redstone.setBundledOutput("back", colors.black) sleep(2) redstone.setBundledOutput("back", colors.white) sleep(2) end
|output=(nothing on the screen)
}}
===Combining outputs===
The value is passed as an integer, so sending multiple colors is as easy as adding them together:
{{Example
|desc=Toggles between the black/white and red/blue wires every two seconds
|code=while(true) do redstone.setBundledOutput("back", colors.black+colors.white) sleep(2) redstone.setBundledOutput("back", colors.red+colors.blue) sleep(2) end
|output=(nothing on the screen)
}}
===Clearing the output===
{{Example
|desc=Unsets the output (removes all power)
|code=function unsetAll(sSide) redstone.setBundledOutput(sSide, 0) end
|output=(nothing on the screen)
}}
}}

Redstone.setBundledOutput

2012-04-17T19:36:18Z

Wukl:

{{lowercase}}
{{Function
|name=redstone.setBundledOutput
|args=[[string]] side, [[int]] colors
|api=redstone
|returns=?
|addon=ComputerCraft
|examples=
{{Example
|desc=Toggles between the black and white wires every two seconds
|code=while(true) do redstone.setBundledOutput("back", colors.black) sleep(2) redstone.setBundledOutput("back", colors.white) sleep(2) end
|output=(nothing on the screen)
}}
The value is passed as an integer, so sending multiple colors is as easy as adding them together:
{{Example
|desc=Toggles between the black/white and red/blue wires every two seconds
|code=while(true) do redstone.setBundledOutput("back", colors.black+colors.white) sleep(2) redstone.setBundledOutput("back", colors.red+colors.blue) sleep(2) end
|output=(nothing on the screen)
}}
{{Example
|desc=Unsets the output (removes all power)
|code=function unsetAll(sSide) redstone.setBundledOutput(sSide, 0) end
|output=(nothing on the screen)
}}
}}

Raw key events

2012-04-12T18:00:32Z

Wukl: Undo revision 1265 by Wukl (talk)

The built-in os has a function to read incoming keystrokes. But it also implements the functions to move the cursor while typing. This is not always a desired feature; imagine a case in which you want to make a menu with a controllable cursor around the menu entries. The current read() function won't let you.

==Detecting keystrokes==
In case I made you think the os sucks, it doesn't (all the time). Because this os is not Windows, we can access lower-level functions, such as os.pullEvent(). And that's the one that we're going to use:
<pre>
function rawread()
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
break
end
end
end
</pre>
This function waits for any key, then exits.

==Figuring out the key==
We can detect any key, but not which key. To find it out, we have to add some further logic to the code:
<pre>
function rawread()
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
if(param == 28) then
print("Enter detected")
break
end
end
end
end
</pre>
This function waits for the Enter key to be pressed. If so, it writes "Enter detected" to the screen and exits.

==Key scan codes ==
The scan codes are typical DirectX numbers.
{|
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Escape
| 1
|-
| 1
| 2
|-
| 2
| 3
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 10
|-
| 0
| 11
|-
| Minus
| 12
|-
| Equals
| 13
|-
| Backspace
| 14
|-
| Tab
| 15
|-
| Q
| 16
|-
| W
| 17
|-
| E
| 18
|-
| R
| 19
|-
| T
| 20
|-
| Y
| 21
|-
| U
| 22
|-
| I
| 23
|-
| O
| 24
|-
| P
| 25
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Left Bracket
| 26
|-
| Right Bracket
| 27
|-
| Enter
| 28
|-
| Left Control
| 29
|-
| A
| 30
|-
| S
| 31
|-
| D
| 32
|-
| F
| 33
|-
| G
| 34
|-
| H
| 35
|-
| J
| 36
|-
| K
| 37
|-
| L
| 38
|-
| Semicolon
| 39
|-
| Apostrophe
| 40
|-
| Tilde (~)
| 41
|-
| Left Shift
| 42
|-
| Back Slash
| 43
|-
| Z
| 44
|-
| X
| 45
|-
| C
| 46
|-
| V
| 47
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| B
| 48
|-
| N
| 49
|-
| M
| 50
|-
| Comma
| 51
|-
| Period
| 52
|-
| Forward Slash
| 53
|-
| Right Shift
| 54
|-
| Numpad *
| 55
|-
| Left Alt
| 56
|-
| Spacebar
| 57
|-
| Caps Lock
| 58
|-
| F1
| 59
|-
| F2
| 60
|-
| F3
| 61
|-
| F4
| 62
|-
| F5
| 63
|-
| F6
| 64
|-
| F7
| 65
|-
| F8
| 66
|-
| F9
| 67
|-
| F10
| 68
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Num Lock
| 69
|-
| Scroll Lock
| 70
|-
| Numpad 7
| 71
|-
| Numpad 8
| 72
|-
| Numpad 9
| 73
|-
| Numpad -
| 74
|-
| Numpad 4
| 75
|-
| Numpad 5
| 76
|-
| Numpad 6
| 77
|-
| Numpad +
| 78
|-
| Numpad 1
| 79
|-
| Numpad 2
| 80
|-
| Numpad 3
| 81
|-
| Numpad 0
| 82
|-
| Numpad .
| 83
|-
| F11
| 87
|-
| F12
| 88
|-
| Numpad Enter
| 156
|-
| Right Control
| 157
|-
| Numpad /
| 181
|-
| Right Alt
| 184
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Home
| 199
|-
| Up Arrow
| 200
|-
| Page Up
| 201
|-
| Left Arrow
| 203
|-
| Right Arrow
| 205
|-
| End
| 207
|-
| Down Arrow
| 208
|-
| Page Down
| 209
|-
| Insert
| 210
|-
| Delete
| 211
|-
| Left Mouse Button
| 256
|-
| Right Mouse Button
| 257
|-
| Middle Mouse/Wheel
| 258
|-
| Mouse Button 3
| 259
|-
| Mouse Button 4
| 260
|-
| Mouse Button 5
| 261
|-
| Mouse Button 6
| 262
|-
| Mouse Button 7
| 263
|-
| Mouse Wheel Up
| 264
|-
| Mouse Wheel Down
| 265
|}
|}
Source: [http://wiki.tesnexus.com/index.php/DirectX_Scancodes_And_How_To_Use_Them Nexus Wiki]

====Author(s)====
They deserve credit!
*Initial page - [[User:Wukl|Wukl]]

[[Category:Tutorials]]

Raw key events

2012-04-12T17:59:06Z

Wukl: Replaced <pre> by <code>

The built-in os has a function to read incoming keystrokes. But it also implements the functions to move the cursor while typing. This is not always a desired feature; imagine a case in which you want to make a menu with a controllable cursor around the menu entries. The current read() function won't let you.

==Detecting keystrokes==
In case I made you think the os sucks, it doesn't (all the time). Because this os is not Windows, we can access lower-level functions, such as os.pullEvent(). And that's the one that we're going to use:
<code>
function rawread()
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
break
end
end
end
</code>
This function waits for any key, then exits.

==Figuring out the key==
We can detect any key, but not which key. To find it out, we have to add some further logic to the code:
<code>
function rawread()
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
if(param == 28) then
print("Enter detected")
break
end
end
end
end
</code>
This function waits for the Enter key to be pressed. If so, it writes "Enter detected" to the screen and exits.

==Key scan codes ==
The scan codes are typical DirectX numbers.
{|
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Escape
| 1
|-
| 1
| 2
|-
| 2
| 3
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 10
|-
| 0
| 11
|-
| Minus
| 12
|-
| Equals
| 13
|-
| Backspace
| 14
|-
| Tab
| 15
|-
| Q
| 16
|-
| W
| 17
|-
| E
| 18
|-
| R
| 19
|-
| T
| 20
|-
| Y
| 21
|-
| U
| 22
|-
| I
| 23
|-
| O
| 24
|-
| P
| 25
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Left Bracket
| 26
|-
| Right Bracket
| 27
|-
| Enter
| 28
|-
| Left Control
| 29
|-
| A
| 30
|-
| S
| 31
|-
| D
| 32
|-
| F
| 33
|-
| G
| 34
|-
| H
| 35
|-
| J
| 36
|-
| K
| 37
|-
| L
| 38
|-
| Semicolon
| 39
|-
| Apostrophe
| 40
|-
| Tilde (~)
| 41
|-
| Left Shift
| 42
|-
| Back Slash
| 43
|-
| Z
| 44
|-
| X
| 45
|-
| C
| 46
|-
| V
| 47
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| B
| 48
|-
| N
| 49
|-
| M
| 50
|-
| Comma
| 51
|-
| Period
| 52
|-
| Forward Slash
| 53
|-
| Right Shift
| 54
|-
| Numpad *
| 55
|-
| Left Alt
| 56
|-
| Spacebar
| 57
|-
| Caps Lock
| 58
|-
| F1
| 59
|-
| F2
| 60
|-
| F3
| 61
|-
| F4
| 62
|-
| F5
| 63
|-
| F6
| 64
|-
| F7
| 65
|-
| F8
| 66
|-
| F9
| 67
|-
| F10
| 68
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Num Lock
| 69
|-
| Scroll Lock
| 70
|-
| Numpad 7
| 71
|-
| Numpad 8
| 72
|-
| Numpad 9
| 73
|-
| Numpad -
| 74
|-
| Numpad 4
| 75
|-
| Numpad 5
| 76
|-
| Numpad 6
| 77
|-
| Numpad +
| 78
|-
| Numpad 1
| 79
|-
| Numpad 2
| 80
|-
| Numpad 3
| 81
|-
| Numpad 0
| 82
|-
| Numpad .
| 83
|-
| F11
| 87
|-
| F12
| 88
|-
| Numpad Enter
| 156
|-
| Right Control
| 157
|-
| Numpad /
| 181
|-
| Right Alt
| 184
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Home
| 199
|-
| Up Arrow
| 200
|-
| Page Up
| 201
|-
| Left Arrow
| 203
|-
| Right Arrow
| 205
|-
| End
| 207
|-
| Down Arrow
| 208
|-
| Page Down
| 209
|-
| Insert
| 210
|-
| Delete
| 211
|-
| Left Mouse Button
| 256
|-
| Right Mouse Button
| 257
|-
| Middle Mouse/Wheel
| 258
|-
| Mouse Button 3
| 259
|-
| Mouse Button 4
| 260
|-
| Mouse Button 5
| 261
|-
| Mouse Button 6
| 262
|-
| Mouse Button 7
| 263
|-
| Mouse Wheel Up
| 264
|-
| Mouse Wheel Down
| 265
|}
|}
Source: [http://wiki.tesnexus.com/index.php/DirectX_Scancodes_And_How_To_Use_Them Nexus Wiki]

====Author(s)====
They deserve credit!
*Initial page - [[User:Wukl|Wukl]]

[[Category:Tutorials]]

Raw key events

2012-04-11T08:28:45Z

Wukl: Function declaration added at second bit of code

Talk:Redstone (API)

2012-04-09T09:12:40Z

Wukl:

==(Question that should have been asked on the forums)==
i tried to do it but for some reason it didnt work, i tried:

sleep(5) 
setBundledOutput(orange,back,magenta) 
sleep(0.5) 
setBundledOutput(orange,back,magenta) 

and after the 5 seconds, it puts:
"redtest:2: attempt to call nil"

how the heck does it work? how can i get it to work? someone plez reply lol, im new to lua so i know very little about lua...
: First of all, where's the function declaration? You call redtest(), but the error tells that it doesn't exist. Second, use redstone.setBundledOutput() or rs.setBundledOutput(). [[User:Wukl|Wukl]] 09:12, 9 April 2012 (UTC)

Os.run

2012-04-08T18:39:26Z

Wukl: Created page with "{{lowercase}} {{Function |name=os.run |args=metatable envVars, string path, vararg arguments |api=os |returns=false on error, otherwise true |addon=ComputerCraft |..."

{{lowercase}}
{{Function
|name=os.run
|args=[[metatable]] envVars, [[string]] path, [[vararg]] arguments
|api=os
|returns=false on error, otherwise true
|addon=ComputerCraft
|examples=
{{Example
|desc=Runs the default shell
|code=os.run({}, "rom/programs/shell")
|output=The default shell
}}
}}

Tutorials

2012-04-08T18:34:41Z

Wukl: Undo revision 1247 by Wukl (talk) Stupid, stupid me.

Look for the [[Getting Started]] guide if this is your first try. As some tutorials might not be listed here, you can also browse the [[:Category:Tutorials|tutorials category]].

=== Basics ===
Common things that may need some explanation.
*[[The console and its shell]]

=== Programming & Wiring ===
*[[Hello_World_Tutorial|Hello World!]]
*[[Guess_The_Number_(tutorial)|Guess the Number]]
*[[Making_a_Password_Protected_Door|Password Protected Door]]
*[[Making_an_API_(tutorial)|Programming an API]]
*[[Startup|Running script automatically at boot with Startup]]
*[[Raw key events| Detecting specific keys (such as the arrow keys)]]
=== Turtles ===
The nice little robots that do the hard work for you.
*[[Turtle_Tutorial|Turtles!]]
*[[Turtle_Lumberjack_(tutorial)|Turtle Lumberjack]]
*[[Advanced_Turtle_Lumberjack_(tutorial)|Advanced Turtle Lumberjack]]
*[[Cobble_Generator|Cobblestone Generator]]
*[[Turtle_Stairbuilder_(tutorial)|Turtle Stairbuilder]]

Tutorials

2012-04-08T18:24:11Z

Wukl:

Look for the [[Getting Started]] guide if this is your first try. As some tutorials might not be listed here, you can also browse the [[:Category:Tutorials|tutorials category]].

=== Basics ===
Common things that may need some explanation.
*[[The console and its shell]]

=== Programming & Wiring ===
*[[Hello_World_Tutorial|Hello World!]]
*[[Guess_The_Number_(tutorial)|Guess the Number]]
*[[Making_a_Password_Protected_Door|Password Protected Door]]
*[[Cobble_Generator|Automated Cobblestone Generator]]
*[[Making_an_API_(tutorial)|Programming an API]]
*[[Startup|Running script automatically at boot with Startup]]
*[[Raw key events| Detecting specific keys (such as the arrow keys)]]
=== Turtles ===
The nice little robots that do the hard work for you.
*[[Turtle_Tutorial|Turtles!]]
*[[Turtle_Lumberjack_(tutorial)|Turtle Lumberjack]]
*[[Advanced_Turtle_Lumberjack_(tutorial)|Advanced Turtle Lumberjack]]
*[[Cobble_Generator|Cobblestone Generator]]
*[[Turtle_Stairbuilder_(tutorial)|Turtle Stairbuilder]]

ComputerCraft Wiki:Community portal

2012-04-08T18:20:43Z

Wukl: Created page with "See [http://computercraft.info/forums2/ the forums] for help."

See [http://computercraft.info/forums2/ the forums] for help.

Talk:ComputerCraft Wiki:Mainpage

2012-04-08T18:18:36Z

Wukl: Out of date

ComputerCraft

2012-04-08T18:12:28Z

Wukl: Redirected page to ComputerCraft Wiki - Home

#REDIRECT [[ComputerCraft Wiki - Home]]

User:Wukl

2012-04-08T18:11:36Z

Wukl:

Hi.
I'm Wukl, a (somewhat nerdy) programmer from the Netherlands.

One day, I came here to find some information about this mod. It took me a while.
So, after a little time, I decided that I, without any permission, overhauled the wiki. And it worked. Soon, even more people came by and added even more pages. I loved that moment.

Well, that's it! :-)

Template:Changelog

2012-04-08T14:10:01Z

Wukl: Fixed space error (at least, in Dutch - spatiefout), shutdown -> shut down

{| class="wikitable sortable" style="width: 100%"
|-
! style="width: 15%" | Version
! class="unsortable" | New Features or Changes
! style="width: 15%" | Minecraft Version

|-
| style="text-align: center" | ComputerCraft 1.32
|
*Ported to Minecraft 1.2.4
*Fixed a big memory leak in LuaJ that caused extra threads to stay around forever when computers were shut down.
| style="text-align: center" | 1.2.3

|-
| style="text-align: center" | ComputerCraft 1.31
|
*Ported to Minecraft 1.2.3
*Added Monitors (thanks to Cloudy). Build huge external displays for your computers!
*New positioning capabilities for computers and turtles. Build GPS networks and triangulate the positions of your turtles position so they never get lost!
*New turtle.compare() function for turtles for more intelligent mining.
*New programs and APIs: gps, monitor, vector
*New program: pastebin (requires enableAPI_HTTP=1 in mod_ComputerCraft.cfg), upload and download programs made by other users ingame!
*Added a new top secret program designed for use with Monitors, see if you can find it.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
| style="text-align: center" | 1.2.3

|-
| style="text-align: center" | ComputerCraft 1.3
|
*Ported to Minecraft Forge.
*Added Turtles, Mining Turtles, Wireless Turtles and Wireless Mining Turtles (Block ID 209).
*Added a Peripheral API to allow mod developers to create custom peripherals for ComputerCraft. Details on this will be posted in the next few days.
*Added Wireless Modems. Use the rednet API to send data wirelessly between computers and turtles!
*Computers and Disk Drives no longer get destroyed by water.
*Computers and Turtles can now be labelled, destroyed, and moved around, keeping their state.
*Computers and Turtles can connect to adjacent devices, and turn them on or off.
*User programs now give line numbers in their error messages, for easier debugging.
*New APIs and programs for Turtles: turtle, excavate, tunnel, go, turn and dance.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
| style="text-align: center" | 1.1

|-
| style="text-align: center" | ComputerCraft 1.21
|
*Added shortcut key to shutdown the computer.
*Added a help API add-on pack.
*Various bug fixes.
| style="text-align: center" | 1.1
|-
| style="text-align: center" | ComputerCraft 1.2
|
*Added Disk Drives
*Added shortcut keys to terminate the current program and reboot the computer.
*Added a new system for user created APIs.
*Added RedNet.
*Added shell.setPath() and shell.setAlias().
*Added a new ROM startup script.
*Added os.clock(), os.time(), and os.setAlarm().
*Added game: "Worm!"
*Added programs: alias, apis, copy, delete, dj, drive, eject, id, label, list, move, reboot, redset, rename, time, worm.
*Added APIs: bit, colours, disk, help, rednet, parallel, textutils
*Text can be edited with left and right arrow keys.
*Many bug fixes
| style="text-align: center" | 1.0
|-
| style="text-align: center" | ComputerCraft 1.11
|
*Fixed bug where [[Console|Computers]] could not read input from RedPower cables which had a bend in the immediately adjacent square.
| style="text-align: center" | 1.0
|-
| style="text-align: center" | ComputerCraft 1.1
|
*Changed the default block ID for the [[Console|Computer]] to 207.
*Added multiplayer support.
*Added connectivity with RedPower bundled cables.
*Added HTTP API
*Fixed support for HD textures on the front of [[Console|Computers]].
*Added command history to the [[Console]].
*Added config options to change the size of the [[Console]] GUI and the text color.
*Programs with infinite loops that don't yield will no longer freeze Minecraft and will terminate after 10 seconds.
*Extended Help and fixed typos/small errors in various programs.
| style="text-align: center" | 1.0
|-
| style="text-align: center" | ComputerCraft 1.02
|
*Fixed the MCPatcher HD textures incompatibility that was causing the computer texture to replace cobblestone blocks.
| style="text-align: center" | 1.0
|-
| style="text-align: center" | ComputerCraft 1.01
|
*Added a ModLoader configuration file, so the computers block ID can be changed.
*Made the error message that displays when Lua files are not correctly installed much more clear, no more "Assertion failed."
| style="text-align: center" | 1.0
|-
| style="text-align: center" | ComputerCraft 1.0
|
*First Release
| style="text-align: center" | 1.0
|}

Raw key events

2012-04-08T14:04:05Z

Wukl:

The built-in os has a function to read incoming keystrokes. But it also implements the functions to move the cursor while typing. This is not always a desired feature; imagine a case in which you want to make a menu with a controllable cursor around the menu entries. The current read() function won't let you.

==Detecting keystrokes==
In case I made you think the os sucks, it doesn't (all the time). Because this os is not Windows, we can access lower-level functions, such as os.pullEvent(). And that's the one that we're going to use:
<pre>
function rawread()
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
break
end
end
end
</pre>
This function waits for any key, then exits.

==Figuring out the key==
We can detect any key, but not which key. To find it out, we have to add some further logic to the code:
<pre>
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
if(param == 28) then
print("Enter detected")
break
end
end
end
end
</pre>
This function waits for the Enter key to be pressed. If so, it writes "Enter detected" to the screen and exits.

==Key scan codes ==
The scan codes are typical DirectX numbers.
{|
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Escape
| 1
|-
| 1
| 2
|-
| 2
| 3
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 10
|-
| 0
| 11
|-
| Minus
| 12
|-
| Equals
| 13
|-
| Backspace
| 14
|-
| Tab
| 15
|-
| Q
| 16
|-
| W
| 17
|-
| E
| 18
|-
| R
| 19
|-
| T
| 20
|-
| Y
| 21
|-
| U
| 22
|-
| I
| 23
|-
| O
| 24
|-
| P
| 25
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Left Bracket
| 26
|-
| Right Bracket
| 27
|-
| Enter
| 28
|-
| Left Control
| 29
|-
| A
| 30
|-
| S
| 31
|-
| D
| 32
|-
| F
| 33
|-
| G
| 34
|-
| H
| 35
|-
| J
| 36
|-
| K
| 37
|-
| L
| 38
|-
| Semicolon
| 39
|-
| Apostrophe
| 40
|-
| Tilde (~)
| 41
|-
| Left Shift
| 42
|-
| Back Slash
| 43
|-
| Z
| 44
|-
| X
| 45
|-
| C
| 46
|-
| V
| 47
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| B
| 48
|-
| N
| 49
|-
| M
| 50
|-
| Comma
| 51
|-
| Period
| 52
|-
| Forward Slash
| 53
|-
| Right Shift
| 54
|-
| Numpad *
| 55
|-
| Left Alt
| 56
|-
| Spacebar
| 57
|-
| Caps Lock
| 58
|-
| F1
| 59
|-
| F2
| 60
|-
| F3
| 61
|-
| F4
| 62
|-
| F5
| 63
|-
| F6
| 64
|-
| F7
| 65
|-
| F8
| 66
|-
| F9
| 67
|-
| F10
| 68
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Num Lock
| 69
|-
| Scroll Lock
| 70
|-
| Numpad 7
| 71
|-
| Numpad 8
| 72
|-
| Numpad 9
| 73
|-
| Numpad -
| 74
|-
| Numpad 4
| 75
|-
| Numpad 5
| 76
|-
| Numpad 6
| 77
|-
| Numpad +
| 78
|-
| Numpad 1
| 79
|-
| Numpad 2
| 80
|-
| Numpad 3
| 81
|-
| Numpad 0
| 82
|-
| Numpad .
| 83
|-
| F11
| 87
|-
| F12
| 88
|-
| Numpad Enter
| 156
|-
| Right Control
| 157
|-
| Numpad /
| 181
|-
| Right Alt
| 184
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Home
| 199
|-
| Up Arrow
| 200
|-
| Page Up
| 201
|-
| Left Arrow
| 203
|-
| Right Arrow
| 205
|-
| End
| 207
|-
| Down Arrow
| 208
|-
| Page Down
| 209
|-
| Insert
| 210
|-
| Delete
| 211
|-
| Left Mouse Button
| 256
|-
| Right Mouse Button
| 257
|-
| Middle Mouse/Wheel
| 258
|-
| Mouse Button 3
| 259
|-
| Mouse Button 4
| 260
|-
| Mouse Button 5
| 261
|-
| Mouse Button 6
| 262
|-
| Mouse Button 7
| 263
|-
| Mouse Wheel Up
| 264
|-
| Mouse Wheel Down
| 265
|}
|}
Source: [http://wiki.tesnexus.com/index.php/DirectX_Scancodes_And_How_To_Use_Them Nexus Wiki]

====Author(s)====
They deserve credit!
*Initial page - [[User:Wukl|Wukl]]

[[Category:Tutorials]]

Raw key events

2012-04-08T14:01:51Z

Wukl:

The built-in os has a function to read incoming keystrokes. But it also implements the functions to move the cursor while typing. This is not always a desired feature; imagine a case in which you want to make a menu with a controllable cursor around the menu entries. The current read() function won't let you.

==Detecting keystrokes==
In case I made you think the os sucks, it doesn't (all the time). Because this os is not Windows, we can access lower-level functions, such as os.pullEvent(). And that's the one that we're going to use:
<pre>
function rawread()
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
break
end
end
end
</pre>
This function waits for any key, then exits.

==Figuring out the key==
We can detect any key, but not which key. To find it out, we have to add some further logic to the code:
<pre>
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
if(param == 28) then
print("Enter detected")
break
end
end
end
end
</pre>
This function waits for the Enter key to be pressed. If so, it writes "Enter detected" to the screen and exits.

==Key scan codes ==
The scan codes are typical DirectX numbers.
{|
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Escape
| 1
|-
| 1
| 2
|-
| 2
| 3
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 10
|-
| 0
| 11
|-
| Minus
| 12
|-
| Equals
| 13
|-
| Backspace
| 14
|-
| Tab
| 15
|-
| Q
| 16
|-
| W
| 17
|-
| E
| 18
|-
| R
| 19
|-
| T
| 20
|-
| Y
| 21
|-
| U
| 22
|-
| I
| 23
|-
| O
| 24
|-
| P
| 25
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Left Bracket
| 26
|-
| Right Bracket
| 27
|-
| Enter
| 28
|-
| Left Control
| 29
|-
| A
| 30
|-
| S
| 31
|-
| D
| 32
|-
| F
| 33
|-
| G
| 34
|-
| H
| 35
|-
| J
| 36
|-
| K
| 37
|-
| L
| 38
|-
| Semicolon
| 39
|-
| Apostrophe
| 40
|-
| Tilde (~)
| 41
|-
| Left Shift
| 42
|-
| Back Slash
| 43
|-
| Z
| 44
|-
| X
| 45
|-
| C
| 46
|-
| V
| 47
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| B
| 48
|-
| N
| 49
|-
| M
| 50
|-
| Comma
| 51
|-
| Period
| 52
|-
| Forward Slash
| 53
|-
| Right Shift
| 54
|-
| Numpad *
| 55
|-
| Left Alt
| 56
|-
| Spacebar
| 57
|-
| Caps Lock
| 58
|-
| F1
| 59
|-
| F2
| 60
|-
| F3
| 61
|-
| F4
| 62
|-
| F5
| 63
|-
| F6
| 64
|-
| F7
| 65
|-
| F8
| 66
|-
| F9
| 67
|-
| F10
| 68
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Num Lock
| 69
|-
| Scroll Lock
| 70
|-
| Numpad 7
| 71
|-
| Numpad 8
| 72
|-
| Numpad 9
| 73
|-
| Numpad -
| 74
|-
| Numpad 4
| 75
|-
| Numpad 5
| 76
|-
| Numpad 6
| 77
|-
| Numpad +
| 78
|-
| Numpad 1
| 79
|-
| Numpad 2
| 80
|-
| Numpad 3
| 81
|-
| Numpad 0
| 82
|-
| Numpad .
| 83
|-
| F11
| 87
|-
| F12
| 88
|-
| Numpad Enter
| 156
|-
| Right Control
| 157
|-
| Numpad /
| 181
|-
| Right Alt
| 184
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Home
| 199
|-
| Up Arrow
| 200
|-
| Page Up
| 201
|-
| Left Arrow
| 203
|-
| Right Arrow
| 205
|-
| End
| 207
|-
| Down Arrow
| 208
|-
| Page Down
| 209
|-
| Insert
| 210
|-
| Delete
| 211
|-
| Left Mouse Button
| 256
|-
| Right Mouse Button
| 257
|-
| Middle Mouse/Wheel
| 258
|-
| Mouse Button 3
| 259
|-
| Mouse Button 4
| 260
|-
| Mouse Button 5
| 261
|-
| Mouse Button 6
| 262
|-
| Mouse Button 7
| 263
|-
| Mouse Wheel Up
| 264
|-
| Mouse Wheel Down
| 265
|}
|}
Source: [http://wiki.tesnexus.com/index.php/DirectX_Scancodes_And_How_To_Use_Them Nexus Wiki]

[[Category:Tutorials]]

Tutorials

2012-04-08T14:00:27Z

Wukl:

Raw key events

2012-04-08T13:58:42Z

Wukl: Created page with "The built-in os has a function to read incoming keystrokes. But it also implements the functions to move the cursor while typing. This is not always a desired feature; imagine..."

The built-in os has a function to read incoming keystrokes. But it also implements the functions to move the cursor while typing. This is not always a desired feature; imagine a case in which you want to make a menu with a controllable cursor around the menu entries. The current read() function won't let you.

==Detecting keystrokes==
In case I made you think the os sucks, it doesn't (all the time). Because this os is not Windows, we can access lower-level functions, such as os.pullEvent(). And that's the one that we're going to use:
<pre>
function rawread()
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
break
end
end
end
</pre>
This function waits for any key, then exits.

==Figuring out the key==
We can detect any key, but not which key. To find it out, we have to add some further logic to the code:
<pre>
bRead = true
while(bRead)
local sEvent, param = os.pullEvent("key")
if(sEvent == "key") then
if(param == 28) then
print("Enter detected")
break
end
end
end
end
</pre>
This function waits for the Enter key to be pressed. If so, it writes "Enter detected" to the screen and exits.

==Key scan codes ==
The scan codes are typical DirectX numbers.
{|
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Escape
| 1
|-
| 1
| 2
|-
| 2
| 3
|-
| 3
| 4
|-
| 5
| 6
|-
| 7
| 8
|-
| 9
| 10
|-
| 0
| 11
|-
| Minus
| 12
|-
| Equals
| 13
|-
| Backspace
| 14
|-
| Tab
| 15
|-
| Q
| 16
|-
| W
| 17
|-
| E
| 18
|-
| R
| 19
|-
| T
| 20
|-
| Y
| 21
|-
| U
| 22
|-
| I
| 23
|-
| O
| 24
|-
| P
| 25
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Left Bracket
| 26
|-
| Right Bracket
| 27
|-
| Enter
| 28
|-
| Left Control
| 29
|-
| A
| 30
|-
| S
| 31
|-
| D
| 32
|-
| F
| 33
|-
| G
| 34
|-
| H
| 35
|-
| J
| 36
|-
| K
| 37
|-
| L
| 38
|-
| Semicolon
| 39
|-
| Apostrophe
| 40
|-
| Tilde (~)
| 41
|-
| Left Shift
| 42
|-
| Back Slash
| 43
|-
| Z
| 44
|-
| X
| 45
|-
| C
| 46
|-
| V
| 47
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| B
| 48
|-
| N
| 49
|-
| M
| 50
|-
| Comma
| 51
|-
| Period
| 52
|-
| Forward Slash
| 53
|-
| Right Shift
| 54
|-
| Numpad *
| 55
|-
| Left Alt
| 56
|-
| Spacebar
| 57
|-
| Caps Lock
| 58
|-
| F1
| 59
|-
| F2
| 60
|-
| F3
| 61
|-
| F4
| 62
|-
| F5
| 63
|-
| F6
| 64
|-
| F7
| 65
|-
| F8
| 66
|-
| F9
| 67
|-
| F10
| 68
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Num Lock
| 69
|-
| Scroll Lock
| 70
|-
| Numpad 7
| 71
|-
| Numpad 8
| 72
|-
| Numpad 9
| 73
|-
| Numpad -
| 74
|-
| Numpad 4
| 75
|-
| Numpad 5
| 76
|-
| Numpad 6
| 77
|-
| Numpad +
| 78
|-
| Numpad 1
| 79
|-
| Numpad 2
| 80
|-
| Numpad 3
| 81
|-
| Numpad 0
| 82
|-
| Numpad .
| 83
|-
| F11
| 87
|-
| F12
| 88
|-
| Numpad Enter
| 156
|-
| Right Control
| 157
|-
| Numpad /
| 181
|-
| Right Alt
| 184
|}
|style="vertical-align: top"|
{| border="1" cellpadding="5" cellspacing="0"
|-
! |Key
! |Code
|-
| Home
| 199
|-
| Up Arrow
| 200
|-
| Page Up
| 201
|-
| Left Arrow
| 203
|-
| Right Arrow
| 205
|-
| End
| 207
|-
| Down Arrow
| 208
|-
| Page Down
| 209
|-
| Insert
| 210
|-
| Delete
| 211
|-
| Left Mouse Button
| 256
|-
| Right Mouse Button
| 257
|-
| Middle Mouse/Wheel
| 258
|-
| Mouse Button 3
| 259
|-
| Mouse Button 4
| 260
|-
| Mouse Button 5
| 261
|-
| Mouse Button 6
| 262
|-
| Mouse Button 7
| 263
|-
| Mouse Wheel Up
| 264
|-
| Mouse Wheel Down
| 265
|}
|}
Source: [http://wiki.tesnexus.com/index.php/DirectX_Scancodes_And_How_To_Use_Them Nexus Wiki]

Getting Started

2012-03-15T20:47:49Z

Wukl:

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

# Install [http://www.minecraftforum.net/topic/75440-v100-risugamis-mods-everything-updated/ Risugami's ModLoader] 1.1.
# Install [http://www.minecraftforum.net/topic/86765-123-sdks-mods-v1v3-mar-7-mods-v1-modloadermp-v3/#ModLoaderMp Flan's ModLoaderMP Unofficial] Client 1.1 v2.
# Install [http://www.mod-buildcraft.com/forums/topic/forge-downloads/ Minecraft Forge] Recommended Client.
# Download the latest version of ComputerCraft
# Extract the .zip file in *minecraft folder*\mods\. (Tip: on the main screen of Minecraft, go to 'Texture Packs' and click on 'Open texture pack folder'. Go up one folder et voilà, there's your Minecraft folder.)

== Step 1: Crafting the console ==
The recipe is simple: 
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone |C2=stone
|A3=stone |B3=glass pane |C3=stone
|Output=console
}}
 

Right click on the console to use it. 
These are important to remember:
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Shortcut
!style="background:#EEE" width="*"|Usage
|-
|CTRL + T
|Closes the current program.
|-
|CTRL + R
|Reboots the console.
|-
|CTRL + S
|Forcefully shuts down the computer.
|}
NOTE: You have to hold the keyboard shortcuts down for at least 1 second! 
These are forced and will close the current program, even if it is still running.

== Step 2: Wiring it all up ==
The console accepts many forms of redstone. For simple structures, such as a password protected door, only a single line of redstone is needed.
However, this mod can do much more. If you need to connect multiple wires to one side, you can just use RedPower's cables. Easy peasy.
Or, you don't do anything in this part. The computer has some great games shipped with and it is even capable of loading web pages.

== Step 3: Programming your system ==
If you've programmed before this shouldn't be hard. It'll feel very comfortable.

Type
edit <filename>
in the terminal to open the included feature-rich  text editor. To get the hang of Lua if you're new, use
edit /rom/programs/redset
to view the code of a simple program 'redset'.

Navigating is easy.
> ls
rom
> cd rom
rom> ls
apis help programs
startup
rom>cd programs
rom/programs>cd /
>
To say it in English: ls '''l'''i'''s'''ts the files and folders in a directory, while cd changes the '''c'''urrent '''d'''irectory. / is the root of the computer.
Again, you don't have to program, but it's a big part of the mod. But you can still play those games.

== Step 4: Test it ==
Make sure that your program is bug-proof before using it as something important. A system controlling the state of an IndustrialCraft² Mark-III Nuclear Reactor to prevent it from overheating shouldn't crash every now and then with "Too long without yielding".

== Step 5: Extend it ==
Give back your part to the community. Help others on the forums or improve the wiki. Or, make your own OS or shell to run on the computers and share it with everybody. You can even create your own peripheral blocks using the API to create even a bigger system. A mainframe, for example.