📋 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