Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
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.bypassto 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
# ============================================================
# 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 causing a scan-everyone-at-once lag spike.
# Small servers (<50 players): 10-20 (0.5s-1s)
# Medium servers (50-100): 40-60 (2s-3s)
# Large servers (100-200+): 100+ (5s+)
# Reload with /itemlimit reload to apply changes without restarting.
sweep-interval-ticks: 20
limits:
# --- Regular Items (-1 = no limit, 0 = banned, 1+ = limit) ---
GOLDEN_APPLE: -1
ENCHANTED_GOLDEN_APPLE: -1
TOTEM_OF_UNDYING: -1
ENDER_PEARL: -1
SHIELD: -1
# --- Potions ---
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)


