Item Limiter

NotDqshers Item Limiter

NotDqsher's Item Limiter is a lightweight Paper plugin for capping how many of any item or potion a player can carry at once. Instead of typing numbers into a config, limits are set visually — hold the item, run the command, and physically place however many you want to allow into the GUI. That count becomes the limit. Simple.

Potions are handled intelligently. One limit covers every variant — set a cap for Strength and it applies to normal, extended, strong, splash, and lingering all at once. The plugin enforces limits on pickup, inventory clicks, and runs a background check every second to catch anything that slips through via other plugins or commands, force-dropping excess items at the player's feet.

Features

• /itemlimit set — Hold an item and open the deposit GUI to set its limit
• /itemlimit limits — View all active limits in a paginated chest GUI
• Place items physically into the GUI — however many you place = the limit
• Force-drops excess items every second regardless of how they entered the inventory
• itemlimit.bypass permission to exempt players from all limits
• Right-click any item in the limits GUI to remove its limit instantly

Commands

| Command | Description | Permission |
|---|---|---|
| /itemlimit set | Hold item → opens deposit GUI to set limit | itemlimit.use |
| /itemlimit limits | View all active limits in a GUI | itemlimit.use |

Aliases: /il, /ilimit

Permissions

| Permission | Description | Default |
|---|---|---|
| itemlimit.use | Access to all commands and GUI | OP |
| itemlimit.admin | Access to reload | OP |
| itemlimit.bypass | Bypass all item limits | false |

Configuration

# ============================================================
#   NotDqshers item limiter — config.yml
# ============================================================
#
# HOW LIMITS WORK
# ---------------
#   -1  = No limit (item is completely unrestricted)
#   1+  = The maximum number of this item a player can carry
#
# ITEM KEY FORMAT
# ---------------
#   Regular items  ->  MATERIAL_NAME
#                      e.g.  GOLDEN_APPLE
#
#   Potions        ->  POTION_<EFFECT>
#                      e.g.  POTION_SPEED
# VALID POTION EFFECTS
# --------------------
#   SPEED, SLOWNESS, HASTE, MINING_FATIGUE, STRENGTH,
#   INSTANT_HEAL, INSTANT_DAMAGE, JUMP_BOOST, NAUSEA,
#   REGENERATION, RESISTANCE, FIRE_RESISTANCE,
#   WATER_BREATHING, INVISIBILITY, BLINDNESS, NIGHT_VISION,
#   HUNGER, WEAKNESS, POISON, WITHER, HEALTH_BOOST,
#   ABSORPTION, SATURATION, GLOWING, LEVITATION,
#   LUCK, UNLUCK, SLOW_FALLING, CONDUIT_POWER,
#   DOLPHINS_GRACE, BAD_OMEN, HERO_OF_THE_VILLAGE, DARKNESS
# ============================================================

settings:
  notify-player: true
  # Short message — {limit} = cap, {item} = item name
  notify-message: "&c&lMax limit for &a&l{item} &c&lis &a&l{limit}&c&l."
  drop-excess: true

limits:
  # --- Regular Items ---
  GOLDEN_APPLE: -1
  ENCHANTED_GOLDEN_APPLE: -1
  TOTEM_OF_UNDYING: -1
  ENDER_PEARL: -1
  SHIELD: -1

  # --- Potions (covers all variants) ---
  POTION_HEALING: -1
  POTION_REGENERATION: -1
  POTION_STRENGTH: -1
  POTION_SPEED: -1
  POTION_FIRE_RESISTANCE: -1
  POTION_INVISIBILITY: -1
  POTION_SLOWNESS: -1
  POTION_WEAKNESS: -1
  POTION_POISON: -1
  POTION_INSTANT_DAMAGE: -1

Want to support plugin and authors? Just tell everyone about this plugin!
Yeah, you got it right. Just by advertising, you will support the plugin and the creators well. The more people will know about this mod, the more downloads it will have, more downloads will give good motivation to authors and increase income from the site (literally free donation). Remember, advertising must not be intrusive and annoiyng!

What you can do?
Make a video review / advertisement

Tell your friends about this plugin

Just download this plugin (if you want to play with it :D)