Banned Items
A lightweight server-side mod that lets operators ban specific items by their full item fingerprint (registry ID + NBT). Banned items are automatically destroyed wherever they appear: inventory, cursor, ground, crafting table, or anvil.
About this Mod
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
inconfig/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.
Available Versions
How to Install Banned Items on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Banned Items". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.21
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Banned Items server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Banned Items compatible with neoforge?
Banned Items officially supports neoforge for Minecraft 1.21.1, 1.21. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Banned Items – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Banned Items consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Banned Items with just one click on your server.