?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
ItemControl

ItemControl

Advanced server management tool that enforces strict global and player-specific limits on items and enchantments via a sleek GUI.

72
0
72
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Creators

Details

Licensed ARR
Published 5 months ago

ItemControl

ItemControl is a comprehensive administrative tool designed for Minecraft servers that require strict economy balancing and item rarity management. This plugin allows server operators to define hard limits on the quantity of specific items and enchantments that can exist, either globally across the server or individually within a player's inventory.

Unlike basic limiters, ItemControl offers a complete in-game GUI for management, active inventory scanning, and persistent tracking of limited items to ensure distinct rarity levels are maintained.

Features

Global Server Limits

Establish a definitive maximum count for specific items or enchantments on the entire server.

  • Circulation Control: When the global limit for an item is reached, players cannot craft, fish, enchant, or find more of that item.
  • Dynamic Tracking: The plugin tracks when limited items are destroyed (burned, despawned, voided) and automatically lowers the count, allowing new instances to be found or created.

Player Inventory Limits

Restrict the number of specific items a single player can carry.

  • Pickup Prevention: Players cannot pick up items if they exceed their defined limit.
  • Active Inventory Scanning: A configurable background task monitors player inventories every second. If a player exceeds a limit (e.g., via trading or admin commands), the excess items are immediately removed from their inventory and dropped on the ground.
  • Strict Enforcement: Limits apply to all acquisition methods, including crafting, anvil repairs, grindstone usage, and trading.

Precision Enchantment Control

Manage enchantments with level-specific granularity.

  • Level Gating: You can allow standard levels of an enchantment (e.g., Sharpness I-IV) freely, but set a global limit on higher levels (e.g., Sharpness V).
  • Downgrading: If a player attempts to enchant an item with a level that exceeds their personal limit, the plugin can automatically downgrade the enchantment to the maximum allowed level.

In-Game Management GUI

Configuration files are optional. The plugin features a robust GUI to manage all aspects of the system.

  • Visual Editor: View current counts, max limits, and status percentages visually.
  • Easy Addition: Click items in your inventory within the GUI to instantly create a new limit.
  • Settings Toggle: Enable or disable broadcasts, logs, inventory checks, and bypass systems directly from the menu.

How It Works

The plugin operates on two distinct scopes:

  1. Player Scope: This checks the local inventory of a user. It ensures that no single player creates a monopoly on resources like Diamond Blocks or God Apples. If the "Inventory Check" setting is enabled, the server actively scans inventories to enforce this rule.
  2. Global Scope: This maintains a server-wide counter. When a Global Item is generated, the counter increases. When that item is destroyed (e.g., thrown in lava), the counter decreases. This creates a true "economy of rarity."

Conflict Resolution: If an item has both a Player Limit and a Global Limit, the plugin enforces the stricter of the two. For example, if the Global Limit allows 1 more item, but the player is full, they cannot acquire it.

Commands

  • /itemcontrol menu - Opens the main administration interface.
  • /itemcontrol reload - Reloads the limits.yml configuration file from disk.
  • /itemcontrol help - Displays the available commands.

Permissions

  • itemcontrol.admin - Grants full access to the plugin, including the GUI and reload commands.
  • itemcontrol.bypass.* - Grants bypass rights for all limits.
  • itemcontrol.bypass.<item> - Bypasses limits for a specific item (e.g., itemcontrol.bypass.oak_planks).
  • itemcontrol.bypass.<enchantment> - Bypasses limits for a specific enchantment (e.g., itemcontrol.bypass.sharpness).

Configuration

The limits.yml file handles data storage, but also offers core settings:

  • Broadcasts: When enabled, the server announces when a limited global item is found or lost.
  • Console Log: Toggles detailed logging of plugin actions to the server console.
  • Bypass Enabled: A master switch to enable or disable the permission-based bypass system entirely.
  • Inventory Check: Toggles the active background task that scans player inventories for limit violations.

Installation

  1. Download the plugin JAR file.
  2. Place it into your server's plugins folder.
  3. Restart the server.
  4. Use /itemcontrol menu to start configuring limits.