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
- MySQL / SQLite → pick either, data survives restarts
- MiniMessage → gradients, hex, legacy codes, PlaceholderAPI
- Client cooldown bar → via optional PacketEvents
Quick start:
Code (Text):
# plugins/ItemLimiter/items.yml
ENDER_PEARL:
limit:
in_inventory: 8
cooldown:
time: 60
trigger:
- THROW
blacklist_sources:
- MOB_DROPS
- TRADING
- BARTERING
- Grab the JAR from Releases
- Drop it in plugins/, start the server
- Edit plugins/ItemLimiter/items.yml
- Restart the server
Requirements:
| Paper (Purpur, Folia) |
1.21.11+ |
Spigot shouldn't be supported |
| Java |
21+ |
required |
| PacketEvents |
latest |
optional - client cooldown bar |
| PlaceholderAPI |
2.11+ |
optional - placeholders in messages |
Documentation:
Full configuration reference lives on the
Wiki: