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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

More XNet guides

XNet · ExplainedXNet Channels, Colors, and Connectors ExplainedMastering XNet allows you to build completely lag-free, single-cable networks that move items, fluids, power, and logic simultaneously across your entire base. In this guide, you will learn the core logic behind the 8 controller channels, how to physically isolate networks using the 4 cable colors, and when to upgrade from Standard to Advanced Connectors. Understanding these fundamentals will help you replace bulky, chaotic pipe setups with clean and efficient automation.Beginner7 steps
XNet · PowerHow to Build a Lag-Free Power Grid with XNetIn this guide, you will learn how to build an ultra-efficient, centralized power distribution grid using XNet to send Forge Energy (FE) or Redstone Flux (RF) from your generators to all of your machines. Unlike traditional energy conduits that constantly calculate paths and cause server lag, XNet uses a single Controller and lightweight cables to move power instantly across huge distances. By the end, you will have a self-sustaining network that powers your entire base and keeps its own brain running smoothly.Beginner7 steps
XNet · Setup guideHow to Set Up Item and Fluid Routing in XNetIn this guide, you will learn how to build a lag-free, automated item and fluid sorting network using XNet. Mastering XNet routing allows you to organize massive storage rooms and processing lines through a single cable line, replacing messy spaghetti pipes with clean, intelligent distribution logic.Intermediate7 steps
XNet · AutomationHow to Automate Ore Processing with a Single XNet CableLearn how to automate a complete ore-doubling and smelting production line using a single row of XNet cables. Instead of running separate pipes for energy, input items, and output items, you will use one Advanced Connector per machine to handle power, ore insertion, and ingot extraction simultaneously. This approach eliminates cable spaghetti, saves space, and drastically reduces server lag.Intermediate7 steps
XNet · ExplainedXNet Logic Channels & Redstone Control ExplainedMastering XNet's Logic channels allows you to automate complex factory processes without running a single piece of external Redstone dust. In this guide, you will learn how to use internal sensors to monitor item counts, fluid levels, and RF storage, and then use colored internal signals to dynamically toggle other XNet operations on and off. This keeps your builds compact, lag-free, and capable of smart self-regulation.Advanced7 steps
XNet · ProgressionXNet Progression Guide: Scaling Up with Routers & Wireless RoutersA single XNet Controller is strictly limited to eight active channels, which can quickly bottleneck large, automated bases. By mastering XNet Routers and Wireless Routers, you can link multiple controllers together to bypass this limit and transmit items, fluids, and energy across vast distances or even across dimensions. This guide will walk you through building a scalable, multi-controller routing network.Advanced8 steps