⚔️ PvPItemLimiter | Advanced Inventory Management

PvPItemLimiter is a lightweight, highly configurable Paper plugin designed for version 1.21.11. It allows server administrators to restrict the maximum amount of specific PvP items a player can hold in their inventory, armor slots, and offhand combined.

Perfect for competitive servers, Crystal PvP arenas, and SMPs looking to balance intense combat mechanics and prevent item hoarding!

✨ Key Features

• 📦 Group-Based Limits: Combine multiple items into custom groups (e.g., group all armor types together or separate them).
• 🛑 Smart Pickup Prevention: Players cannot pick up items from the ground if their inventory limit is already reached. If a stack would exceed the limit, only the allowed amount is picked up.
• ⚡ Robust Inventory Enforcement: Instantly catches and drops excess items resulting from shift-clicks, hotbar swapping, or inventory drag actions.
• 💬 MiniMessage Support: Fully compatible with Paper's modern MiniMessage format for vibrant, customizable notifications.
• ⏱️ Anti-Spam Cooldowns: Built-in cooldowns prevent chat spam when players stand on items they can't pick up.
• 🔑 Bypass Permission: Give staff or specific ranks the ability to bypass restrictions seamlessly.

📋 Default Configuration & Tracked Items

Out of the box, the plugin includes pre-configured groups for common PvP essentials:

• Ender Pearls (Default limit: 16)
• Golden Apples (Regular & Enchanted sharing a limit of 32)
• Wind Items (Wind Charges & Breeze Rods, limit: 16)
• Maces (Limit: 1)
• Cobwebs (Limit: 64)
• Experience Bottles (Limit: 64)
• Potions (Regular, Splash & Lingering, limit: 5)
• Armor (All tiers from Leather to Netherite + Turtle Helmet, combined total limit of 4 pieces)

⚙️ Configuration (config.yml)

yaml
messages:
  limit-reached: "<red>You have reached the limit for <yellow>%group%</yellow>! Excess items were dropped on the ground."
  cannot-pickup: "<red>You cannot pick up <yellow>%group%</yellow>! Your inventory limit for this item is full."

limits:
  EnderPearls:
    max-amount: 16
    materials:
      - ENDER_PEARL
   ... much more!   
  # Add your custom groups here easily!

🛡️ Permissions

pvplimiter.bypass — Allows players to ignore all inventory limits. (Default: OP)