Hopper Frame
by Tentacola
With Hopper Frame, a hopper can be filtered by placing an item frame on it, so the frame's item decides what the hopper moves.
What it does
An item frame attached to a hopper turns it into a filter. When the hopper tries to push items out, it only sends the item that is shown in the frame, and when the frame is empty it pushes anything. The filter sits in a block that already fits storage builds, so no separate filter setup is needed.
Hopper Frame also adds push and pull priority. A filtered hopper avoids pulling back the items it has just pushed, and it pulls unfiltered items from a hopper above it. This gives control over item flow through vertical chains of hoppers, so storage systems can fill from the top and bottom. Fabric API is required to run the mod.
The mod is server-side only, so players join without installing it and only the server needs it. It is released under the CC0 1.0 Universal license, which places the code in the public domain, and the source code and issue tracker are public. Files target 1.18.2 – 1.21 with 1.0 for 1.20.5 as the latest.
Key features
Item frame filters
Placing an item frame on a hopper sets the item it pushes, with the frame left empty to push anything.
Push and pull priority
Filtered hoppers avoid pulling back items they just pushed, and pulling is limited to items the next hopper cannot pass on.
Vertical item flow
Control of item movement through columns of hoppers lets storage fill from the top or bottom.
Decorative placement
Item frames double as decoration, so filters blend into builds that already use frames and pots.
Gallery
Compatibility
Latest build for each game version and loader.
1.21.x1 of 1 version with builds
1.20.x7 of 7 versions with builds
1.19.x1 of 1 version with builds
1.18.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Sorting storage
Hoppers feeding chests can each carry a frame set to one item type, so a sorter needs no extra redstone.
Vertical storage columns
Stacked hoppers with priority settings let a column fill evenly from the top and bottom.
Who it’s for: Players who build item sorters and storage systems on Fabric servers, and server owners who want filtered hoppers without redstone filter setups.
How it compares
Redstone Hopper is a Fabric mod for 26.1.2 that runs on client and server and is released under the MIT License, and it is not open source. Filtered Hopper is open source under the MIT License and requires the server, with clients optional, for 26.2. Hopper Frame differs from both by filtering through item frames on the hopper itself and by covering only 1.18.2 – 1.21.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Hopper Frame | Fabric | 1.18.2 – 1.21 | Server-side only | 2024-07-16 |
| Redstone Hopper | Fabric | 26.1.2 | Client and server | 2026-07-31 |
| Filtered Hopper | Fabric | 26.2 | Server required, client optional | 2026-07-13 |
Questions
Does Hopper Frame need Fabric API?
Does Hopper Frame have to be installed on the client?
How does a filter get set on a hopper?
In the catalog
Hopper Frame is one of 4,058 Storage mods on ModsFinder, and one of 2,474 Storage mods for Fabric. 15,770 mods support Minecraft 1.21.
Similar mods
What the author says
A vanilla friendly mod to help filter items. When attaching an item frame two things change: - Filter: Whenever the hopper tries to push an item, it will only push what is in the item frame(s) (if empty it can push anything) - Push priority: Whenever a hopper tries to pull from a filtered hopper it will avoid items…
Official listing
- Modrinth page
- modrinth.com/mod/hopper-frame
- Owner
- Tentacola
- Published
- 2024-07-14
- Updated on Modrinth
- 2024-07-16
- Facts verified
- 2026-10-15