?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
ItemLimiter

ItemLimiter

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

11
1
11
1

Compatibility

Minecraft: Java Edition

26.1.x
1.21.x

Platforms

Links

Report issues View source Visit wiki

Tags

Creators

Details

Licensed MIT
Published 2 weeks ago

Banner

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

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

  • 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
  • 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: