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: - Cursor Movement Blocking: Blocks picking up items when at limit, allows partial pickup when close to limit - Cursor Movement Blocking: Prevents taking items from chests, barrels, shulkers, and other containers - Cursor Movement Blocking: Stops shift-clicking items from containers to inventory - Cursor Movement Blocking: Blocks dragging limited items into inventory - Cursor Movement Blocking: Prevents manually moving limited items with mouse cursor

Automatic Enforcement

- Smart Partial Pickup: Configurable timer checks all online players' inventories - Smart Partial Pickup: Removes items that exceed limits during scans - Smart Partial Pickup: 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

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

Performance & Compatibility

- Java 21: Efficient event handling minimizes server impact - Java 21: Set scan frequency to balance enforcement and performance - Java 21: 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

```yaml 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: - Excess Removed: "§c[Item Limiter] You cannot pick up more DIAMOND (limit: 64)" - Excess Removed: "§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

- Dependencies: 1.0.0 - Dependencies: 1.21.8 - Dependencies: Paper (or compatible forks like Purpur, Pufferfish) - Dependencies: 21+ - Dependencies: `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: ```bash 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?

✓ Admin Friendly - Easy configuration, comprehensive protection ✓ Admin Friendly - Minimal server impact with optimized code ✓ Admin Friendly - Built for latest Minecraft versions ✓ Admin Friendly - Control exactly which items and quantities ✓ Admin 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.