ItemLimit — Item Vault & Limit Enforcerby XSTUDIO Development
Modern item limit system with a clean Item Vault + Withdraw Menu (1 / 8 / 16 / 32) and smart Withdraw All.
OverviewKeep PvP / SMP balance under control by enforcing configurable inventory limits (Totems, Pearls, Wind Charges, EXP Bottles, Cobwebs, etc).
When a player exceeds the limit, extra items are safely moved into a personal Vault and can be withdrawn later — without bypassing the limit.
Works on Paper 1.21+ SmallCapital styled UI + messages 6 Rows GUI with Border + Inner glass styling Right-click Withdraw All (Survival safe) Fully configurable limits + slots + GUI styling
Key Features- Item Limit Enforcement (configurable per item)
- Auto Confiscation → Vault (safe storage in vault.yml)
- Item Vault GUI (6 rows, border + inner glass design)
- Withdraw Menu with selectable amounts: 1 / 8 / 16 / 32 (configurable)
- Smart Withdraw All (never exceeds your current limit)
- Real-time max withdraw line:
&8Max amount u can withdraw is %amount% - Bypass Permission for admins/staff
- Lightweight & optimized (no heavy world scanning)
- Clean config structure (easy to edit)
MENU
GUI Behavior- /itemlimit opens the Item Vault
- LEFT-CLICK an item → opens Withdraw Menu
- RIGHT-CLICK an item → Withdraw All (Survival compatible)
- Withdraw All gives only the maximum allowed right now:
depends on inventory count, item limit, vault amount and free inventory space.
Commands
Code:
/itemlimit
/itemvault
/vault
/xitemlimit reload
Permissions
Code:
itemlimit.use - Allows /itemlimit (default: true)
itemlimit.bypass - Ignores limits (default: op)
itemlimit.admin - Allows /xitemlimit reload (default: op)
Configuration (example)
Code:
settings:
enforce-every-ticks: 50
bypass-permission: "itemlimit.bypass"
gui:
rows: 6
vault-title: "&d&lITEM VAULT"
withdraw-title: "&7WITHDRAW: %item%"
withdraw-amounts: [1, 8, 16, 32]
glass:
border:
enabled: true
material: "GRAY_STAINED_GLASS_PANE"
name: " "
inner:
enabled: true
material: "BLACK_STAINED_GLASS_PANE"
name: " "
items:
totem:
material: "TOTEM_OF_UNDYING"
display: "&eTOTEMS"
limit: 3
slot: 20- Drop ItemLimit.jar into your server /plugins folder
- Start server once to generate files
- Edit config.yml to set limits, GUI slots, glass styling
- Use /xitemlimit reload after edits
Storage- All confiscated items are stored safely per-player in: vault.yml
- No database needed
Compatibility- Paper / Purpur (Paper-based)
- Minecraft 1.21.8
- Java 21 recommended
SupportIf you need help with setup, GUI layout, or want custom items/limits, contact me on BBB.
I actively maintain and update my plugins.
NOTE: Sharing, redistributing or leaking this plugin will result in permanent license revocation without refund.
