ItemControl

ItemControl gives server owners precise control over how many items and enchantments can exist on their server.

You can create server-wide rarity limits, restrict how many items individual players may carry, manage enchantments by level, and configure everything through an in-game GUI. ItemControl continuously tracks limited items as they are obtained, moved, used, stored, or destroyed, keeping the configured limits accurate without requiring manual updates.

Whether you want a single legendary weapon on the entire server or simply prevent players from stockpiling valuable resources, ItemControl provides the tools to build a balanced and controlled economy.

Features

Global Item Limits

Set the maximum number of a specific item that may exist across the entire server.

• Prevent additional items from being obtained once the global limit is reached.
• Track limited items through crafting, trading, fishing, enchanting, smelting, brewing, containers, projectiles, dropped items, and other gameplay interactions.
• Automatically decrease the global count when a limited item is destroyed, burned, despawned, consumed, or lost.
• Display the current amount, maximum limit, and usage percentage in the administration GUI.
• Optionally broadcast when a global item is obtained or destroyed.

Global limits are useful for creating genuinely rare resources, exclusive weapons, collectible items, or server-wide progression goals.

Player Item Limits

Control how many copies of an item each player may carry.

• Prevent players from picking up or creating more items than their personal limit allows.
• Apply limits to both regular materials and exact custom items.
• Monitor player inventories for items inserted through commands, trades, rewards, or other plugins.
• Remove excess items from the inventory and safely drop them near the player.
• Prevent a single player from monopolizing limited resources.

Inventory scanning can be enabled or disabled from the plugin settings menu.

Custom Item Support

ItemControl can distinguish custom items from their regular material.

Custom names, lore, enchantments, potion data, attributes, custom model data, Persistent Data Container values, and other relevant metadata can be used to identify an exact item. Normal durability changes, repair costs, bundle contents, and shulker box contents do not incorrectly create a new identity.

An exact custom item can also be configured to ignore the general limit of its base material.

Enchantment Limits

Create limits for individual enchantments and specific enchantment levels.

• Configure player and global enchantment limits independently.
• Limit only selected levels, such as Sharpness V, while leaving lower levels unrestricted.
• Control enchantments applied through enchanting tables, anvils, enchanted books, loot, and other supported acquisition methods.
• Automatically reduce an enchantment to the highest level the player is allowed to receive when possible.
• Track global enchantment counts as enchanted items are obtained or destroyed.

This makes it possible to control powerful enchantments without disabling them completely.

Item Usage and Storage Rules

Limited items can have additional restrictions beyond their amount.

• Prevent an item from being used while still allowing players to keep it.
• Block attacking, placing, consuming, shooting, or otherwise using selected items.
• Prevent global items from being stored in chests, hoppers, shulker boxes, and other containers.
• Configure these rules separately for each limited item.

Nested Container Protection

ItemControl understands items stored inside supported portable containers.

• Limited items inside shulker boxes and bundles are included in limit calculations.
• Moving a container cannot be used to bypass player or global limits.
• Nested contents are checked during inventory transfers, crafting, placement, pickup, and other relevant actions.

Complete In-Game GUI

The entire plugin can be managed without manually editing limit files.

• Create player or global item limits by clicking an item from your inventory.
• Add enchantment limits using enchanted books.
• Change limits through a simple chat input.
• View current global counts and limit usage.
• Configure item usage and storage restrictions.
• Remove existing limits.
• Toggle broadcasts, console logging, permission bypasses, and inventory scanning.
• Manage exact custom items visually.

Persistent and Transaction-Safe Tracking

ItemControl stores limits and global counters between server restarts.

Item acquisitions are handled transactionally. If another plugin cancels an interaction later in the event chain, ItemControl rolls back the reserved amount instead of leaving an incorrect global count. Existing item identities are also migrated automatically when upgrading from an older ItemControl version.

---

How It Works

ItemControl uses two independent types of limits:

1. Player Limits determine how many copies of an item or enchantment one player may carry.
2. Global Limits determine how many copies may exist across the entire server.

When both limits apply, the player must satisfy both of them. Reaching either limit prevents the additional item from being obtained.

For example, if the global limit still allows one more item but the player has already reached their personal limit, that player cannot obtain it. Another eligible player still can.

---

Commands

• /itemcontrol menu — Opens the administration GUI.
• /itemcontrol reload — Reloads configuration, limits, and stored data.
• /itemcontrol help — Displays the available commands.
• /ic — Short alias for /itemcontrol.

Running /itemcontrol without a subcommand also displays the help menu.

---

Permissions

• itemcontrol.admin — Grants access to ItemControl commands and the administration GUI.
• itemcontrol.bypass.* — Bypasses all item and enchantment limits.
• itemcontrol.bypass.item.<material> — Bypasses limits for a specific material.
• itemcontrol.bypass.enchant.<enchantment> — Bypasses limits for a specific enchantment.

Examples:

• itemcontrol.bypass.item.diamond
• itemcontrol.bypass.item.enchanted_golden_apple
• itemcontrol.bypass.enchant.sharpness

Permission bypasses must first be enabled in the ItemControl settings menu. Operators receive itemcontrol.admin by default, but do not automatically bypass configured limits.

---

Configuration

Most settings can be managed directly from the in-game GUI.

Available settings include:

• Broadcasts — Announces when global items or enchantments are obtained or lost.
• Console Logs — Logs important ItemControl activity to the server console.
• Permission Bypasses — Enables or disables bypass permission nodes.
• Inventory Checks — Scans player inventories and resolves limit violations.

The plugin files also allow you to customize the message prefix, notifications, warnings, broadcasts, and other player-facing messages.

---

Installation

1. Download ItemControl-1.2.0.jar.
2. Place the file inside your server’s plugins folder.
3. Restart the server.
4. Run /itemcontrol menu.
5. Create your first player or global limit.

No additional dependencies are required.

---

Compatibility

• Minecraft: 1.21–1.21.11
• Minecraft: 26.1–26.1.2
• Minecraft 26.2: Tested on the current Paper beta
• Server software: Paper, Spigot, and compatible Paper-based forks
• Java: Java 21 or newer

Folia and hybrid Forge/Bukkit server implementations are not officially supported.