Pickup Filter 1.1.3
An extensive item filter pickup solution featuring customisable profiles and GUIs.
🧹 PickupFilter
PickupFilter is an extensive item filter pickup solution featuring customisable profiles and GUIs.
Profiles?
-
Users can create profiles, which are separate filters that allow different items to be filtered for different contexts.
-
Each profile is unique, having their own filtered items, and own filter state (whitelist/blacklist).
-
Perfect for use in servers with varied activities, such as jobs.
Key Features
-
Item Filtering: Players can filter exactly which items they do or do not want to pick up. No more inventory clutter!
-
Profile Based: Players can create, manage, and switch between profiles on the fly using commands or the GUI. Perfect for varied activities like jobs.
-
Integrations: Integrations into plugins like EcoEnchants and WorldGuard are present, allowing enchants like telekinesis (auto item-pickup) to function with the item filter, and letting admins set up no-filter zone regions for item crates or pinata parties to ensure no items are lost. The plugin is also designed to work with entity stacker plugins like RoseStacker.
-
Modern GUIs: Players can easily edit profiles and filters through intuitive GUIs featuring drag and drop functionality, shift click functionality, easy to edit filters, quick toggles for blacklist/whitelist and to toggle the filter on/off. No need for players to memorise long commands.
-
Customisable: All GUIs can be customised to re-arrange items, hide or show buttons, change item names, lore, materials, there's even server resourcepack support with custom model data! View the config file here to see what kind of things you have control over!
-
Smart Defaults: When players have no active profile, the plugin will default back to vanilla pickup behaviour.
-
Quick Commands: There are a series of quick commands for players to edit their active profile. Players can also add or remove any vanilla items from their filters using the commands, no need to have the item in their inventory!
-
Custom Items: Support for items with custom NBT is present, they can be added to profiles and only exact matches will be filtered.
-
Performant & Lightweight
-
Persistent Data Storage using JSON files for each user. These can be deleted via admin commands!
⚙️ Integrations
Required Dependencies
WorldGuard
WorldGuard is a required dependency. The flag for WorldGuard regions is pickup-filter, and by default it is allowed everywhere.
To entirely disable the item filter in regions, set the flag to deny.
It may be useful to completely disable the item filter in regions such as crates, pinata parties, drop parties, etc to prevent any unwanted behaviour.
Other Support
EcoEnchants
Support has been added to allow enchants like telekinesis (auto item-pickup) to take the item filter into account.
RoseStacker
RoseStacker support exists to ensure filtered items are stacked appropriately when dropped on the ground.
⌨️ Commands & Permissions
Command Aliases:
/itemfilter
/if
/pickupfilter
/pf
Main Commands
Command: /itemfilter info
Description: Shows general info about the plugin.
Permission: No permission
Command: /itemfilter toggle
Description: Toggles the entire item filter on and off for the user.
Permission: pickupfilter.toggle
Command: /itemfilter
Description: Opens a GUI for viewing all profiles, which can be clicked to edit them.
Permission: pickupfilter.profiles
Profile Management
Command: /itemfilter profile create <name>
Description: Creates a new pickup profile. (max number of profiles up to config settings.maxAllowedProfiles)
Permission: pickupfilter.profile.create, pickupfilter.profile.create.max.<i>
Command: /itemfilter profile delete <profile> [confirmation]
Description: Deletes a pickup profile. (Requires "confirm" if it's the active one.)
Permission: pickupfilter.profile.delete
Command: /itemfilter profile use <profile>
Description: Activates the given profile.
Permission: pickupfilter.profile.use
Command: /itemfilter profile rename <profile> <name>
Description: Renames a profile.
Permission: pickupfilter.profile.rename
Command: /itemfilter profile mode <profile> <mode>
Description: Sets the mode of the profile to whitelist or blacklist.
Permission: pickupfilter.profile.mode
Quick Active Profile Management
Command: /itemfilter add [item]
Description: Adds the held item (or specified item) to the active profile.
Permission: pickupfilter.add
Command: /itemfilter remove [item]
Description: Removes the held item (or specified item) from the active profile.
Permission: pickupfilter.remove
Command: /itemfilter edit
Description: Opens a GUI for modifying the active profile.
Permission: pickupfilter.edit
Command: /itemfilter mode <mode>
Description: Sets the current profile to whitelist or blacklist mode.
Permission: pickupfilter.mode
Admin Commands
Command: /itemfilter admin reload
Description: Reloads the plugin config.
Permission: pickupfilter.admin.reload
Command: /itemfilter admin delete <player>
Description: Deletes all saved pickup & profile data for an offline player. (player & console runnable)
Permission: pickupfilter.admin.delete
📜 Config
View the default config here.
❓ Support
Have any questions? Join the support Discord below and create a support ticket:
