ItemLimiter

Three systems, one plugin

Each item in items.yml picks any mix of the three. Leave out what you don't need.

Also supported

• Acquisition caps → per-player and global limits, persisted across restarts
• Enchantment rules → max level + per-source blocking (anvil, table, loot, trading…)
• Potion rules → level + duration caps, covers splash / lingering / long / strong in one entry
• World restrictions → whitelist or blacklist per item
• Exceptions → per-rule bypass via permission or item descriptor (named items, custom model data, external plugin items)
• MySQL / SQLite → pick either, data survives restarts
• MiniMessage → gradients, hex, legacy codes, PlaceholderAPI
• Client cooldown bar → via optional PacketEvents

Quick start

# plugins/ItemLimiter/items.yml
ENDER_PEARL:
  limit:
    in_inventory: 8
  cooldown:
    time: 60
    trigger:
      - THROW
  blacklist_sources:
    - MOB_DROPS
    - TRADING
    - BARTERING

1. Grab the JAR from Releases
2. Drop it in plugins/, start the server
3. Edit plugins/ItemLimiter/items.yml
4. Restart the server

Requirements

| | Version | Notes |
|---|---|---|
| Paper (Purpur, Folia) | 1.21+ | Spigot shouldn't be supported |
| Java | 21+ | |
| PacketEvents | latest | optional — client cooldown bar |
| PlaceholderAPI | 2.11+ | optional — placeholders in messages |

Documentation

Full configuration reference lives on the Wiki:

• Items Configuration → every option, explained
• Sources & Triggers → all 13 sources, all 8 triggers
• Enchantments & Potions → level and duration caps
• Exceptions → per-rule bypass via permission or item descriptor
• Database Setup → MySQL / SQLite
• Messages → MiniMessage, placeholders, notifications