
Smart Filter
Take control of your inventory! Smart Filter lets you filter which items you want to pick up. Avoid inventory clutter by whitelisting ores or blacklisting junk like cobblestone with a single smart item.
About this Mod
📦 Smart Filter
"The ultimate inventory management utility for organized adventurers."

Tired of your inventory filling up with cobblestone, dirt, and seeds while you are mining or farming? Smart Filter is a lightweight, high-performance utility mod for NeoForge 1.21.1 that introduces the "Smart Filter" item, allowing you to decide exactly what enters your pockets.
✨ Features
- 🖥️ Visual Interface (GUI): Now featuring a "Simple Chest" style interface. Manage your filtered items in a clean, organized 9-slot row.
- 👻 Ghost Slots: Configure your filter without losing your items. Simply click an item into the GUI slot; the filter registers the item type without consuming the actual item.
- ⚡ High Performance: Built using the latest Minecraft 1.21 Data Components and NeoForge TriState logic. Zero lag, even in heavy modpacks.
- 🔄 Toggleable Modes: Instantly switch between Whitelist (pick up ONLY specific items) and Blacklist (pick up everything EXCEPT specific items).
- 🎒 Multi-Filter Support: Carry multiple filters in your inventory to handle different tasks (one for ores, one for wood) simultaneously.
🎮 How to Use
1. Opening the Interface & Configuring
Hold the Smart Filter in your hand and Right-Click (while standing) to open the configuration GUI.
- Add Items: Click on any of the top 9 slots with an item in your cursor. The item will appear there visually, but the stack stays in your hand!
- Remove Items: Click with an empty hand on a configured item in the GUI to remove it from the filter.
- Duplicate Prevention: The system automatically organizes your list, ensuring the same item doesn't take up multiple slots.
2. Changing Modes
To quickly swap how the filter behaves without opening the GUI:
- Hold the filter and Shift + Right-Click.
- Whitelist (Green Mode): You will ONLY pick up items listed in the filter.
- Blacklist (Red Mode): You will pick up everything EXCEPT the items listed in the filter.
3. Automatic Filtering
Once configured, simply keep the filter anywhere in your inventory. As you walk over items on the ground, the mod automatically checks your rules. If an item is forbidden by your filter, it will remain on the ground!
Tip: You can also quick-configure the filter in the world by holding Shift + Right-Click on a block to add or remove it without opening the interface!
Available Versions
How to Install Smart Filter on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "Smart Filter". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+16 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Smart Filter server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is Smart Filter compatible with forge and neoforge?
Smart Filter officially supports forge, neoforge for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Smart Filter – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Smart Filter consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install Smart Filter with just one click on your server.