🛡️ ItemLimiter

Stop item hoarding. Balance your PvP and Economy.

ItemLimiter is a lightweight, secure, and high-performance plugin designed for Paper 1.21+. It allows server administrators to set strict carrying limits for specific items (e.g., Totems of Undying, Enchanted Golden Apples, End Crystals).

Unlike basic plugins that simply cancel pickup events, ItemLimiter features a smart logic system that improves player experience.

---

✨ Why ItemLimiter?

🧠 Smart Pickup System

The biggest issue with other limit plugins is the "Inventory Full" spam. Scenario: You are allowed to carry 2 Totems. You have 1. There is a stack of 5 on the ground. ItemLimiter solves this:

• It calculates exactly how much space you have left until the limit.
• It splits the stack on the ground: You pick up 1 (reaching your limit), and 4 remain on the ground for others.
• No error messages, no spam, just smooth gameplay.

🔒 Secure Prevention

Players are creative when trying to bypass limits. ItemLimiter monitors and blocks:

• Pickup: Ground items are checked instantly.
• Crafting: Prevents crafting if the result would exceed your limit.
• Inventory Management: Blocks inventory clicks, number-key swapping, offhand swapping (F), and drag-and-drop actions that would bypass the limit.
• Containers: Blocks shift-clicking items out of chests/shulkers if over the limit.

⚡ Optimized Performance

• O(1) Lookups: Uses efficient HashMaps for data access.
• Event-Driven: No laggy schedulers or timers running in the background. Code only runs when necessary.
• Paper API: Built strictly on the modern Paper 1.21 API for maximum stability.

🖥️ In-Game GUI

Manage your limits without touching a config file.

• Command: /limit
• Left-Click: Increase limit (+1).
• Right-Click: Decrease limit (-1).
• Shift-Click: Remove limit entirely.
• Add Item: Simply hold the item in your hand and click the "Add" button in the GUI.

---

🎮 Installation & Usage

1. Download the latest .jar file.
2. Place it into your server's plugins/ folder.
3. Restart the server.
4. Use /limit to configure your restricted items.

Commands & Permissions

Command	Permission	Description
/limit	itemlimiter.admin	Opens the management GUI.

---

⚙️ Configuration

The config.yml is simple and clean. While you can use the GUI, you can also edit limits manually here.

# ItemLimiter Config
# Format: MATERIAL: AMOUNT
limits:
  TOTEM_OF_UNDYING: 1
  ENCHANTED_GOLDEN_APPLE: 6
  END_CRYSTAL: 16

# List of worlds where limits are active.
# Leave empty [] to activate globally.
enabled-worlds: []