ItemBan - Detailed Mod Description

ItemBan is a lightweight yet powerful server-side only Forge mod that gives server administrators complete control over which items are allowed in the game world.

With ItemBan, you can blacklist any item from any mod. Once blacklisted, the item’s recipes are removed, and any existing instances of the item are automatically and instantly deleted from player inventories, containers, and the world. The mod is designed to be extremely compatible with popular storage and automation mods while maintaining excellent performance even on large public servers.

Key Features

Recipe Removal
All crafting, smelting, stonecutting, and other recipes involving blacklisted items are stripped during world load.

Real-time Item Deletion
Blacklisted items are automatically removed from:

Player main inventory, hotbar, and offhand
All standard containers (chests, barrels, shulker boxes, etc.)
Applied Energistics 2 (AE2) terminals and networks
Create mod depots, vaults, crafters, belts, and funnels
Sophisticated Backpacks (worn or placed)
Storage Drawers and most other storage mods
Item entities when dropped on the ground

Extensive Mod Compatibility
Works seamlessly with AE2, Create, Sophisticated Backpacks, Storage Drawers, and virtually any mod that uses Minecraft’s standard container system. Fluid containers (such as Create tanks and pipes) are safely excluded from scanning.

Permission System
Players in Creative mode or with OP level 2 or higher are completely exempt from item removal, allowing staff to freely use blacklisted items when needed.

Simple Command Management
Manage the blacklist live without restarting the server:

/itemban add <item_id> — Add an item to the blacklist
/itemban add <item_id>{nbt} — Add a rule with specific NBT data (e.g. /itemban add minecraft:diamond_sword{Enchantments:[{id:"minecraft:sharpness",lvl:5}]})
/itemban remove <item_id> — Remove an item from the blacklist (removes all rules for the item)
/itemban remove <item_id>{nbt} — Precisely remove a rule with specific NBT
/itemban list — View the current blacklist (shows NBT rules clearly)
/itemban reload — Reload the blacklist from disk

Flexible Configuration
The blacklist is stored in a clean, human-readable JSON file located at config/ItemBan/blacklist.json. Supports both simple item IDs and advanced NBT rules using nbtString.

Example:

[

"minecraft:diamond_sword",

{

"id": "minecraft:diamond_sword",

"nbtString": "{Enchantments:[{id:\"minecraft:sharpness\",lvl:5}]}"

}

]

Supports any item ID in modid:item format and full SNBT syntax for arbitrary NBT structures.

Audit Logging
Daily log files are automatically generated in logs/ItemBan/, recording every time a blacklisted item is removed or a player attempts to obtain one.

Performance Optimized
Inventory and container scanning is throttled (every 10 ticks) to minimize CPU usage, making the mod safe for large, heavily modded public servers.

Use Cases

Prevent players from obtaining overpowered, griefing, or economy-breaking items
Disable specific Create contraptions or AE2 components on your server
Create custom progression systems by locking certain items behind permissions
Maintain a controlled server economy by banning high-value or dupable items
Enforce roleplay or challenge rules by removing unwanted items

Technical Details

Purely Server-Side — Clients do not need to install the mod
No Client Requirements — Works with vanilla clients and any modded client
Lightweight — Minimal performance impact even with hundreds of players

Commands & Permissions

All commands require permission level 2 (OP).
Creative mode players are automatically exempt from item deletion.

Version: 1.0.1
License: Apache License 2.0
Author: lnsanes

itemban