CC: Tweaked · Explained · Intermediate
Peripherals & Wired Networks Explained: Wrapping, Modems & Networking Cables
In CC: Tweaked, a standalone Computer can only do so much on its own; its real power comes from controlling external blocks known as peripherals. This guide will teach you how to connect your Computer to adjacent and distant machines—like Monitors, Speakers, and Chests—using Wired Modems, Networking Cables, and the Lua peripheral API. Mastering wired networks allows you to manage an entire base's inventory and automation from one central terminal.
What you need
- 1x Computer or Advanced Computer
- 1x Monitor or Advanced Monitor (or a Speaker)
- 1x Chest or Barrel
- 3x Wired Modem (minimum)
- Several Networking Cables
- Basic familiarity with the Lua prompt or the edit program
Step by step
1Wrap an Adjacent Peripheral Directly
Place a Monitor directly on the right side of your Computer. Right-click the Computer to open its terminal, type 'lua' and press Enter to enter the interactive Lua prompt. Type 'mon = peripheral.wrap("right")' and press Enter. You now have a control object stored in the variable 'mon', which you can test by running 'mon.write("Hello!")'.
Tip: Valid direct side names are top, bottom, left, right, front, and back—always relative to the direction you are facing when looking at the Computer's screen.
2Attach Wired Modems to Your Blocks
Since a Computer only has six faces, you need a wired network to connect more devices or reach across rooms. Break your Monitor and move it a few blocks away, then place a Chest nearby as well. Hold Shift and right-click to attach a Wired Modem directly onto the back of your Computer, the back of the Monitor, and the side of the Chest.
Tip: You can also craft a Wired Modem by itself in a crafting grid to toggle it into a full-block Wired Modem if you prefer not to use the flat part version.
3Connect the Network with Networking Cables
Take your Networking Cables and place them in a continuous line connecting the Wired Modem on your Computer to the Wired Modems on the Monitor and the Chest. The cables will visually snap to the center of each modem. At this point, the physical wiring is complete, though the distant devices are not yet logically visible to the Computer.
Tip: If two cables run parallel and you do not want them to connect, right-click the junction with an empty hand or sneak-click to separate the cable connections.
4Activate the Remote Wired Modems
Walk over to the Wired Modem attached to the Monitor and right-click the modem itself with an empty hand. Its outer border will turn red, and a chat message will appear saying something like 'Peripheral "monitor_0" connected to network'. Repeat this right-click action on the Wired Modem attached to the Chest to assign it a network name like 'minecraft:chest_0'.
Tip: You do not need to turn on the red ring for the Wired Modem attached to the Computer itself unless you want other Computers on the network to access it.
5Verify Network Connections in Shell
Return to your Computer terminal. If you are still in the 'lua' prompt, type 'exit()' to return to the regular CraftOS shell. Run the built-in command 'peripherals' and press Enter. The screen will list the attached modem on the back, followed by the exact network names of your remote Monitor and Chest.
Tip: If a remote block does not show up in this list, double-check that its Wired Modem has a glowing red ring and that no cable segment is broken.
6Wrap a Networked Peripheral by Name
Open the interactive 'lua' prompt again. Instead of passing a side like 'right', pass the network name you saw in the chat message: 'remoteMon = peripheral.wrap("monitor_0")'. You can now run 'remoteMon.clear()' or 'remoteMon.write("Networked!")' and the text will appear on the Monitor across the room.
Tip: Network names increment automatically (monitor_0, monitor_1, etc.) every time a new block of that type is activated on any modem in the world.
7Use peripheral.find() for Hardware-Independent Code
Hardcoding names like 'monitor_0' can break your script if you move the modem. Instead, use 'mon = peripheral.find("monitor")' in your Lua code. This function automatically scans all six sides and the entire connected wired network, returning the first wrapped Monitor it finds regardless of its side or number.
Tip: If you have multiple peripherals of the same type, 'peripheral.find("inventory")' actually returns multiple values, which you can capture in a table using '{ peripheral.find("inventory") }'.
8Move Items Between Networked Inventories
Place a second Chest with an activated Wired Modem onto your cable line, and put some Cobblestone in the first Chest. In the Lua prompt, wrap the first chest with 'c1 = peripheral.wrap("minecraft:chest_0")'. Now run 'c1.pushItems("minecraft:chest_1", 1)' to instantly transfer items from slot 1 of the first chest into the second chest over the data cable.
Tip: For inventory transfer methods like pushItems and pullItems to work, both inventories must be connected to the exact same wired network as the Computer.
How it works
In CC: Tweaked, a Computer cannot directly manipulate blocks in the world without first creating a bridge between the game's Java code and your Lua environment. When you call peripheral.wrap() or peripheral.find(), the mod queries the target block to see if it exposes any compatible methods. It then generates a Lua table filled with functions—such as write() for a Monitor or list() for an inventory—and returns that table to your script.
Wired Modems and Networking Cables act as a virtual extension of the Computer's six physical faces. When you right-click a Wired Modem to turn its ring red, the modem registers the block it is attached to onto the shared cable bus under a unique string identifier. To the Computer's peripheral API, there is zero functional difference between wrapping 'top' and wrapping 'monitor_4'; both return the exact same function table.
One particularly powerful mechanic of wired networks is inventory item routing. Normally, Networking Cables only transmit data, not matter. However, CC: Tweaked's generic inventory peripheral exposes pushItems() and pullItems() methods that allow any two inventories sharing the same wired network to swap items directly. Because the mod validates that both blocks are reachable on the same network graph, your Computer can act as an instant item router without needing physical pipes or Hoppers.
Common mistakes
- Forgetting to right-click the remote Wired Modem: Simply placing a Wired Modem on a Chest or Monitor does nothing until you right-click the modem to turn its indicator ring red.
- Using Wireless Modems for remote peripheral wrapping: Wireless and Ender Modems can only send Rednet messages between computers; they cannot wrap a remote Chest or Monitor across the air. You must use Wired Modems and Networking Cables for remote peripherals.
- Using the wrong capitalization or string format: Lua is strictly case-sensitive, so 'Peripheral.Wrap("Right")' will throw an error. Always use lowercase 'peripheral.wrap("right")'.
- Trying to pushItems to an adjacent chest that isn't on the network: Even if two chests are touching your Computer on 'left' and 'right', pushItems works best and most reliably when all participating inventories are attached to the same Wired Modem network and referenced by their network names.
FAQ
How do I find out what functions a wrapped peripheral has?
In the lua prompt, after wrapping a device into a variable like 'p', you can inspect its available functions by running 'peripheral.getMethods("right")' (or using its network name), or by checking the in-game help system and autocompletion in the lua prompt.
Is there a distance limit for Networking Cables?
Within loaded chunks, Networking Cables can stretch quite far, though the network has a maximum node limit (check the mod's server configuration if building massive networks). Be aware that cables running into unloaded chunks will temporarily disconnect those peripherals until the chunks load again.
Can two different Computers share the same Wired Modem network?
Yes! Multiple Computers can connect to the same line of Networking Cables and concurrently wrap and control the exact same Monitors, Speakers, and Chests.
Why does my vanilla Chest work as a peripheral?
CC: Tweaked includes a built-in generic peripheral provider that automatically turns almost any block with an item inventory, fluid tank, or energy storage—from vanilla or other mods—into a wrappable peripheral.
By combining Wired Modems, Networking Cables, and the peripheral.wrap() or peripheral.find() functions, you can break free from your Computer's six-block physical limit and automate machines across your entire base.