🛡️ Item Manager — Forge 1.20.1
Take full control of items on your Minecraft server.
Ban, restrict, or mark items as illegal — with automatic enforcement, JEI integration, dimension support and custom messages.
📋 Description
Item Manager is a server-side moderation mod that allows administrators to control which items players can have, craft, or carry on their server. Whether you're running a survival SMP, an RPG server, or a competitive environment, Item Manager gives you the tools to enforce item rules automatically — no plugins, no command spam, no manual enforcement.
Simply add an item to a category and the mod does the rest.
⚙️ How It Works
Item Manager has 3 enforcement categories, each with a different level of restriction:
🔴 BANNED
The most severe restriction. Banned items are completely forbidden on the server.
- ✖ Automatically removed from the player's inventory every second
- ✖ Automatically removed from any chest or container when a player opens it
- ⚠ Players receive a warning message when an item is removed
- 🏷️ Red tooltip warning shown on the item
- 💬 Supports fully custom messages per item with color codes
- 🌍 Can be restricted to specific dimensions only
🟠 ILLEGAL
A softer restriction. Illegal items can exist in the inventory but cannot be actively used.
- ↩ Automatically moved out of the hotbar (slots 0–8)
- ↩ Automatically removed from the offhand slot
- ↩ Automatically unequipped from all armor slots (helmet, chestplate, leggings, boots)
- The item stays in the main inventory — it is not destroyed
- 🏷️ Orange tooltip warning shown on the item
- 💬 Supports fully custom messages per item with color codes
- 🌍 Can be restricted to specific dimensions only
🟡 RESTRICTED
The lightest restriction. Restricted items can be owned but cannot be crafted.
- ✖ Crafting recipes are blocked — the result is cancelled automatically
- ✖ Recipes are removed directly from the server on startup
- ✖ Recipes are hidden in JEI (Just Enough Items)
- 🏷️ Yellow tooltip warning shown on the item
- 💬 Supports fully custom messages per item with color codes
- 🌍 Can be restricted to specific dimensions only
🌍 Dimension Support
Every item can be restricted globally or only in specific dimensions — including modded dimensions.
# Global restriction (all dimensions)
/itemmanager add banned minecraft:tnt
# Only in the Nether
/itemmanager add banned minecraft:tnt --dim minecraft:the_nether
# Only in the End
/itemmanager add illegal minecraft:elytra --dim minecraft:the_end
# Modded dimension
/itemmanager add banned botania:mana_sword --dim botania:alfheim
💬 Custom Messages
Every item can have a fully custom tooltip message in any language, with full Minecraft color code support using &.
/itemmanager add banned minecraft:tnt|&8[&c&lBANNED&8] &c▪ &fThis item is forbidden.
/itemmanager add illegal minecraft:diamond_sword|&6No puedes usar esto aquí.
/itemmanager add restricted minecraft:elytra|&eItem restringido en este servidor.
# With dimension
/itemmanager add banned minecraft:tnt|&cNo TNT en el Nether --dim minecraft:the_nether
If no custom message is set, a default bilingual message (Spanish/English) is shown.
🔄 Live Config Sync
No server restart needed. Changes apply instantly:
- Config syncs to all players automatically after every command
- Config syncs to a player when they log in
/itemmanager reload forces a manual sync to all players
🖥️ Commands
All commands require OP level 2 or higher. All have Tab auto-complete.
| Command |
Description |
/itemmanager add <cat> <item> |
Add item to a category |
/itemmanager add <cat> <item>|<msg> |
Add item with custom message |
/itemmanager add <cat> <item> --dim <dim> |
Add item for specific dimension |
/itemmanager add <cat> <item>|<msg> --dim <dim> |
Add with message and dimension |
/itemmanager remove <cat> <item> |
Remove item from a category |
/itemmanager setmessage <cat> <item>|<msg> |
Set or update custom message |
/itemmanager clearmessage <cat> <item> |
Remove custom message |
/itemmanager list |
Show all registered items |
/itemmanager check <item> |
Check status of a specific item |
/itemmanager reload |
Reload and sync config to all players |
📖 Quick Start Guide
1. Install the mod
Place itemmanager-1.2.0.jar in your server's mods/ folder.
Works on Forge and Mohist servers.
For JEI recipe hiding and tooltips, clients also need the mod installed.
2. Start the server
Config file is created at:
world/serverconfig/itemmanager-server.toml
3. Add items
/itemmanager add banned minecraft:tnt|&cForbidden on this server
/itemmanager add illegal minecraft:diamond_helmet|&6Cannot be equipped
/itemmanager add restricted minecraft:elytra|&eNot craftable here
4. Edit manually (optional)
[items]
banned = ["minecraft:tnt", "minecraft:tnt@minecraft:the_nether"]
banned_messages = ["minecraft:tnt|&cForbidden!", "minecraft:tnt@minecraft:the_nether|&cNo TNT here"]
illegal = ["minecraft:diamond_sword"]
illegal_messages = ["minecraft:diamond_sword|&6Cannot use this"]
restricted = ["minecraft:elytra"]
restricted_messages = []
🔧 Compatibility
| Mod / Platform |
Status |
| Forge 1.20.1 |
✅ Full support |
| Mohist 1.20.1 |
✅ Full support |
| JEI 15.20.0.x |
✅ Recipe and ingredient hiding |
| REI |
🔜 Coming soon |
| EMI |
🔜 Coming soon |
| Any modded items |
✅ Full support via modid:itemname |
| Modded dimensions |
✅ Full support via modid:dimension |
❓ FAQ
Q: Do I need to restart the server after changes?
A: No — changes sync instantly to all players.
Q: Will banned items be removed from chests that are never opened?
A: No — chests are only scanned when a player opens them.
Q: What happens if inventory is full when an illegal item is moved?
A: The item drops on the ground near the player.
Q: Does this work with modded items and dimensions?
A: Yes — use modid:itemname and modid:dimension.
Q: Can I use color codes in messages?
A: Yes — use & followed by a color code (e.g. &c red, &e yellow, &6 gold).
Q: Does it work on Mohist?
A: Yes — fully tested on Mohist 1.20.1.
📦 Requirements
- Minecraft: 1.20.1
- Forge: 47.4.13+
- JEI (optional): 15.20.0.x
