bItemFilter is a per-player item pickup filter for Spigot and Paper servers. Each player manages their own independent filter what one player blocks doesn't affect anyone else.
Download on Modrinth!
Discord / Support
Join the community for support and updates.
How it works
Two modes, pick your poison:
Blacklist items on the list stay on the ground. Everything else is picked up normally. Good for blocking junk like rotten flesh or gravel.
Whitelist only items on the list get picked up. Everything else is ignored. Good for hardcore grinders who only want specific drops.
Players can switch modes, toggle the filter on/off without losing their list, and manage everything from a GUI or commands. Filters are saved to SQLite and survive restarts.
GUI
Open with /ifilter. Everything is clickable:
| Slot | What it does |
|---|---|
| Rows 1-4 | Items currently in your filter. Click any to remove it. |
| Your inventory | Click any item you're holding to add or remove it from the filter no commands needed. |
| Slot 47 | Mode button switch between Blacklist and Whitelist. |
| Slot 49 | Toggle button enable or disable the filter without clearing it. |
| Slot 51 | Clear button shift-click to wipe the list. |
| Slots 45, 53 | Arrows page navigation for more than 36 entries. |
On 1.20.5+ the GUI title and button names render in Unicode small caps.
Commands
All aliases work the same: /bitemfilter, /itemfilter, /ifilter, /filter.
| Command | What it does |
|---|---|
/ifilter |
Open the GUI |
/ifilter toggle |
Enable or disable your filter |
/ifilter mode |
Switch blacklist / whitelist |
/ifilter add [material] |
Add the item in your hand, or name one |
/ifilter remove <material> |
Remove an item from the filter |
/ifilter list |
List your filtered items in chat |
/ifilter clear |
Clear the entire filter |
/ifilter help |
Show command reference |
Admin commands
Require bitemfilter.admin.
| Command | What it does |
|---|---|
/ifilter admin clear <player> |
Clear another player's filter |
/ifilter admin list <player> |
View another player's filter |
/ifilter admin toggle <player> |
Toggle another player's filter |
/ifilter reload |
Reload config from disk |
Permissions
| Permission | Default | Description |
|---|---|---|
bitemfilter.use |
everyone | Use the filter and personal commands |
bitemfilter.admin |
op | Admin commands and update notifications |
Configuration
Everything in config.yml is configurable: all messages support & color codes and a %prefix% placeholder, every GUI button's material and lore can be changed, and the help sections are editable lists. The default mode, default enabled state, and per-player item cap are set globally.
Compatibility
- Minecraft 1.8+ uses
PlayerPickupItemEventon pre-1.12,EntityPickupItemEventon 1.12+, detected automatically at startup - Spigot and Paper
- Does not conflict with other pickup or economy plugins cancels at
NORMALpriority and respects already-cancelled events
License
bItemFilter is free and open source under the GNU General Public License v3.0.
