Minecraft Hopper filter
The hopper filter allows you to specify which items are allowed to pass through based on name patterns, tags, and item properties. Renaming a hopper applies the filter.
Creating a hopper filter
To initiate a hopper rename, sneak and left click a hopper. There are two possible results of this:
- You are holding an item: the hopper will add the item names to a list until you stop sneaking, the hopper will only allow these items to pass through.
- You are not holding an item: the next message you send in chat will become the hopper's filter. This allows you to write a string longer than the standard anvil character limit of 50. If you write "null", the name will be removed.
Examples
Names of items below are based off their translation key, shown when pressing F3 + H and hovering over an item in game.
| Pattern | Description |
|---|---|
| oak_log | Only items named oak_log will be able to pass |
| ^oak | Only items starting with oak will be able to pass |
| $log | Only items ending with log will be able to pass |
| *wood | Any items with wood in its name will be able to pass |
| =awkward_potion | Any item named "awkward_potion", "awkward potion", "awkward potion" will be able to pass, checks for renames |
| *wood,stone | Any item with wood in its name or an item named just stone will be able to pass |
| #villager_plantable_seeds | Any item with the tag #villager_plantable_seeds will be able to pass |
| #animals_spawnable_on&*a | Any block with the tag #animals_spawnable_on AND that has the letter a in its name will be able to pass |
| *oak&!*wood | Any item with oak in its name and that does NOT also have wood in its name will be able to pass |
| splash_potion&~strength_2 | Any splash potion with strength 2 will be able to pass |
| enchanted_book&+mending | Any item that is both an enchanted book and that has mending will be able to pass |
| +mending&+protection_4&+unbreaking_3 | Only items with the mending, protection 4 and unbreaking 3 enchantments will be able to pass |
| netherite_pickaxe&+efficiency_5&+unbreaking_3&+ mending&+fortune_3|+silk_touch | God pickaxes with fortune 3 OR silk touch will be able to pass |
Sneak and punch a hopper 3 times with no item in your hand to copy the applied filter.
Quirks to be aware of
Item movement when two hoppers are connected to the same source hopper
If a hopper pulling an item doesn't have a filter, the server checks if there's another hopper connected to the original source hopper that does have a filter. If there is, and that hopper's filter matches the item being moved, the server cancels the original movement to the filterless hopper. Instead, the item will go into the hopper with a filter active.
OR operator
The OR operator | only works within an AND block, i.e. +unbreaking_3&+fortune_3|+efficiency_5&+silk_touch won't work as expected, +unbreaking_3&+fortune_3,+efficiency_5&+silk_touch will work.
Hopper jamming
It is important to ensure your hoppers don't get jammed by an item in the first position of a hopper. You should always have a standard hopper for unwanted items to exit through to prevent items jamming your setup that can't pass a filter.⏎