Wireless Modem

2013-04-09T14:02:01Z

Zaptross: added note to top that modems can send via specific channels

{{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)

[[Category:Peripherals]]

ComputerCraft Wiki - User contributions [en]

Wireless Modem