Item Limiter

Minecraft 版本： 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： paper

标签： game-mechanics management utility

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

config.yml ```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_ # 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 causing a scan-everyone-at-once lag spike. # Small servers (

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)