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 ```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: - **At Limit**: "§c You cannot pick up more DIAMOND (limit: 64)" - **Partial Pickup**: "§e Picked up 10 EMERALD (limit reached: 32)" - **Excess Removed**: "§c 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: ```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 th