View source for Wireless Modem

{{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=ComputerCraft:CC-Peripheral
|damage-value=1
|is-peripheral=Yes
|peripheral-api=Modem (API)
}}
Modems are blocks which can be used to wirelessly transfer data between [[Computer]]s and [[Turtle]]s, using the [[Rednet_(API)|Rednet API]] or the [[Modem_(API)|Modem API]].
To place a modem on a side of a computer, right-click 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.

See also: [[Wired Modem]], [[Ender Modem]].

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

== History ==
{{History|head}}
{{History|1.3|Added Wireless Modems.}}
{{History|1.4|The send and receive range of wireless modems now increases with altitude, allowing long range networking from high-altitude Computers.}}
{{History|1.5|Redesigned Wireless Modems; they can now send and receive on multiple channels, independent of the computer ID.}}
{{History|1.51|Changed crafting recipe.}}
{{History|foot}}

{{BlocksItemsList}}

[[Category:Blocks]]