XNet · Getting started · Beginner
XNet Getting Started Guide: First Controller & Cable Network
XNet allows you to condense complex tangles of item, fluid, and energy pipes into a single, lag-free network line. In this guide, you will craft your first XNet Controller, wire up a basic cable network, and configure a channel to automatically transfer items between two chests. Mastering this fundamental setup is the key to building clean, super-efficient factory automation.
What you need
- 1x XNet Controller (requires a Machine Frame from RFTools, Redstone, Iron, and Gold; check JEI for exact recipe)
- 3x Connectors (Matching color, usually Blue by default; crafted with Lapis Lazuli, Redstone, and Iron/Gold)
- Several Network Cables (Matching color to your Connectors)
- 2x Chests (or any standard inventory blocks)
- 1x Forge Energy (FE/RF) power source (e.g., a basic coal generator or energy cell)
Step by step
1Place Your Inventories and Controller
Start by placing two standard Chests a few blocks apart from each other. Place your XNet Controller nearby, and place your power generator right next to the Controller (or within easy reach). Put a stack of cobblestone or any test item into the first chest so you have something to transfer.
Tip: You can name your chests in an Anvil before placing them, or name the connections later inside the Controller GUI to keep large factories organized.
2Attach Connectors to the Blocks
Equip your Blue Connectors. Hold Shift (Sneak) and right-click a Connector directly onto the first Chest, the second Chest, and the XNet Controller itself (or onto your generator if it is not touching the Controller directly). You will see a flat plate attach to the side of each block.
Tip: Network Cables cannot interact with machines or chests on their own; you must always use a Connector as the bridge between a block and a cable.
3Link Everything with Network Cables
Use your Blue Network Cables to connect the three Connectors together into one continuous line. As you place the cables, they will visually snap together and link into the Connectors. Make sure your Controller is receiving power directly from your adjacent generator, or wire the generator into the network using another Connector so you can power the Controller later.
Tip: Network Cables are not Tile Entities, meaning you can run them for thousands of blocks without causing server or FPS lag.
4Power the XNet Controller
Right-click the XNet Controller to open its interface. Check the vertical energy bar on the far left of the screen to verify it is filling up with power from your adjacent generator. The Controller requires a small amount of continuous energy to operate and an additional tiny draw for every active channel you run.
Tip: If your generator isn't touching the Controller directly, you can actually use XNet itself to move energy from the generator to the Controller, though direct adjacency is easiest for your first setup.
5Create an Item Channel
At the top of the Controller GUI, you will see numbered columns representing Channels 1 through 8. Click on the large empty box at the very top of Channel 1. In the configuration panel on the right side of the screen, click the drop-down menu that currently says 'Off' and change the channel type to 'xnet.item' (Item Channel).
Tip: A single XNet cable network supports up to 8 independent channels, allowing you to transfer items, fluids, and power through the exact same wire simultaneously.
6Configure the Extraction Chest
Look at the list of connected blocks on the left side of the GUI and locate your first Chest (the one holding your items). Click the empty slot where that Chest's row intersects with the Channel 1 column, then click the 'Create' button on the right panel. Change its mode from 'Ins' (Insert) to 'Ext' (Extract) so the network knows to pull items out of this inventory.
Tip: By default, item extraction operates on a set tick interval; you can adjust the transfer stack size and speed in the right-hand panel.
7Configure the Insertion Chest
Find your second Chest in the block list on the left. Click the empty intersection slot under the same Channel 1 column and click 'Create' on the right panel. Because new connections default to 'Ins' (Insert) mode, you do not even need to change the mode— examine your chests and you will see items immediately moving from the first chest into the second!
Tip: You can add an item filter in the right-hand panel for either the Insert or Extract node if you only want specific items to move.
How it works
Unlike traditional piping mods where items physically travel through hollow tubes from point A to point B, XNet operates like a computer network. The Network Cables are completely passive blocks (not Tile Entities), which is why they generate virtually zero lag even over massive distances. They simply define which Connectors belong to the same physical circuit.
The XNet Controller is the brain of the operation. Every few ticks, the Controller scans all active Channels from 1 to 8. Within each channel, it checks every block assigned to 'Extract', reads what is available, and instantly teleports those resources to valid 'Insert' blocks on that exact same channel.
Because the logic is handled purely through channel columns inside the Controller rather than physical pipe paths, you can run items on Channel 1, Forge Energy on Channel 2, and fluids on Channel 3 all through the exact same single block of cable without them ever interfering with each other.
Common mistakes
- Using Network Cables without Connectors: Running a Network Cable directly into a chest or machine does nothing. You must place a Connector directly onto the inventory block first.
- Mismatched Cable Colors: XNet features different colored cables (Blue, Yellow, Red, Green) so you can run separate networks side-by-side without them connecting. Ensure your Connectors and Cables are the exact same color.
- Forgetting to power the Controller: Unlike simple mechanical pipes, an XNet network is completely dead until the XNet Controller block itself has Forge Energy (FE/RF) inside its internal buffer.
- Putting Extract and Insert on different channels: Both the source chest (Extract) and destination chest (Insert) must be created under the same vertical Channel column (e.g., both under Channel 1) to communicate.
FAQ
Why aren't my items moving even though everything is configured?
First, check if the XNet Controller has power in its left-hand energy bar. Second, make sure both chests have a Connector attached, are in the same vertical Channel column, and that one is set to 'Ext' while the other is set to 'Ins'.
How do I tell two identical chests apart in the Controller GUI?
Wait next to one chest and double-click its entry on the left list of the Controller GUI; this highlights the physical block in the world with a glowing outline. You can also type a custom label into the 'Name' box on the Connector itself to organize your list.
What is the difference between a normal Connector and an Advanced Connector?
Advanced Connectors allow faster transfer rates, give you access to all 6 sides of a machine remotely (even if the connector is only touching the bottom), and hold more internal energy.
Can I have two XNet Controllers on the same cable line?
No, having two Controllers on the exact same connected color network will cause a conflict and shut the network down. If you need more than 8 channels, use a different colored cable or look into crafting an XNet Router.
By combining a powered XNet Controller with a single line of Connectors and Network Cables, you can manage all your base's item transfers cleanly from one central interface.