Item Limiter - Plugin Description

Overview

Item Limiter is a powerful and flexible Minecraft Paper plugin that gives server administrators complete control over how many of each item type players can possess in their inventory. Perfect for balanced gameplay, economy control, and preventing item hoarding.

Key Features

Comprehensive Item Limiting

Set individual limits for any Minecraft item using simple configuration
Limits apply to total inventory count across all slots
Supports all Minecraft materials and items
Easy-to-edit YAML configuration with clear examples

Multi-Layer Protection

The plugin prevents players from exceeding limits through multiple methods:

Ground Pickup Prevention: Blocks picking up items when at limit, allows partial pickup when close to limit
Container Interaction Blocking: Prevents taking items from chests, barrels, shulkers, and other containers
Shift-Click Protection: Stops shift-clicking items from containers to inventory
Drag & Drop Prevention: Blocks dragging limited items into inventory
Cursor Movement Blocking: Prevents manually moving limited items with mouse cursor

Automatic Enforcement

Periodic Inventory Scans: Configurable timer checks all online players' inventories
Automatic Excess Removal: Removes items that exceed limits during scans
Player Notifications: Clear, color-coded messages inform players when limits are reached
Smart Partial Pickup: When picking up would exceed limit, only the allowed amount is collected

Administrative Features

Bypass Permission: Ops and trusted players can bypass all limits
Reload Command: Update configuration without restarting the server
Tab Completion: User-friendly command interface
Detailed Logging: See which limits are loaded on startup

Performance & Compatibility

Optimized Checks: Efficient event handling minimizes server impact
Configurable Intervals: Set scan frequency to balance enforcement and performance
Paper API: Built specifically for Paper 1.21.8 and compatible forks
Java 21: Modern codebase using latest Java features

Use Cases

Economy Servers

Limit currency items like emeralds or diamonds to maintain balanced economy
Prevent inflation by controlling valuable item accumulation
Create scarcity for rare items to drive player trading

Survival Servers

Limit TNT or explosive items for safety and grief prevention
Control enchanted golden apples to maintain challenge
Restrict netherite ingots to preserve endgame progression

Mini-Game Servers

Balance player inventories in competitive game modes
Ensure fair gameplay by limiting powerful items
Create custom challenges with item restrictions

Roleplay Servers

Enforce realistic inventory limitations
Control special roleplay items and prevent hoarding
Maintain immersion with inventory capacity restrictions

Configuration Example

check-interval: 60  # Scan inventories every 60 seconds

item-limits:
  DIAMOND: 64              # Limit to one stack
  EMERALD: 32              # Limit to half stack
  GOLDEN_APPLE: 16         # Limit golden apples
  ENCHANTED_GOLDEN_APPLE: 4  # Heavily limit god apples
  NETHERITE_INGOT: 32      # Control endgame materials
  TNT: 64                  # Prevent TNT hoarding
  ENDER_PEARL: 16          # Limit mobility items
  TOTEM_OF_UNDYING: 2      # Rare survival items

Commands & Permissions

Commands:

/itemlimiter reload - Reload configuration (Permission: itemlimiter.reload)
Aliases: /ilimit, /il

Permissions:

itemlimiter.reload - Allows reloading the plugin (Default: op)
itemlimiter.bypass - Bypass all item limits (Default: op)

Player Experience

When a player encounters a limit, they receive clear feedback:

At Limit: "§c[Item Limiter] You cannot pick up more DIAMOND (limit: 64)"
Partial Pickup: "§e[Item Limiter] Picked up 10 EMERALD (limit reached: 32)"
Excess Removed: "§c[Item Limiter] Removed 15 TNT (limit: 64)"

Messages use Minecraft color codes for visual clarity and are designed to be informative without being intrusive.

Technical Details

Version: 1.0.0
Minecraft Version: 1.21.8
Server Software: Paper (or compatible forks like Purpur, Pufferfish)
Java Version: 21+
Main Class: com.Orange.itemLimiter.ItemLimiter
Dependencies: None (Paper API provided by server)

Installation

Download ItemLimiter-1.0.0.jar
Place in server's plugins/ folder
Restart server or load with plugin manager
Edit plugins/ItemLimiter/config.yml to configure limits
Use /itemlimiter reload to apply changes

Building from Source

Requires Maven and JDK 21:

mvn clean package

Output: target/ItemLimiter-1.0.0.jar

Support

Developed by Electric Orange Website: electric-orange.co.uk

For issues, feature requests, or questions, please contact through the website.

Why Choose Item Limiter?

✓ Simple Yet Powerful - Easy configuration, comprehensive protection
✓ Performance Focused - Minimal server impact with optimized code
✓ Actively Maintained - Built for latest Minecraft versions
✓ Fully Customizable - Control exactly which items and quantities
✓ Player Friendly - Clear messages and smart partial pickup
✓ Admin Friendly - Bypass permissions and hot-reload support

Item Limiter provides the perfect balance between server control and player experience, making it an essential tool for any server administrator looking to manage item quantities effectively.

Item Amounts