PickupFilter [1.20.x - 1.21.x] ✨ Item Pickup Filters ✨ Geyser & Floodgate Support

What is PickupFilter?

PickupFilter is a lightweight item pickup filtering plugin that lets players control what items are allowed into their inventory.

Instead of constantly collecting junk while mining, farming, mob grinding, building, or clearing land, players can use a simple filter item to choose what they want to pick up and what they want to ignore.

PickupFilter is focused specifically on player item pickup filtering.

It is not a hopper sorter.
It is not a chest routing plugin.
It is not a storage room automation system.

It is made for players who want cleaner inventories while playing normally.


Main Features

• Player item pickup filtering
• Control what items enter your inventory
• Category-based pickup filters
• Simple filter item system
• Filter data saves directly onto the item
• Filters stay saved after relogging
• Filters stay saved after server restarts
• Filters still work when dropped, traded, or stored
• Helps reduce inventory clutter
• Perfect for mining, farming, mob grinding, building, and clearing land
• Configurable item categories
• Lightweight and easy to use
• Java and Bedrock friendly
• Full Bedrock support with Geyser and Floodgate


How It Works

Players use a filter item to select which item categories they want to control.

Once the filter is active, PickupFilter checks items before they enter the player’s inventory. If the item does not match the player’s filter setup, it can be blocked from being picked up.

This makes normal gameplay cleaner and stops inventories filling up with unwanted items.

Useful examples:

• Stop picking up cobblestone while mining
• Ignore rotten flesh, bones, and arrows while mob grinding
• Avoid seeds and unwanted crop drops while farming
• Keep building sessions cleaner
• Reduce junk pickups when clearing land
• Help Bedrock players manage inventory clutter more easily


Persistent Filter Items

PickupFilter stores filter data directly on the filter item itself.

That means the filter is not only saved to a temporary player session. The item remembers its selected filter data.

Filters stay saved when:

• The player leaves and rejoins
• The server restarts
• The item is dropped
• The item is picked back up
• The item is stored in a chest
• The item is traded to another player
• The item is used by a Java player
• The item is used by a Bedrock player

This makes PickupFilter reliable for long-term survival gameplay.


Full Bedrock Support

PickupFilter fully supports Bedrock players joining through Geyser and Floodgate.

The plugin is designed around simple, reliable interactions that work well for both Java and Bedrock users. Bedrock players can use the same pickup filtering system without awkward Java-only controls.

Recommended setup:

• Paper or Spigot server
• Geyser
• Floodgate
• PickupFilter

With this setup, PickupFilter works smoothly on mixed Java and Bedrock servers.


Perfect For

• Survival servers
• SMP servers
• Economy servers
• RPG servers
• Skyblock servers
• Towny-style servers
• Java and Bedrock crossplay servers
• Servers with lots of mining, farming, grinding, or building


Commands

Use the main command to access PickupFilter features.


Permissions

• filter.use - Allows players to use PickupFilter
• filter.admin - Allows access to admin features


Why Use PickupFilter?

Inventory clutter gets annoying fast.

Players often pick up stacks of blocks, seeds, bones, rotten flesh, arrows, random mob drops, and other unwanted items while doing normal tasks. PickupFilter helps solve this by giving players control over what they actually pick up.

It keeps gameplay smoother, inventories cleaner, and grinding less frustrating.

No hopper confusion.
No storage routing.
No complicated redstone setup.

Just simple, clean item pickup filtering.