Restrict and balance vanilla Minecraft for your SMP server.
Cooldowns, inventory caps, acquisition limits, and source blocking - all in simple YAML.
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
- Grab the JAR from Releases
- Drop it in
plugins/, start the server - Edit
plugins/ItemLimiter/items.yml - 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
