ItemControl

Control how many of any item can exist on your Minecraft server.

ItemControl is an item limit and enchantment limit plugin for Paper and Spigot. Want only one Mace on the whole server? Max 3 totems per player? No Sharpness V? Set it up in a menu with a few clicks and the plugin keeps count by itself.

Works on 1.21 - 1.21.11 and 26.1 - 26.3.

---

What it does

Item limits

• Global limits - cap how many of an item exist on the whole server. Perfect for legendary weapons, rare drops and "only one exists" items.
• Player limits - cap how many one player can hold. No more hoarding.
• Custom items are tracked separately from vanilla ones (name, lore, custom model data, PDC).
• Items hidden in shulker boxes and bundles still count.
• When a limited item is destroyed (lava, cactus, despawn, void), its slot frees up again.

Enchantment limits

• Limit any enchantment, or only specific levels (like Sharpness V).
• Enchants above the limit get lowered to the highest allowed level when possible.

Usage and storage rules

• Let players keep an item but block using it (attacking, placing, eating, shooting).
• Block limited items from being stored in chests, hoppers or shulker boxes.

Advanced rules

• 5 limit types - how many exist right now, how many can ever be obtained, per time period (like daily), rolling window, or forever per player.
• 8 actions when someone goes over - block, quarantine, drop, delete, downgrade, replace, run a command, or just log it.
• Source filters - allow or block items by where they came from: crafting, trading, fishing, loot chests, mob drops, anvils, enchanting, brewing, smelting, creative and more.
• Shared pools - one limit for a group of items. Example: max 10 netherite items on the whole server, no matter which ones.
• Profiles - make rules apply only in certain worlds, biomes, WorldGuard regions, game modes, times of day, weather or Y levels, or only for players with a certain permission.
• Effect limits - cap potion effect level and duration, or block effects from sources like beacons.

Custom crafting

• Create your own 3x3 recipes with exact amounts per slot (for example 2 diamond blocks in one slot).
• Players browse them with /recipes.
• Every recipe can have its own permission.

Quarantine

Items over the limit can be stored instead of deleted. Admins can look through them and give them back to the owner with one click.

Audit and repair

/ic audit checks online players and loaded chests and tells you if any counter is off. Repair only ever raises counters, so it can never free up a slot by mistake.

Built to be safe

• Counters survive restarts and crashes. If another plugin cancels an action, the count is rolled back.
• Tracked items carry a server-signed tag, so items with faked tracking data aren't trusted.
• Automatic backups, undo for your last rule change, and a change log.
• If a data file breaks, the plugin stops and tells you which one instead of wiping your data.
• Scans slow down by themselves when TPS drops.

Works with your plugins

Supports 50+ plugins out of the box, including PlaceholderAPI, WorldGuard, LuckPerms, ItemsAdder, Oraxen, Nexo, MMOItems, MythicMobs, Slimefun, crate plugins and shop plugins. Custom items keep their identity, so a limit hits the exact item you picked. Everything is optional, no dependencies needed.

---

Getting started

1. Put the jar into your plugins folder.
2. Restart the server.
3. Run /ic menu.
4. Click an item in your inventory and set a limit. That's it.

---

Commands

• /ic menu - open the Control Center
• /ic status - quick overview
• /ic inspect - see which rules match the item in your hand
• /ic audit - check counters (/ic audit repair to fix them)
• /ic quarantine - review quarantined items
• /ic reload - reload files
• /recipes - browse custom recipes (for players)

Permissions

• itemcontrol.admin - menu and admin commands (op by default)
• itemcontrol.audit - run audits (op)
• itemcontrol.quarantine - manage quarantine (op)
• itemcontrol.recipes - use /recipes (everyone)
• itemcontrol.recipe.<tag> - access to one custom recipe
• itemcontrol.bypass.* - ignore all limits
• itemcontrol.bypass.item.<item> - ignore the limit for one item
• itemcontrol.bypass.enchant.<enchant> - ignore the limit for one enchantment

Bypass permissions only work after you turn them on in the settings menu. OPs don't bypass limits by default.

Placeholders

%itemcontrol_held_remaining% %itemcontrol_held_rules% %itemcontrol_rules% %itemcontrol_quarantine% %itemcontrol_tps%

---

FAQ

Can I make an item that only exists once on the whole server? Yes. Give it a global limit of 1. If it gets destroyed, someone else can get it again.

Does it work with ItemsAdder, Oraxen, Nexo or MMOItems items? Yes. Custom items are recognized by their real ID, not just the base material.

Can players get around limits with shulker boxes, bundles or chests? No. Items inside shulker boxes and bundles count, and you can block storing limited items completely.

Will it lag my server? It's built to stay light. Inventory scans are spread out and slow down automatically when TPS drops.

Does it work on Folia? Not right now. Paper, Spigot and Paper forks are supported.

---

Compatibility

• Minecraft: 1.21 - 1.21.11, 26.1 - 26.3
• Server: Paper, Spigot and Paper forks
• Java: 21 or newer
• Not supported: Folia, Forge/Bukkit hybrids