Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for PrIyme

A lightweight, secure, and optimized Minecraft Paper plugin (1.21+) that allows server admins to limit the amount of spe

Report ItemLimit?

Release
1.0-SNAPSHOT

PrIyme released ItemLimit version 1.0-SNAPSHOT on January 18, 2026

🛡️ ItemLimiter

Stop item hoarding. Balance your PvP and Economy.

ItemLimiter is a lightweight, secure, and high-performance plugin for Paper 1.21+. It allows server administrators to define strict carrying limits for specific items such as Totems of Undying, Enchanted Golden Apples, or End Crystals — without hurting player experience.

Unlike basic limit plugins that simply cancel events, ItemLimiter uses smart logic to keep gameplay smooth and fair.


✨ Why ItemLimiter?

🧠 Smart Pickup System

Most limiter plugins cause annoying “Inventory Full” spam.

Example scenario:

  • Limit: 2 Totems
  • Player has: 1 Totem
  • Ground item: Stack of 5 Totems

ItemLimiter solution:

  • Calculates the remaining allowed amount
  • Player picks up exactly 1
  • Remaining 4 stay on the ground
  • ✅ No spam
  • ✅ No errors
  • ✅ Smooth gameplay

🔒 Secure Prevention

Players will always try to bypass limits — ItemLimiter stops them reliably.

Blocked bypass methods:

  • Item pickup (ground checks)
  • Crafting (prevents exceeding limits)
  • Inventory clicks
  • Number-key swaps
  • Offhand swaps (F)
  • Drag & drop
  • Shift-clicking from containers
  • Chests & Shulkers

Everything is validated before the item enters the inventory.


⚡ Optimized Performance

Built with performance in mind:

  • O(1) lookups using HashMaps
  • Event-driven only (no background tasks)
  • Modern Paper 1.21 API
  • No schedulers, no timers, no overhead

Perfect for PvP, Anarchy, and Economy servers.


🖥️ In-Game GUI

No need to touch config files.

Command

/limit

GUI Controls

  • Left-Click → Increase limit (+1)
  • Right-Click → Decrease limit (-1)
  • Shift-Click → Remove limit
  • Add Item → Hold the item in your hand and click Add

🎮 Installation

  1. Download the latest .jar
  2. Place it in your plugins/ folder
  3. Restart the server
  4. Use /limit to configure items

📜 Commands & Permissions

Command Permission Description
/limit itemlimiter.admin Opens the management GUI

⚙️ Configuration

config.yml is simple and optional — the GUI is recommended.

# ItemLimiter Config
# Format: MATERIAL: AMOUNT
limits:
  TOTEM_OF_UNDYING: 1
  ENCHANTED_GOLDEN_APPLE: 6
  END_CRYSTAL: 16

# List of worlds where limits are active
# Leave empty [] to enable globally
enabled-worlds: []

✅ Features at a Glance

  • Smart stack splitting
  • No inventory spam
  • Fully bypass-safe
  • GUI-based management
  • Paper 1.21+ optimized
  • Lightweight & fast

Information

Published onJanuary 18, 2026
Downloads10

Platforms

Paper Paper (1.21-1.21.11)