Item Amounts

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

1. Download ItemLimiter-1.0.0.jar
2. Place in server's plugins/ folder
3. Restart server or load with plugin manager
4. Edit plugins/ItemLimiter/config.yml to configure limits
5. 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.