Item Limiter

Minecraft 版本： 26.1.2

平台： paper

标签： equipment management optimization

ItemLimiter Plugin

Overview
This plugin enforces per-item inventory limits for players on a Paper server. It ensures players cannot exceed defined maximum amounts for specific vanilla materials, regardless of how items are obtained or moved. The system actively checks and controls item flow in real time rather than only correcting after the fact.

Core Features

• Enforces limits per vanilla Material (e.g., DIAMOND, TNT, ENDER_PEARL)
• Applies limits across all major item acquisition and transfer methods

• Prevents players from exceeding configured item caps

  Supported Interactions
  The plugin monitors and limits items in the following scenarios:

1. Ground Pickup

• Prevents players from picking up items beyond their allowed limit
• Excess remains on the ground

2. Chest / Inventory GUIs

• Blocks or reduces item transfers from chests, barrels, shulkers, etc.
• Excess remains in the container

3. Shift-Click / Number Keys / Dragging

• Handles all inventory movement methods inside GUIs
• Ensures limits are enforced regardless of transfer method

4. Crafting Output

• Reduces crafted output if it would exceed the player’s limit
• Prevents crafting entirely if no space is available

5. Hopper Transfers

• Limits items being inserted into player inventories via hoppers

6. Login Safety Check

• Scans and corrects inventory on player join to enforce limits

  Limit Behavior

• Partial Allow Mode:
  If a player would exceed the limit, only the allowed amount is transferred.
  The remainder is left in the original source (ground, chest, or crafting output).

Limit: 16 diamonds
Player has: 14 diamonds
Incoming: 8 diamonds
Result: Player receives 2 diamonds, remaining 6 stay in source

Permissions

• itemlimiter.bypass
  Allows admins to ignore all item limits

• ---

  Configuration (config.yml)
  EXAMPLE:

  limits:
  DIAMOND: 16
  ENDER_PEARL: 8
  TNT: 32

Implementation Notes

• Uses Paper event system (InventoryClickEvent, EntityPickupItemEvent, InventoryDragEvent, etc.)
• Designed for vanilla materials only
• Continuously enforces limits across multiple interaction paths
• Prevents most duplication via consistent inventory validation across events