# \ud83d\udeab ItemBlacklist<\/p>\n
**Permanently ban specific ItemStacks from your server \u2014 with full NBT precision.**<\/p>\n
ItemBlacklist lets you blacklist exact items (including custom names, enchantments, lore, and NBT data) and automatically purges them from player inventories in real time. No more worrying about contraband items slipping through \u2014 if it’s on the list, it’s gone.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **Hold-to-blacklist** \u2014 add any item you’re holding with a single command
\n– **NBT-aware matching** \u2014 distinguishes between items by name, lore, enchantments, and all custom data
\n– **Multi-layer removal** \u2014 items are caught on pickup, inventory interaction, hand-swap, login, and via a continuous background scan
\n– **Named entries** \u2014 every blacklisted item gets a human-readable ID you choose, making management easy
\n– **Persistent storage** \u2014 blacklist survives restarts, stored in `blacklist.yml` using full ItemStack serialization
\n– **Bypass permission** \u2014 grant trusted players or staff immunity from removal
\n– **Tab completion** \u2014 commands auto-complete entry IDs<\/p>\n
—<\/p>\n
## \ud83d\udccb Commands<\/p>\n
| Command | Description | **Alias:** `\/ibl`<\/p>\n —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## \ud83d\udee1\ufe0f How Removal Works<\/p>\n ItemBlacklist uses **five separate enforcement layers** to ensure no blacklisted item survives:<\/p>\n 1. **Pickup cancellation** \u2014 the item entity is destroyed before it ever enters an inventory —<\/p>\n ## \ud83d\ude80 Getting Started<\/p>\n 1. Drop the `.jar` into your `plugins\/` folder and restart the server To undo it: `\/ibl remove my_item_id`<\/p>\n —<\/p>\n ## \u2699\ufe0f Config & Storage<\/p>\n The blacklist is saved at `plugins\/ItemBlacklist\/blacklist.yml`. Entries are stored as Base64-encoded serialized ItemStacks, preserving all item data exactly as-is. You don’t need to edit this file manually \u2014 the commands handle everything.<\/p>\n —<\/p>\n ## \ud83d\udd27 Requirements<\/p>\n – **Paper** 1.21.4+ (or any fork \u2014 Purpur, Folia*) > *Folia compatibility is not officially tested but may work for the listener and command portions.<\/p>\n —<\/p>\n ## \ud83d\udce6 Source Code<\/p>\n Source is available on GitHub. Contributions and issue reports are welcome!<\/p>\n —<\/p>\n","protected":false},"excerpt":{"rendered":" Allows blacklisting certain items.<\/p>\n","protected":false},"featured_media":86918,"template":"","meta":{"_minecraft_slug":"itemblacklist","_minecraft_project_id":"MALioFqL","_minecraft_author":"JuusK","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":10,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemblacklist.zip","_minecraft_size_bytes":12341,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:08:04.967682Z","_minecraft_date_created":"2026-04-29T04:05:45.993647Z","_minecraft_date_modified":"2026-04-20T18:06:20.110518Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemblacklist","_minecraft_icon_attachment_id":86918,"_minecraft_imported_at":"2026-06-04T23:10:10+00:00","_minecraft_import_hash":"d78786656d33182057a0e7002b4f992f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,88,126,127,128,129,91],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-86917","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-equipment","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|
\n| `\/itemblacklist add
\n| `\/itemblacklist remove
\n| `\/itemblacklist list` | List all currently blacklisted items |<\/p>\n
\n|—|—|—|
\n| `itemblacklist.manage` | OP | Use all `\/itemblacklist` commands |
\n| `itemblacklist.bypass` | false | Items are never removed from this player |<\/p>\n
\n2. **Inventory click interception** \u2014 caught on shift-click, drag, and any cursor movement
\n3. **Hand-swap detection** \u2014 blocks F-key offhand swaps involving blacklisted items
\n4. **Login scan** \u2014 inventories are checked 5 ticks after a player joins, catching items saved to disk while offline
\n5. **Repeating background scan** \u2014 all online players are scanned every second as a safety net<\/p>\n
\n2. Hold the item you want to ban
\n3. Run `\/ibl add my_item_id`
\n4. Done \u2014 that item will now be removed from every player’s inventory automatically<\/p>\n
\n– **Java** 21+<\/p>\n