Rednet (API) - Revision history

Lupus590: hostname is optional in rednet.lookup, page now reflects this

2018-01-15T16:59:34Z

hostname is optional in rednet.lookup, page now reflects this

Bomb Bloke: /* Range */

2015-12-27T11:46:57Z

‎Range

Bomb Bloke: Ender Modem

2015-12-26T03:16:57Z

Ender Modem

Smiley43210: Changed "MineCraft" to "Minecraft"

2015-08-14T12:10:47Z

Changed "MineCraft" to "Minecraft"

Bomb Bloke: /* Protocols */

2015-06-14T14:02:40Z

‎Protocols

Bomb Bloke: rednet.send/broadcast work with types other than strings.

2015-06-14T13:41:57Z

rednet.send/broadcast work with types other than strings.

Apemanzilla: /* Deprecated Functions */

2015-04-09T13:53:20Z

‎Deprecated Functions

Mitterdoo at 00:19, 24 October 2014

2014-10-24T00:19:53Z

Bomb Bloke at 08:30, 17 June 2014

2014-06-17T08:30:10Z

Bomb Bloke at 02:05, 7 June 2014

2014-06-07T02:05:29Z

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

@@ Line 82: / Line 82: @@
   minRange + (position.yCoord - 96.0) * ((maxRange - minRange) / ((world.getHeight() - 1) - 96.0))
-Where, by default:
+Where, for a [[Wireless Modem]]:
   minRange = 64  (or 16 in a storm)
   maxRange = 384 (or 96 in a storm)
   world.getHeight() = 256
 Catch is, that formula is quite capable of returning values that are well below 0... More research is required, it seems. Anyway, min/max range figures can be altered in [[ComputerCraft.cfg]], and the maximum range of a system located at world height will generally be equal to the maxRange for the current weather.
@@ Line 95: / Line 97: @@
 As of ComputerCraft 1.6, a [[Repeat|repeater script]] is available to all systems by default.
 ==Protocols==

← Older revision		Revision as of 03:16, 26 December 2015
Line 3:		Line 3:
	The Rednet API allows systems to communicate between each other without using redstone. It serves as a wrapper for the [[modem (API)\|modem API]], offering ease of functionality (particularly in regards to [[Repeat\|repeating signals]]) with some expense of fine control.		The Rednet API allows systems to communicate between each other without using redstone. It serves as a wrapper for the [[modem (API)\|modem API]], offering ease of functionality (particularly in regards to [[Repeat\|repeating signals]]) with some expense of fine control.

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

@@ Line 101: / Line 101: @@
 ==History==
-Before the creation of the in-game wireless networking API, the term "Rednet" referred to a system created by a ComputerCraft user based on bundled cables from the popular Minecraft mod [http://www.eloraam.com RedPower]. That also allowed communication between computers, but the data was transferred slowly - every bit was converted to redstone signal (using the [[redstone (API)|redstone API]]) that lasted about 0.05 seconds (the length of a MineCraft "tick"). That system was rendered redundant by the release of ComputerCraft 1.3, as this heralded the arrival of [[Wireless Modem|wireless networking]] to the mod and allowed instant communications between computers.
+Before the creation of the in-game wireless networking API, the term "Rednet" referred to a system created by a ComputerCraft user based on bundled cables from the popular Minecraft mod [http://www.eloraam.com RedPower]. That also allowed communication between computers, but the data was transferred slowly - every bit was converted to redstone signal (using the [[redstone (API)|redstone API]]) that lasted about 0.05 seconds (the length of a Minecraft "tick"). That system was rendered redundant by the release of ComputerCraft 1.3, as this heralded the arrival of [[Wireless Modem|wireless networking]] to the mod and allowed instant communications between computers.
 Later, ComputerCraft 1.51 brought forward [[Wired Modem]]s, which could not only be used for regular network communications, but to interact with [[peripheral]]s remotely.

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

@@ Line 21: / Line 21: @@
 {{API table/row
-|[[rednet.send]]({{type|number}} receiverID, {{type|string}} message, [<nowiki/>{{type|string}} protocol])
+|[[rednet.send]]({{type|number}} receiverID, {{type|any}} message, [<nowiki/>{{type|string}} protocol])
 |{{type|nil}}
-|Sends a message "intended" for another system with a specific ID, using the currently opened sides. The <var>receiverID</var> is the ID {{type|number}} (note - '''not''' a {{type|string}}) of the computer you're sending the message to. Later versions or ComputerCraft allow some other data types as the message.}}
+|Sends a message "intended" for another system with a specific ID, using the currently opened sides. The <var>receiverID</var> is the ID {{type|number}} (note - '''not''' a {{type|string}}) of the computer you're sending the message to. The [[Variables|types]] that can be sent as the message vary depending on the version of ComputerCraft in use.}}
 {{API table/row
-|[[rednet.broadcast]]({{type|string}} message, [<nowiki/>{{type|string}} protocol])
+|[[rednet.broadcast]]({{type|any}} message, [<nowiki/>{{type|string}} protocol])
 |{{type|nil}}
 |Sends the message to ''all'' connected and open computers.
@@ Line 33: / Line 33: @@
 {{API table/row
 |[[rednet.receive]]([<nowiki/> [<nowiki/>{{type|string}} protocolFilter, ] {{type|number}} timeout])
-|{{type|number}} senderID, {{type|string}} message, {{type|number}} distance / {{type|string}} protocol
+|{{type|number}} senderID, {{type|any}} message, {{type|number}} distance / {{type|string}} protocol
 |Waits until a rednet message of the specified protocol has been received, or until <var>timeout</var> seconds have passed. Leave all arguments empty to wait for any message indefinitely. If only a single, numerical argument is passed, will wait that many seconds for a message of any protocol. Versions of ComputerCraft prior to 1.6 may return the distance to the transmitting computer - 1.6 or later returns message protocols instead, though distance can still be obtained via direct use of the [[Modem (API)|Modem API]].}}
@@ Line 72: / Line 72: @@
 |desc=Fired when a rednet message is received (can be pulled via [[os.pullEvent|os.pullEvent()]] directly as an alternative to using [[rednet.receive|rednet.receive()]]).
 |return1={{type|number}} senderId
-|return2={{type|string}} message
+|return2={{type|any}} message
 |return3={{type|number}} distance / {{type|string}} protocol
 }}

@@ Line 121: / Line 121: @@
 }}
-{{API table|Term|image=Grid disk.png|2=
+{{API table|Deprecated Rednet Functions|image=Grid disk.png|2=
 {{API table/row

← Older revision		Revision as of 00:19, 24 October 2014
Line 1:		Line 1:
		+	''For a tutorial on how to use the API, visit [[Rednet Tutorial]].''
		+
	The Rednet API allows systems to communicate between each other without using redstone. It serves as a wrapper for the [[modem (API)\|modem API]], offering ease of functionality (particularly in regards to [[Repeat\|repeating signals]]) with some expense of fine control.		The Rednet API allows systems to communicate between each other without using redstone. It serves as a wrapper for the [[modem (API)\|modem API]], offering ease of functionality (particularly in regards to [[Repeat\|repeating signals]]) with some expense of fine control.

@@ Line 1: / Line 1: @@
-The Rednet API allows systems to communicate between each other without using redstone. It serves as a wrapper for the [[modem (API)|modem API]], offering ease of functionality (particularly in regards to [[Repeat (program)|repeating signals]]) with some expense of fine control.
+The Rednet API allows systems to communicate between each other without using redstone. It serves as a wrapper for the [[modem (API)|modem API]], offering ease of functionality (particularly in regards to [[Repeat|repeating signals]]) with some expense of fine control.
 In order to send and receive data, a [[modem]] (either [[Wired Modem|wired]] or [[Wireless Modem|wireless]]) is required. The data reaches any possible destinations immediately after sending it, but is [[#Range|range limited]].
@@ Line 92: / Line 92: @@
 For wired networks, range between devices is 256 blocks of [[Networking_Cable|network cable]] (unconfigurable). Either method of communication works regardless as to whether the intervening chunks are loaded or not.
-As of ComputerCraft 1.6, a [[Repeat (program)|repeater script]] is available to all systems by default.
+As of ComputerCraft 1.6, a [[Repeat|repeater script]] is available to all systems by default.