Pipez · Explained · Intermediate

How to Use Filters in Pipez: Tags, NBT Matching & Whitelists

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

What you need

  • Item Pipe, Fluid Pipe, Gas Pipe, or Universal Pipe
  • Pipe Wrench (or any compatible Forge wrench)
  • Advanced Pipe Upgrade, Ultimate Pipe Upgrade, or Infinity Pipe Upgrade (Basic and Improved tiers do not unlock filters)
  • Filter Destination Tool (optional, for routing specific items to specific inventories)
  • Sample items, fluid buckets, or gas tanks to configure your filter rules

Step by step

  1. 1Install an Advanced or Higher Upgrade

    Place your pipe between a source inventory and a destination inventory. Hold your Pipe Wrench and sneak-right-click the pipe connection attached to the source block to turn it into an extracting connection (indicated by a wide collar). Right-click that extracting collar with an east-to-craft Advanced Pipe Upgrade (or simply open the collar's GUI by right-clicking it with an empty hand and place the upgrade into the top-right upgrade slot). Once inserted, the Filter Mode button and the central filter list will unlock.

    Tip: If you are using a Universal Pipe, use the tabs on the far left of the GUI to select whether you are configuring Item, Fluid, or Gas extraction before setting up your filters.

  2. 2Choose Global Whitelist or Blacklist Mode

    At the top of the extraction GUI, look for the global Filter Mode button (located alongside the Redstone and Distribution mode buttons). Toggle it between Whitelist (only pull items matching your filter list) and Blacklist (pull everything except items matching your filter list). By default, adding your first filter usually pushes you toward a whitelist workflow, so ensure this global button matches your overall sorting intent.

    Tip: combine Nearest First distribution mode with a Whitelist to create classic overflow-proof storage sorting systems.

  3. 3Add a Direct Item, Fluid, or Gas Filter

    Click the 'Add' button in the GUI to open the filter creation screen. Take the sample item from your inventory (or drag it directly from JEI) and click it into the ghost slot on the left. For Fluid Pipes or Gas Pipes, click the ghost slot with a filled bucket, fluid tank, or Mekanism gas gauge—alternatively, you can manually type the registry ID (such as minecraft:water) into the upper text field. Click 'Submit' to save the rule to your active list.

    Tip: You do not need to carry the physical item if you know its registry ID or drag it straight from your JEI sidebar into the filter slot.

  4. 4Configure Tag Filtering for Broad Categories

    Instead of creating twenty separate filters for every type of ore or ingot, open a new filter and leave the item slot empty. In the top text box, type a hashtag followed by a valid Forge or Minecraft tag, such as #forge:ores, #forge:ingots, or #minecraft:logs. As you type or hover over items in your inventory with advanced tooltips enabled (F3+H), you can find exact tag names in JEI. Click 'Submit' to make the pipe extract any item belonging to that tag family.

    Tip: Tag filtering also works for fluids and gases if the modpack assigns tags to them, such as #forge:crude_oil.

  5. 5Adjust the Three NBT Matching Modes

    When you insert an item with durability, enchantments, or stored energy into the filter slot, its raw NBT data string automatically populates the lower text box. Next to this box is the NBT button, which cycles through three modes. Set it to 'Match Exact' if the item must have the exact same NBT string in the box. Set it to 'Match Existing' if you delete parts of the string and only want the pipe to check for the specific tags you left behind (e.g., matching any sword with Sharpness V regardless of its durability). Delete the NBT text completely or toggle the mode to ignore NBT when you want to filter all damaged weapons or tools of that type together.

    Tip: To filter strictly for items that have NO NBT data (like unenchanted, undamaged tools), clear the NBT text box and set the NBT button to exact/none matching so tagged items are rejected.

  6. 6Invert Individual Filters for Exceptions

    Sometimes you want to extract an entire tag category except for one specific item—for example, pulling all #forge:ores except raw iron. First, keep your pipe in global Whitelist mode and add a filter for #forge:ores. Next, click 'Add' to create a second filter, insert the specific item you want to exclude, and click the button with the paper icon to 'Invert' that single rule before clicking 'Submit'. This turns that individual entry into an exception against your global setting.

    Tip: An inverted filter applies to the exact opposite of the item and NBT data you configured, though it still respects the assigned destination if one is set.

  7. 7Bind Filters to Specific Destinations

    To make a single extracting pipe route different items to different chests on the same line, hold the Filter Destination Tool in your hand. Right-click the exact face of the destination block where the receiving pipe connects (clicking an unconnected side of the chest will not work). Open the extracting pipe's GUI, edit or add a filter, and place the configured Filter Destination Tool into the destination slot on the right side of the filter screen. Click 'Submit', and you will see the target block's icon appear next to that filter rule.

    Tip: If you want a fallback chest for unsorted items, set the pipe's Distribution Mode to Nearest First, place destination-bound filters for your machines, and leave an unrestricted chest at the very end of the line.

  8. 8Backup and Duplicate Filter Configurations

    Every filter list, distribution mode, and redstone rule you configure is saved directly inside the Pipe Upgrade item itself, not the pipe block. If you need to apply the exact same complex NBT and tag filter setup to ten other extraction points, simply pull the configured Advanced Pipe Upgrade out of the pipe. Place it in a crafting grid alongside a blank Pipe Upgrade of any Advanced or higher tier to clone all filter data instantly.

    Tip: Keep a master upgrade in a labeled chest or backpack if you build standardized machine setups so you never have to re-type complex NBT strings.

How it works

Understanding Pipez's architecture makes troubleshooting filters much easier: only the extracting end of a pipe is a ticking Block Entity. The connecting pipe segments and the inserting ends are completely passive blocks that store no data and perform no logic. Because of this lag-friendly design, all filtering happens at the point of extraction before an item, fluid, or gas ever leaves the source inventory. You cannot place a filter on the receiving end of a pipe; instead, the extracting collar scans all valid destinations on the network and uses the Filter Destination Tool data to decide where each extracted packet is allowed to go.

When the extracting pipe evaluates an item in a chest, it checks the global Filter Mode (Whitelist vs. Blacklist) alongside your list of individual rules. Tag strings (prefixed with #) are checked against the item's registered dictionary tags, while NBT strings parse the item's internal data compound. Because all of this data is serialized directly onto the Advanced, Ultimate, or Infinity Upgrade item's own NBT tag, breaking the pipe or removing the upgrade never deletes your work—the upgrade acts as a portable memory card for that extraction point.

Common mistakes

  • Trying to filter with Basic or Improved Upgrades: Players often craft a Basic or Improved Pipe Upgrade and wonder why the filter GUI is missing or locked. Basic only unlocks Redstone control, and Improved only unlocks Distribution modes; you must use at least an Advanced Pipe Upgrade to see and use filters.
  • Clicking the wrong block face with the Filter Destination Tool: When binding a destination chest, right-clicking the front of the chest while the pipe connects to the back will cause the filter to fail completely. You must click the exact block face that the pipe physically attaches to.
  • Forgetting the hashtag (#) when typing tags: Typing 'forge:ores' into the ID box makes the pipe look for a literal item named forge:ores, which does not exist. Always prefix tag filters with a hashtag, like '#forge:ores'.
  • Accidental strict NBT lockouts on damaged tools: Dropping a slightly used pickaxe into the filter slot automatically copies its exact Damage NBT value into the text box. If you do not clear the NBT text box or adjust the NBT matching button, the pipe will refuse to extract pickaxes with any other durability level.

FAQ

Why isn't my filtered pipe extracting anything at all?

First, ensure you sneak-right-clicked the pipe collar at the source inventory with a wrench so it is actually set to extract. Second, check your Redstone Mode (set it to Ignore if you aren't using redstone) and verify that your destination inventory isn't full or registered on the wrong block face via the Filter Destination Tool.

Can I filter fluids, items, and gases at the same time in one block space?

Yes. Use a Universal Pipe and insert an Advanced (or higher) Upgrade. On the left side of the pipe's GUI, you will see separate tabs for Items, Fluids, Energy, and Gases. Each tab maintains its own independent whitelist/blacklist and filter entries while sharing that single upgrade tier.

How do I filter out items that have ANY enchantment or damage while keeping clean ones?

Place the base unenchanted, undamaged item into the filter slot so the NBT text box remains completely blank. Then, make sure the NBT matching mode is set to match exact NBT (which, when the box is empty, means 'match no NBT'). Any item carrying extra data tags will be ignored.

If I upgrade from an Advanced Upgrade to an Ultimate Upgrade, do I lose my filters?

You don't have to rebuild them! Before putting the new Ultimate Pipe Upgrade into the pipe, place your existing configured Advanced Pipe Upgrade and the blank Ultimate Pipe Upgrade together in any crafting grid to copy all your filters over.

By combining Advanced Pipe Upgrades with tag syntax, selective NBT matching, and the Filter Destination Tool, you can route items, fluids, and gases across massive bases from a single lag-free extraction point.

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 · ExplainedFilter Destination Tool Explained: Precise Routing in PipezIn 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.Intermediate7 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