Item Limiter

# NotDqshers Item Limiter A lightweight Paper plugin for capping how many of any item or potion a player can carry, or banning items outright. Limits are set visually — hold the item, run the command, place however many you want to allow into the GUI, and that's your limit. No editing YAML by hand. ## Features - Set limits visually with `/itemlimit set` — no config editing - Ban items completely — they get deleted on sight, not dropped - Click-to-unban and click-to-remove-limit GUIs (since banned items can't be held) - Catches items hidden in bundles, shulker boxes, and ender chests - Scans chests the moment they're opened - Everything's blocked instantly (pickup, crafting, clicking) — the periodic sweep is just a backup - Sweep interval is configurable and won't lag out big servers - `itemlimit.bypass` to exempt staff ## Commands | Command | Description | Permission | |---|---|---| | `/itemlimit set` | Hold an item → opens the deposit GUI to set its limit | `itemlimit.use` | | `/itemlimit limits` | View all active limits in a paginated GUI | `itemlimit.use` | | `/itemlimit ban` | Hold an item, then confirm within 10s to ban it | `itemlimit.use` | | `/itemlimit unban` | Opens a GUI listing banned items — click to unban | `itemlimit.use` | | `/itemlimit removelimit` | Opens a GUI listing limited items — click to remove | `itemlimit.use` | | `/itemlimit reload` | Reload `config.yml` without restarting | `itemlimit.admin` | Aliases: `/il`, `/ilimit` ## Permissions | Permission | Description | Default | |---|---|---| | `itemlimit.use` | Access to all commands and GUIs | OP | | `itemlimit.admin` | Access to `/itemlimit reload` | OP | | `itemlimit.bypass` | Bypass all item limits and bans | false | ## Configuration <details> <summary>config.yml</summary> ```yaml # ============================================================ # 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 GUI showing all active limits # and banned items. # # /itemlimit ban Hold an item, then confirm within 10s # to ban it. Banned items are DELETED # from player inventories, not dropped. # # /itemlimit unban Opens a GUI listing all banned items — # click one to unban it. # # /itemlimit removelimit Opens a GUI listing all limited items — # click one to remove its limit. # # /itemlimit reload Reload this config from disk. # # Aliases: /il, /ilimit # # PERMISSIONS # ----------- # itemlimit.use Required to run /itemlimit # itemlimit.admin Access to /itemlimit reload # itemlimit.bypass Exempt from all limits and bans # # HOW LIMITS WORK # --------------- # -1 = No limit (completely unrestricted) # 0 = BANNED (item is deleted from player inventories) # 1+ = 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, lingering, and tipped arrow # 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 # {limit} = the cap, {item} = item name notify-message: "&9&lMax limit for &b&l{item} &9&lis &b&l{limit}&9&l." # Shown when a banned item is removed banned-message: drop-excess: true # How often (in ticks, 20 ticks = 1 second) EVERY online player gets fully # re-scanned for banned or over-limit items. This is a safety-net sweep — # most enforcement already happens instantly via pickup/click/craft/join # events, so raising this mostly just widens the window for edge cases # like /give or other plugins adding items directly. # # This does NOT mean all players are scanned in one go every X ticks — # the plugin automatically spreads the work into small batches (every # 5 ticks) so the number below only controls how often the FULL cycle # completes, not the cost of any single tick. This keeps large player # counts from cau