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

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

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

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

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

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

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

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

More Integrated Dynamics guides

Integrated Dynamics · Getting startedIntegrated Dynamics Getting Started Guide: Menril, Squeezers & Your First NetworkIntegrated Dynamics is one of the most powerful logic, automation, and logistics mods available, and it all starts with a single blue tree. In this guide, you will learn how to harvest Menril, operate the manual Squeezer and Drying Basin to craft your first components, build a basic reading network, and finally upgrade to powered mechanical machines. Mastering this early resource loop is essential because every cable, terminal, and variable card in the mod family relies on crystallized Menril.Beginner6 steps
Integrated Dynamics · ExplainedVariables, Readers & Writers Explained: How Integrated Dynamics Logic WorksIntegrated Dynamics can seem intimidating at first, as it replaces simple redstone wires with a full programming system based on data types and logic evaluations. In this beginner guide, you will learn how to read information from the world using Readers, bind that data to Variable Cards, display it on Display Panels, and trigger physical actions using Writers. Mastering this fundamental workflow is the key to unlocking the most powerful, lag-free automation networks in modded Minecraft.Beginner7 steps
Integrated Dynamics · ExplainedHow to Use the Logic Programmer: Operators, Lists & Predicates ExplainedMastering the Logic Programmer in Integrated Dynamics transforms basic redstone setups into intelligent, automated systems capable of processing complex data. In this guide, you will learn how to combine Variable Cards using operators, manipulate data lists, and apply functional programming concepts like predicates, map, and filter to build dynamic sorting and control networks.Intermediate8 steps
Integrated Dynamics · Setup guideHow to Build a Storage Network with Integrated Terminals & TunnelsBuild a centralized, searchable storage and crafting system early in your survival world without needing expensive digital drives or massive power grids. By combining Integrated Dynamics with the Integrated Tunnels and Integrated Terminals addons, you can link all your existing chests, barrels, and storage drawers into one seamless interface.Beginner7 steps
Integrated Dynamics · Addon guideIntegrated Crafting Guide: How to Set Up Auto-Crafting & Machine ProcessingMastering auto-crafting with the Integrated Dynamics mod family allows you to automate both standard 3x3 crafting recipes and complex multi-step machine processing on demand. By leveraging the Integrated Crafting, Integrated Tunnels, and Integrated Terminals addons, you can build a surprisingly cheap and scalable request-based automation network early in your progression. This guide walks you through encoding Recipe Variable Cards, configuring Crafting Interfaces on tables and furnaces, and managing jobs through terminals.Intermediate7 steps
Integrated Dynamics · PowerHow to Build an Automated Menril Power Plant (Generator & Battery Guide)In this guide, you will learn how to build a self-regulating Menril power plant using Integrated Dynamics and Integrated Tunnels. By reading the fill level of your Energy Batteries, your network will automatically feed wood from a tree farm into your Generators only when power is needed, preventing fuel waste.Intermediate8 steps