Configurable Bannable Items
A lightweight server-side mod that lets operators ban specific items by their full item fingerprint (registry ID + NBT). Banned items are automatically…
⬇ Download on CurseForgeThe author built this one for Minecraft 1.21–1.21.1 on NeoForge. On other versions it may install and then do nothing.
Banned Items Mod
NeoForge 21.1.220 | Minecraft 1.21.1 | Server-Side Only
A lightweight server-side mod that lets operators ban specific items by their full item fingerprint (registry ID + all data-components / NBT). Banned items are automatically destroyed wherever they appear: inventory, cursor, ground, crafting table, or anvil.
Commands (requires operator level 2)
| Command | Description |
|---|---|
/banhanditem |
Ban the item currently in your main hand. Deletes the item from your hand and scans the rest of your inventory for copies. Saves to config immediately. |
/unbanhanditem |
Unban the item currently in your main hand. |
/banneditemslist |
Print all currently banned items to chat. |
/reloadbanneditems |
Reload config/banneditems.json without restarting the server. |
How banning works
- Hold an item and run
/banhanditem. - The mod serialises the full item (item ID + every data-component such as
enchantments, custom name, lore, potion effects, etc.) to SNBT and stores it
in
config/banneditems.json. - From that moment, any item stack that matches both the item type and all data-components is considered banned.
- Banning is exact-match: a Diamond Sword with Sharpness V is a different entry from a plain Diamond Sword. This lets you ban specific hacked items without affecting normal ones.
Enforcement
| Trigger | Action |
|---|---|
| Inventory sweep (every 1 s) | Removes banned items from all 41 inventory slots and the cursor slot |
| Crafting output | Zeroes the result stack so the player receives nothing |
| Right-click on block / in air | Event cancelled; item cannot be used |
| Left-click / attacking | Event cancelled |
| Item pickup from ground | Item entity discarded immediately |
| Anvil (repair / rename) | Output blocked |
Config file
config/banneditems.json — a JSON array of SNBT strings.
[
"{id:\"minecraft:diamond_sword\",count:1}",
"{id:\"minecraft:tnt\",count:1,components:{\"minecraft:custom_name\":\"{\\\"text\\\":\\\"Super TNT\\\"}\"} }"
]
You can hand-edit this file and run /reloadbanneditems to apply changes without
restarting.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on CurseForge — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as banneditemsmod-1.21.1-1.0.0.jar — drop this file into the mods folder
- Download size: 14 KB
- Download link checked 13 Sept 2026 — working
These come from our own check of the pack file, not from the source page.