📋 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
🟠 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
🟡 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) — players cannot see how to craft them
- 🏷️ Yellow tooltip warning shown on the item
- 💬 Supports fully custom messages per item
💬 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.
If no custom message is set, a default bilingual message (Spanish/English) is shown.
🖥️ Commands
All commands require OP level 2 or higher.
| Command |
Description |
/itemmanager add <category> <item> |
Add an item to a category |
/itemmanager add <category> <item>|<message> |
Add an item with a custom message |
/itemmanager remove <category> <item> |
Remove an item from a category |
/itemmanager setmessage <category> <item> <message> |
Set or update a custom message |
/itemmanager clearmessage <category> <item> |
Remove custom message (reverts to default) |
/itemmanager list |
Show all items in all categories |
/itemmanager check <item> |
Check the status of a specific item |
💡 All commands have auto-complete — press Tab to see suggestions for categories and item names.
📖 Quick Start Guide
1. Install the mod
Place itemmanager-1.0.0.jar in your server's mods/ folder.
The mod works on Forge and Mohist servers.
For JEI recipe hiding, clients also need the mod installed.
2. Start the server
On first launch, the mod creates its config file at:
config/itemmanager-server.toml
3. Add items via commands
Join the server as an OP and use the commands:
/itemmanager add banned minecraft:tnt
/itemmanager add illegal minecraft:diamond_helmet
/itemmanager add restricted minecraft:elytra
4. Add custom messages (optional)
/itemmanager add banned minecraft:tnt|&c✖ Forbidden on this server.
/itemmanager setmessage illegal minecraft:diamond_helmet|&6Cannot be equipped here.
5. Verify
Use /itemmanager list to see all active restrictions, or hover over an item to see its tooltip warning.
6. Edit manually (optional)
You can also edit config/itemmanager-server.toml directly:
toml
[items]
banned = ["minecraft:tnt", "minecraft:bedrock"]
banned_messages = ["minecraft:tnt|&c✖ Forbidden on this server."]
illegal = ["minecraft:diamond_sword"]
illegal_messages = []
restricted = ["minecraft:elytra"]
restricted_messages = ["minecraft:elytra|&eNot craftable here."]
🔧 Compatibility
| Mod / Platform |
Status |
| Forge 1.20.1 |
✅ Full support |
| Mohist 1.20.1 |
✅ Full support |
| JEI (Just Enough Items) |
✅ Full integration — restricted recipes are hidden |
| REI (Roughly Enough Items) |
🔜 Coming soon |
| EMI |
🔜 Coming soon |
| Any item mod |
✅ Works with any mod's items using modid:itemname format |
| Client-side |
✅ Tooltips visible when installed on client |
❓ FAQ
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 a player's inventory is full when an illegal item is moved?
A: The item is dropped on the ground near the player instead of being lost.
Q: Does this work with modded items?
A: Yes — use the full item ID: modid:itemname (e.g. botania:mana_sword).
Q: Are changes saved automatically when using commands?
A: Yes — changes made via commands are saved to the config file immediately.
Q: Does it work on Mohist (Forge + Bukkit hybrid)?
A: Yes — fully tested and working on Mohist 1.20.1.
Q: Can I use color codes in custom messages?
A: Yes — use & followed by a color code (e.g. &c for red, &e for yellow).
📦 Requirements
- Minecraft: 1.20.1
- Forge: 47.4.13+
- JEI (optional but recommended): 15.20.0.x for Forge 1.20.1
