Pipez · Addon guide · Intermediate
PipezRetriever Addon Guide: How to Pull Items From a Distance
In standard Pipez networks, you must configure every single source connection to extract, which becomes tedious and expensive when managing dozens of machines or storage chests. This guide will teach you how to use the PipezRetriever addon (or the retrieval mechanic within the Pipez family) to pull items, fluids, and gases toward a single destination from a distance. Mastering this setup drastically reduces the number of Pipe Upgrades you need to craft and keeps your automation clean and server-friendly.
What you need
- Item Pipes, Fluid Pipes, Gas Pipes, or Universal Pipes (depending on what you are moving)
- A Pipe Wrench (or any compatible Forge wrench)
- A Retriever Upgrade or a standard Pipe Upgrade (Basic, Improved, Advanced, or Ultimate, depending on your modpack's exact addon version—check JEI for the exact recipe)
- Multiple source inventories (e.g., Chests, Furnaces, Fluid Tanks)
- A destination inventory (e.g., a central storage controller or processing machine)
Step by step
1Lay Down the Pipe Network
Connect all of your source blocks (such as a row of chests or machines) to your single destination block using your chosen Pipez pipe. Make sure the pipes visibly connect to the sides of the inventories you want to interact with. Do not set any of the connections on the source blocks to extract.
Tip: If two pipes accidentally connect to adjacent machines you want to keep separate, sneak-right-click the joint with your Pipe Wrench to disconnect them.
2Enable the Active Connection at the Destination
Walk over to your destination inventory where you want all the items, fluids, or gases to arrive. Hold your Pipe Wrench, sneak, and right-click the specific end of the pipe that touches the destination block. You will see a wider collar or flange appear on that connection, indicating it is now an active node with an internal block entity.
3Install the Retriever Upgrade
Right-click the newly formed collar on your destination pipe with an empty hand to open its configuration GUI. Place your Retriever Upgrade (or standard Pipe Upgrade if your addon uses a toggle button) into the upgrade slot on the right side of the interface. If the addon uses a mode toggle instead of a dedicated item, click the Extraction/Retrieval mode button in the GUI to switch from 'Push' to 'Pull'.
Tip: Check JEI to see which tier of upgrade unlocks filtering and speed boosts in your specific modpack, as Advanced and Ultimate tiers are typically required for complex filters.
4Configure Retrieval Distribution Mode
With at least an Improved tier upgrade installed, look at the distribution mode button in the pipe GUI. Cycle through the options—Nearest First, Furthest First, Round Robin, or Random—to decide the order in which the retriever pulls from your distant sources. For example, select Round Robin if you want to pull items evenly from a wall of twenty different barrels.
5Set Up Whitelist or Blacklist Filters
If you only want to pull specific items from across the network, make sure an Advanced or Ultimate tier upgrade is installed. Click the 'Add' button in the filter section, then place the target item from your inventory into the ghost slot (or type its ID). Toggle the filter mode between Whitelist and Blacklist so the retriever doesn't accidentally empty out raw materials or fuel from distant machines.
Tip: If you are retrieving damaged gear or enchanted books, click the NBT button in the filter menu to ignore or strictly match NBT data.
6Target Specific Sources with the Filter Destination Tool
If you want your retriever to pull a specific item only from one particular distant chest, craft a Filter Destination Tool. Right-click the exact face of the distant source block where the pipe connects to save its coordinates. Return to your retriever node, open the filter you created, and insert the Filter Destination Tool into the destination slot to bind that rule to that specific block.
Tip: All filter data and settings are saved directly onto the upgrade item itself; you can copy complex retrieval configs by placing a configured upgrade and a blank one together in a crafting grid.
How it works
To understand why retrieving is so powerful in the Pipez ecosystem, you have to understand how the mod prevents lag. In a standard Pipez network, basic pipe segments are completely passive and do not contain block entities (TileEntities). Only the pipe ends that have been wrench-clicked into an active state actually tick and scan the network.
Normally, if you want to empty 30 chests into one main storage block, you have to wrench-click all 30 chest connections and put 30 upgrades into them. That creates 30 ticking block entities constantly scanning the network for a valid destination.
By using a Retriever setup at the destination instead, you invert this logic. Only the single pipe connection at your destination block becomes an active block entity. On its tick cycle, it scans outward through the passive pipe network, locates the connected source inventories, checks their contents against your filters, and pulls the valid items or fluids directly across the network into its attached block. You get the exact same result using only one ticking block entity and one upgrade.
Common mistakes
- Setting both ends to active: If you wrench-click the source pipe AND the destination retriever pipe, both ends will fight or fail to see each other as valid passive connections. Leave all distant source connections completely untouched (passive).
- Using too low an upgrade tier for filters: Players often place a Basic Upgrade into a retriever and wonder why the filter slots are locked. You must use at least an Advanced tier upgrade to unlock filtering capabilities.
- Forgetting to select the right tab on Universal Pipes: If you use Universal Pipes to retrieve both items and fluids, remember to click the Item, Fluid, or Gas tabs on the far left of the pipe GUI. An upgrade or filter placed in the Item tab will not pull fluids.
- Clicking the wrong block face with the Filter Destination Tool: When binding a specific source block to a filter, you must click the exact side of the machine or chest that touches the pipe, otherwise the retriever will not recognize the connection.
FAQ
Does a retriever pipe cause more lag than normal extraction pipes?
No, it actually causes less lag when gathering from multiple sources. Because only active pipe ends create ticking block entities, one retriever pulling from 20 chests means only 1 block entity is ticking instead of 20.
Why is my retriever pulling items so slowly?
Base pipe speed without upgrades or with a Basic tier is intentionally slow. Upgrade your retriever to an Advanced or Ultimate tier to dramatically increase both the tick speed and the stack size pulled per operation.
Can I use redstone to pause my retriever?
Yes. As long as you have at least a Basic tier upgrade installed, you can toggle the Redstone Mode button in the GUI to 'On when powered' or 'Off when powered' and place a lever or redstone signal next to the active retriever pipe segment.
Why isn't my retriever pulling items from a Vanilla Furnace or modded machine?
Pipez respects sided inventory rules. Even when pulling from a distance, the passive end of the pipe must be touching the correct output face of the machine (for example, the bottom of a Vanilla Furnace to pull smelted items).
By placing a single Retriever setup on your destination block while leaving distant connections passive, you can effortlessly pull items, fluids, and gases across your entire base using minimal resources and zero extra server lag.