Pipez · Explained · Intermediate
Filter Destination Tool Explained: Precise Routing in Pipez
In complex automation setups, a single extraction point often needs to distribute specific resources to completely different machines along the same pipe line. This guide explains how to use the Filter Destination Tool in the Pipez mod to bind specific item, fluid, or gas filters to exact block faces. Mastering this mechanic lets you build compact, lag-free shared pipe networks without messy sorting junctions.
What you need
- Item Pipes, Fluid Pipes, Gas Pipes, or Universal Pipes
- Pipe Wrench (or any compatible mod wrench)
- Advanced Pipe Upgrade or Ultimate Pipe Upgrade (required to unlock filtering)
- Filter Destination Tool
- One source inventory (such as a chest or tank) and multiple target machines or inventories
Step by step
1Build the Shared Pipe Network
Place your source inventory and connect it to two or more destination blocks using your chosen Pipez cables. Ensure the pipes visibly attach to the specific faces of the target machines where you want the resources to enter. Remember that some modded machines require input on specific sides, such as the top for smelting inputs or the back for fluids.
Tip: Universal Pipes are ideal here if you want to route both items and fluids from a single source to various machines using only one cable line.
2Configure the Extraction Point
Hold your Pipe Wrench, sneak, and right-click the pipe connection directly attached to your source inventory. A wide collar will appear on that end of the pipe, indicating it is now in extraction mode. In Pipez, all routing logic happens at the extraction point rather than the insertion points.
3Install at Least an Advanced Upgrade
Right-click the extracting collar on the pipe to open its configuration GUI. Place an Advanced Pipe Upgrade or an Ultimate Pipe Upgrade into the upgrade slot on the right side of the interface. Lower-tier upgrades like Basic or Improved only unlock redstone and distribution modes, whereas Advanced or higher is required to enable the filtering system.
Tip: Check JEI for the exact crafting recipes of the upgrades, as they scale in cost from iron and redstone up to diamonds and netherite.
4Record the Target Block Face
Walk over to your first destination machine while holding the Filter Destination Tool in your hand. Aim carefully at the exact face of the machine where the pipe connects, and right-click the block face itself (not the pipe). The tool will store the coordinates and the directional face of that specific inventory in its tooltip.
Tip: If the pipe renders in the way of the block face, position your crosshair at the very edge of the target block next to the pipe connection.
5Open the Filter Interface
Return to your source block and right-click the extracting pipe collar to reopen the main GUI. Make sure the overall filter mode button is set to Whitelist if you only want your specified items to move, or leave it as needed for your setup. Click the Add button in the center of the screen to create a new filter entry.
Tip: If you are using a Universal Pipe, first select the correct resource tab (Item, Fluid, or Gas) on the left side of the GUI before adding a filter.
6Specify the Resource to Route
Inside the filter creation menu, drag the item or fluid container you want to route from your inventory and click it into the resource slot on the left. Alternatively, you can type an item ID or forge tag into the text field next to the slot. If the item has durability or enchantments you wish to ignore, clear the NBT text box or adjust the NBT matching button.
7Bind the Recorded Destination
Take your programmed Filter Destination Tool and click it into the dedicated destination slot within the filter creation menu. The interface will read the location data from the tool and display the icon and face of your target block. Click the Submit or Save button to confirm the filter, and you will see the completed routing rule in the main filter list.
Tip: You only need to craft one Filter Destination Tool; once a filter is saved, you can take the tool back and right-click a new machine to program your next filter.
How it works
Unlike traditional pipe mods where filters are placed on the receiving end of a cable, Pipez is designed for maximum server performance. In a Pipez network, passive pipe segments and insertion connections do not have Block Entities at all. Only the extracting end of a pipe has a Block Entity that actively ticks and performs calculations.
Because the receiving ends of the pipe are completely passive, the extracting end must know in advance where every item or fluid is allowed to go. When you use the Filter Destination Tool, you are feeding exact X, Y, Z coordinates and a directional face (North, South, Up, Down, etc.) into the extracting pipe's upgrade data. When the pipe attempts to pull an item, it checks if that fixed coordinate and face are currently connected to the pipe line and have room to accept the item.
Furthermore, all filter rules and destination bindings are saved directly onto the Pipe Upgrade item itself rather than the pipe block in the world. This means if you break the pipe or remove the upgrade, your routing rules are safely preserved inside the upgrade item and can even be duplicated by crafting it together with a blank upgrade of the same tier.
Common mistakes
- Clicking the wrong face of the target block: If your pipe connects to the top of a furnace, but you right-click the front of the furnace with the Filter Destination Tool, the pipe will never send items there because no pipe is attached to the front face.
- Clicking the pipe instead of the machine: Using the Filter Destination Tool on the pipe cable itself saves the pipe's location rather than the inventory's location, causing the filter to fail.
- Using an Improved or Basic Pipe Upgrade: You cannot add filters or use the destination tool unless an Advanced, Ultimate, or Infinity upgrade is currently installed in the extracting pipe.
- Misunderstanding the Invert button on a destination filter: Clicking the paper icon inside a filter inverts the matched item or fluid (meaning send everything EXCEPT this item), but it does not invert the destination—those inverted items will still be routed specifically to that bound destination.
FAQ
Why are my items not moving even after I set up the filter and destination?
First, ensure the pipe end at the source chest was sneak-right-clicked with a wrench to set it to extract. Second, verify that the face you clicked with the Filter Destination Tool is the exact same side of the block that the pipe is physically connected to.
Do I need to craft a new Filter Destination Tool for every single machine?
No. Once you insert the tool into the destination slot and save the filter, the coordinate data is copied into the Pipe Upgrade. You can immediately reuse the same tool to bind a different machine for your next filter.
What happens if I have some filters with destinations and some without?
Filters with a specific destination will strictly route matching items to that exact block face. Any item matching a general filter without a destination will be sent to any valid connected inventory on the network, following the pipe's overall distribution mode (such as Nearest First or Round Robin).
Can I copy my complex destination filters to another pipe?
Yes, you can place your configured Pipe Upgrade into a crafting grid alongside a blank Pipe Upgrade of the same tier to copy all filter and destination data, though note that the copied coordinates will still point to the exact same machines.
By pairing an Advanced Pipe Upgrade with the Filter Destination Tool, you can centralize all your sorting logic at a single extraction point and route resources to exact machine faces across a shared, lag-free pipe network.