Integrated Dynamics · Addon guide · Beginner
Integrated Tunnels Guide: How to Transfer Items, Fluids & Energy at Max Speed
Integrated Tunnels expands your Integrated Dynamics networks by letting you move items, fluids, and energy across your base with zero travel delay. By mastering Interfaces, Importers, and Exporters alongside Variable Cards, you can build instant, infinitely scalable transfer systems that easily outperform standard pipes. This guide will walk you through setting up basic transfers, separating network traffic with channels, and configuring max-speed throughput.
What you need
- Logic Cable
- Variable Card (multiple)
- Logic Programmer (Block or Portable)
- Variable Store (for complex filtering)
- Item Interface, Item Importer, and/or Item Exporter
- Fluid Interface, Fluid Importer, and/or Fluid Exporter
- Energy Interface, Energy Importer, and/or Energy Exporter
- Wrench (from Integrated Dynamics or any compatible tech mod)
Step by step
1Understand the Three Part Types
Before placing cables, you need to know how Integrated Tunnels handles inventory connections. An Interface passively exposes an attached block's inventory, tank, or energy buffer to the network so other parts can interact with it. An Importer actively pulls resources from an attached block into the network (attempting to push them into valid Interfaces), while an Exporter actively pushes resources from the network's Interfaces into the attached block. Remember that a connection requires at least one passive Interface and one active Importer or Exporter; two Interfaces connected together will do nothing on their own.
Tip: You only need one active part per transfer route—pair one Importer with multiple Interfaces, or one Interface with multiple Exporters.
2Build a Basic Transfer Network
Place your source chest and destination chest a few blocks apart and connect them with a line of Logic Cables. Attach an Item Interface onto the cable facing the source chest, and attach an Item Exporter onto the cable facing the destination chest. At this point, nothing will move yet because the Exporter has not been told what to export.
Tip: Hold a Wrench and right-click the center of a cable part to open its settings, or shift-right-click to detach it cleanly.
3Activate Transfers with a Boolean Variable
Right-click your Item Exporter to open its GUI, where you will see a list of aspects such as 'Export all items'. To turn this on, take a blank Variable Card, insert it into a Logic Programmer, select the 'Boolean' type, and check the box to ignored/true (or leave a fresh card completely blank, as blank cards often default to a 'true' boolean when inserted into basic boolean slots, though explicitly programming 'True' is best practice). Place this Boolean Variable Card into the 'Export all items' slot inside the Exporter, and items will immediately begin moving from the Interface's chest to the Exporter's chest.
Tip: Check the green or red indicator light next to the slot in the Exporter GUI; green means the Variable Card is valid and active.
4Filter Specific Items, Fluids, or Predicates
If you only want to move a specific resource, remove the card from 'Export all items' and look at the 'Export item' aspect slot down below. Open your Logic Programmer, select the 'Item' element, place the item you want to filter (like Iron Ingot) into the virtual slot, and write it to a blank Variable Card. Insert this new card into the 'Export item' slot of your Exporter. Now, the Exporter will ignore everything in the source chest except Iron Ingots.
Tip: Click the '+' button next to an aspect inside the Exporter GUI to configure exact matching behaviors like ignoring NBT, damage values, or stack sizes.
5Separate Traffic Using Channel IDs
When you put Item, Fluid, and Energy parts on the same Logic Cable network, they naturally stay out of each other's way, but multiple item setups on one cable can cross-contaminate. To isolate specific routes, open the GUI of both your Item Interface and your Item Exporter, and click the '+' button or top-right settings gear to find the 'Channel' setting. By default, every part operates on Channel 0. Change both the source Interface and destination Exporter to Channel 1 so they exclusively talk to each other and ignore all Channel 0 inventories on the same wire.
Tip: Setting a part's channel to -1 allows it to interact with all channels across the entire network simultaneously.
6Maximize Transfer Speed and Bypass Tick Limits
By default, Importers and Exporters move a sensible amount of items (such as a single stack) or fluid/energy per operation at a set tick interval. To hit max speed, open the part's GUI, click the '+' icon next to the active transfer aspect, and look for the Transfer Rate (or craft rate/amount) and Tick Interval properties. Lower the tick interval down to 1 tick so it runs twenty times a second, and increase the transfer rate up to the maximum integer limit (2,147,483,647) for energy and fluids, or the max stack limit allowed by your server's config.
Tip: Check the in-game guide book 'On the Dynamics of Integration' or your modpack's config files if your rate seems capped, as some modpacks restrict maximum single-tick transfers for server performance.
7Filter Multiple Items with a List and Variable Store
To filter more than one item type in a single Exporter, open your Logic Programmer and choose the 'List' option to create a custom list of items on a Variable Card (or use the 'Operator' features to build complex filters). If you combine multiple Variable Cards using operators (such as combining two lists or checking item tags), you must place the referenced base cards inside a Variable Store block attached anywhere on your Logic Cable network. Finally, place the final resulting List Variable Card into the 'Export items' (list) aspect slot of your Exporter.
Tip: Always label your Variable Cards inside an Anvil or the Logic Programmer so you do not lose track of which cards live inside your Variable Store.
How it works
Unlike traditional pipe mods that physically move entities through tubes from block A to block B, Integrated Tunnels treats your entire network as a single virtual pool of inventories. Interfaces act as windows into attached chests, machines, or tanks, indexing their contents onto the network without actually pulling the items out into the cables.
Importers and Exporters are event-driven writers that evaluate the Variable Card placed inside their active aspect slot every time their internal tick counter completes a cycle. When the card evaluates to valid—whether it is a simple 'True' boolean or a complex list of items—the part immediately teleports the allowed amount directly between the target block and the valid Interfaces on the matching Channel ID.
Because every aspect is controlled by the core Integrated Dynamics logic system, your transfer setups are completely dynamic. Instead of manually swapping filters, you can point a Reader part at a machine or tank, evaluate its fullness with an Operator in a Variable Store, and feed the output directly into an Exporter—allowing your pipes to turn on, turn off, or switch filtered items automatically based on real-time base conditions.
Common mistakes
- Connecting an Interface to another Interface: Interfaces are completely passive. If you put an Item Interface on two chests, nothing will ever transfer between them; one side must be an Importer or an Exporter.
- Forgetting the Variable Store when using linked cards: If you create a Variable Card that depends on another Variable Card (like a filtered list or a reader output) and keep the original card in your player inventory, the Exporter will show an error. All referenced cards must be placed inside a Variable Store connected to the network.
- Choosing the wrong Aspect type for your Variable Card: Putting an 'Item' Variable Card into an 'Export all items' (Boolean) slot or an 'Export items' (List) slot will fail. Always match the colored data-type icon of your Variable Card to the exact icon shown on the aspect slot.
- Running every operation at 1-tick interval unnecessarily: While setting every Importer to operate every single tick feels fast, doing this across hundreds of machines can cause server tick lag. Keep non-critical transfers at the default tick rate and increase the batch transfer amount instead.
FAQ
How do I set priority so items go to a specific chest first?
Open the GUI of your Interfaces or Exporters and click the top settings gear to find the 'Priority' value. The network will always pull from or push to parts with a higher priority number before moving on to lower priority numbers on the same channel.
Can I transfer items, fluids, and energy through the exact same Logic Cable?
Yes! A single strand of Logic Cable can carry item, fluid, and energy connections simultaneously, as well as standard logic signals, without any interference.
How do I achieve round-robin distribution across multiple machines?
Click the '+' button next to the active aspect inside your Importer or Exporter and scroll through the aspect properties. You can toggle the transfer mode from ordered/priority to round-robin so it splits outputs evenly across all valid Interfaces on that channel.
Why is my Energy Exporter not pushing power at max speed?
First, check the '+' settings inside the Energy Exporter's active aspect and manually increase the transfer rate number, as the default value is quite modest. Also verify that the receiving machine or battery does not have its own internal input rate limit.
By pairing passive Interfaces with active Importers and Exporters controlled by Variable Cards, Integrated Tunnels gives you instant, customizable, and high-speed logistics for items, fluids, and energy over a single cable network.