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 place however many you want to allow into the GUI. That count becomes the limit. Simple.

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

config.yml

# ============================================================
#   notdqshers item limiter — config.yml
# ============================================================
#
# COMMANDS
# --------
#   /itemlimit set      Hold an item, opens the deposit GUI.
#                        Place however many you want allowed —
#                        that count becomes the limit.
#
#   /itemlimit limits    Opens a read-only GUI showing every
#                        active limit currently configured.
#
#   Aliases: /il, /ilimit
#
# PERMISSIONS
# -----------
#   itemlimit.use      Required to run /itemlimit at all
#   itemlimit.admin    Full admin access
#   itemlimit.bypass    Exempts a player from all limits entirely
#
# 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
#                      Automatically applies to normal, extended,
#                      strong, splash, and lingering variants.
#
# 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: "&9&lMax limit for &b&l{item} &9&lis &b&l{limit}&9&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)