Item Manager

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

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 via commands:

/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

Do I need to restart the server after changes? No — changes sync instantly to all players.

Will banned items be removed from chests that are never opened? No — chests are only scanned when a player opens them.

What happens if inventory is full when an illegal item is moved? The item drops on the ground near the player.

Does this work with modded items and dimensions? Yes — use modid:itemname and modid:dimension.

Can I use color codes in messages? Yes — use & followed by a color code (e.g. &c red, &e yellow, &6 gold).

Does it work on Mohist? Yes — fully tested on Mohist 1.20.1.

---

Requirements

• Minecraft: 1.20.1
• Forge: 47.4.13+
• JEI (optional): 15.20.0.x