ItemLimiter

<div align="center">

Restrict and balance vanilla Minecraft for your SMP server.

Cooldowns, inventory caps, acquisition limits, and source blocking - all in simple YAML.

Java 21

Paper 1.21+

Release

Wiki

</div>

---

Three systems, one plugin

<p align="center"> <img src="https://raw.githubusercontent.com/PanHaskins/ItemLimiter/refs/heads/master/docs/images/limited-cooldown.gif" width="390" height="320" alt="Cooldowns - delay reuse of tools, weapons and consumables" /> <img src="https://raw.githubusercontent.com/PanHaskins/ItemLimiter/refs/heads/master/docs/images/limited-inventory.gif" width="390" height="320" alt="Inventory limits - cap how many of an item a player can carry" /> <img src="https://raw.githubusercontent.com/PanHaskins/ItemLimiter/refs/heads/master/docs/images/limited-sources.gif" width="390" height="320" alt="Source blocking - disable crafting, trading, loot and other sources" /> </p>

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

Also supported

- Client cooldown bar → per-player and global limits, persisted across restarts - Client cooldown bar → max level + per-source blocking (anvil, table, loot, trading…) - Client cooldown bar → level + duration caps, covers splash / lingering / long / strong in one entry - Client cooldown bar → whitelist or blacklist per item - Client cooldown bar → pick either, data survives restarts - Client cooldown bar → gradients, hex, legacy codes, PlaceholderAPI - Client cooldown bar → via optional Client cooldown bar

Quick start

```yaml

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 | |---|---|---| | PlaceholderAPI (Purpur, Folia) | 1.21+ | Spigot shouldn't be supported | | PlaceholderAPI | 21+ | | | PlaceholderAPI | 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 - Database Setup → MySQL / SQLite - Messages → MiniMessage, placeholders, notifications