✨ What is LootFilter?

LootFilter is a lightweight and powerful plugin designed to give players control over which items they pick up in Minecraft. Whether you're mining, farming, or playing on a survival server, LootFilter lets you filter out unwanted items with ease. With features like blacklist/whitelist modes, global admin filters, a user-friendly GUI, and even temporary filters, this plugin is perfect for enhancing gameplay on any server!

Built for Paper 1.21, LootFilter is easy to use, highly customizable, and packed with features to make your server experience smoother.

Key Features

• Filter Items Easily: Add items to your personal filter to stop picking them up.
• Blacklist & Whitelist Modes: Choose whether to block specific items (blacklist) or only pick up specific items (whitelist).
• Global Filters (Admin): Admins can set server-wide filters that apply to all players.
• User-Friendly GUI: Manage your filters through an intuitive inventory GUI.
• Temporary Filters: Add filters that expire after a set time (e.g., 10 seconds).
• Filter Sharing: Share your filter with other players (with confirmation).
• Visual Feedback: Items you can’t pick up show smoke particles for easy identification.
• Permission Support: Control who can use specific features with permissions.
• Persistent Filters: Filters are saved between server restarts.
• Alias Support: Use simple names like "cobble" instead of "cobblestone".

Commands

• /lootfilter add <item> [seconds] - Add an item to your filter (optional duration for temporary filters).
• /lootfilter remove <item> - Remove an item from your filter.
• /lootfilter list - Open the GUI to manage your filters.
• /lootfilter clear - Clear your personal filter.
• /lootfilter target - Add the block you're looking at to your filter.
• /lootfilter held - Add the item you're holding to your filter.
• /lootfilter toggle - Enable or disable your filter temporarily.
• /lootfilter mode <blacklist|whitelist> - Switch between blacklist and whitelist modes.
• /lootfilter share <player> - Share your filter with another player (they must accept).
• /lootfilter accept - Accept a filter share request.
• /lootfilter decline - Decline a filter share request.
• /lootfilter global <add|remove> <item> - (Admin) Manage the global filter for all players.

Permissions

• lootfilter.use - Allows basic use of the plugin (default: true).
• lootfilter.target - Allows using /lootfilter target (default: true).
• lootfilter.max10 - Limits the filter to 10 items max (default: true).
• lootfilter.admin - Allows managing global filters and removing global filters from the GUI (default: op).

️ Screenshots


Notes

• This plugin requires Paper 1.21 to work. It may work on other versions, but they are not officially supported.
• Filters are saved in plugins/LootFilter/filters.yml. Be careful when editing this file manually.
• Have a suggestion or found a bug? Let me know in the Discussion tab!

Support

If you have any questions, issues, or suggestions, feel free to leave a comment in the Discussion tab or send me a private message. I’m happy to help!

Feedback

If you like LootFilter, please leave a 5-star review! It helps a lot and motivates me to keep improving the plugin.