ItemLimiter

Limit how many items players can have, craft, gain from loot, plus set cooldowns on usage

16

Quick challenge

How far can you run before the mobs catch you?

ItemLimiter

Banner

Restrict and balance vanilla Minecraft for your SMP server.

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

Java 21Java 21

Paper 1.21+Paper 1.21+

ReleaseRelease

WikiWiki

---

Three systems, one plugin

Cooldowns - delay reuse of tools, weapons and consumables Inventory limits - cap how many of an item a player can carry Source blocking - disable crafting, trading, loot and other sources

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

ADS