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

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

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

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

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

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

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

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

More Pipez guides

Pipez · Getting startedHow to Get Started with Pipez: Basic Setup & Wrench GuideIn this guide, you will learn how to craft and configure the fundamental logistics components of the Pipez mod, including the essential Pipe Wrench and basic transfer lines. Mastering these basics allows you to automate item, fluid, and energy movement across your base while maintaining maximum game performance and minimal lag.Beginner7 steps
Pipez · ProgressionPipez Upgrades Explained: Transfer Speeds, Tiers & FeaturesIn this guide, you will learn how to craft and apply the five upgrade tiers in the Pipez mod to dramatically increase your item, fluid, energy, and gas transfer speeds. Mastering these upgrades is essential because base pipes are intentionally slow and lack smart routing features like redstone control, distribution modes, and advanced filtering.Beginner6 steps
Pipez · ExplainedHow to Use Filters in Pipez: Tags, NBT Matching & WhitelistsMastering the filtering system in Pipez allows you to build ultra-compact, lag-free sorting networks for items, fluids, and Mekanism gases without needing dozens of dedicated chests or routers. By unlocking Advanced Upgrades, you gain access to granular rules including tag-based grouping, strict NBT data matching, and destination-specific routing. This guide will walk you through setting up and combining these filter tools to automate complex factory lines.Intermediate8 steps
Pipez · AutomationHow to Automate Machines with Universal Pipes (Single-Cable Setup)Learn how to use Universal Pipes from the Pipez mod to supply energy, insert raw materials, and extract finished products using only a single side of your machines. This setup eliminates cable spaghetti and allows you to build ultra-compact, lag-free processing lines.Intermediate8 steps
Pipez · ExplainedPipez Distribution & Redstone Modes Explained: Round Robin vs Nearest FirstMastering distribution and redstone modes in Pipez is essential for preventing machine bottlenecks and automating your processing lines efficiently. In this guide, you will learn how to unlock and configure Round Robin, Nearest First, Furthest First, and Random routing logic, while integrating redstone control for smart resource extraction.Intermediate7 steps
Pipez · PowerHow to Build a Lag-Free Power Grid with Pipez Energy PipesSetting up a reliable power grid is essential for any modded Minecraft base, and the Pipez mod allows you to transfer massive amounts of Forge Energy (FE) or Redstone Flux (RF) without hurting your game's tick rate. In this guide, you will learn how to connect generators to energy storage blocks and machines using Energy Pipes, configure extraction points, and install upgrades to eliminate power bottlenecks. Mastering this system ensures your automated factories run at peak efficiency while keeping server and client lag to an absolute minimum.Beginner7 steps