all in one ItemLimiter

ItemLimiter

ItemLimiter is an all-in-one Paper plugin for capping anything players can carry, place, craft or use. Set a limit on any item and the plugin enforces it automatically — items over the cap are deleted from the inventory, and pickups that would push a player over are blocked before they happen. No commands to memorise and no config editing required.

Every part of the plugin is controlled from one organised in-game menu. Create a rule, point it at an item, pick a limit type, set the number, and it is live. Rules can match a single material, a whole material tag, or items filtered by custom model data, display name, lore or enchantment.

Limits can be per player, per world or server wide, and can reset on a rolling timer — so "8 ender pearls per minute" and "32 beacons per world, ever" are both just rules.

Features

• One in-game menu controls everything — no config editing needed
• Ten limit types: banned items, inventory, ender chest, containers, pickup, craft, place, break, drop and use
• Items over the limit are deleted from the inventory automatically
• Pickups, crafts and placements that would exceed a limit are blocked outright
• Per player, per world or server wide limits
• Rolling reset windows for time based limits like uses per minute
• Match items by material, by tag such as #minecraft:shulker_boxes, or by wildcard
• Advanced matching on custom model data, display name, lore text and enchantment level
• Per player overrides by name so a specific op can have their own limit, with -1 for unlimited
• Bypass permissions per rule or for everything at once
• Choose what happens on a violation: cancel, remove, drop, message, title, sound, log or run a console command
• Restrict any rule to specific worlds and game modes
• Searchable item browser with every item in the game, or just add the item you are holding
• Live counter view showing tracked totals with a per rule reset button
• Inspect any online player to see exactly what they count against every rule
• Counters persist across restarts via data.yml
• Works on Paper 1.21.0 through 1.21.x and the 26.x line with no NMS

Commands

Aliases: /il, /ilimit, /limiter, /itemlimit

Permissions

Configuration

config.yml

scan-interval-seconds: 5
save-interval-seconds: 120
notify-cooldown-seconds: 3
enforce-on-join: true
default-excess-mode: REMOVE
log-violations: false
debug: false
place-counter-refund-on-break: true

The plugin ships with no rules, so nothing is limited until you create a rule. rules.yml holds them and is written by the menu, but hand editing works fine — run /il reload afterwards.

rules:
  totems:
    enabled: true
    type: INVENTORY
    scope: PLAYER
    amount: 1
    actions: [ REMOVE, MESSAGE, SOUND ]
    matcher:
      materials: [ TOTEM_OF_UNDYING ]
    count-ender-chest: true
    overrides:
      - Notch=4
      - Mirothe=-1

Overrides are keyed by player name and only take effect while that player is opped — a non opped player always uses the normal limit. Set a value below zero for unlimited.

Limit types: BANNED INVENTORY ENDER_CHEST CONTAINER PICKUP CRAFT PLACE BREAK DROP USE

Scopes: PLAYER WORLD SERVER

Actions: CANCEL REMOVE DROP MESSAGE TITLE SOUND LOG COMMAND

messages.yml supports MiniMessage tags and legacy ampersand colour codes.

Support

Support! Want to support the plugin and its author?

Just tell everyone about this plugin! Yeah, you got it right. Just by advertising, you will support the plugin and the creator well. The more people know about this plugin, the more downloads it will have, more downloads will give good motivation to the author and increase income from the site (literally free donation). Remember, advertising must not be intrusive and annoying!

What you can do?

• Make a video review or advertisement
• Tell your friends about this plugin
• Just download this plugin (if you want to play with it :D)