← All projects

Paper utility plugin · Player pickup control

ItemFilter

Let players decide what never reaches their inventory.

Current statusVersion 1.1

What it is

Give every player personal filter profiles while keeping categories, matching rules, world scope, and filtered-item behavior under server control.

Capabilities

The useful parts.

01

Personal profiles

Players can create multiple profiles, toggle them independently, rename them, choose icons, and manage filtered entries through paginated GUIs.

02

Server-owned categories

Administrators define the categories and entries players see, with GUI and command tools for material-based or exact-item matching.

03

Four filtering modes

Prevent pickup, limit filtering to pickup events, drop matches back out of inventories, or explicitly enable destructive removal.

04

World scoping

Run ItemFilter everywhere or use configurable world blacklists and whitelists, managed through a dedicated world filter GUI.

05

Optional collection

Redirect filtered pickup items into a virtual, player-owned /collect inventory with permission-based sizes and administrator overrides.

06

Local persistence

SQLite stores profiles, categories, selections, collection contents, and overrides, while warmed caches keep routine filter checks out of the database.

Development note

Version 1.1 made filtering world-aware and category access faster.

The release added world blacklist and whitelist support, a dedicated world filter GUI, improved duplicate material handling, and startup cache warming so the first category view does not pay the initial loading cost. ItemFilter requires Paper 1.21.11 and Java 21.