# Item Limiter – Plugin Description<\/p>\n
## Overview
\nItem 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.<\/p>\n
## Key Features<\/p>\n
### Comprehensive Item Limiting
\n– Set individual limits for any Minecraft item using simple configuration
\n– Limits apply to total inventory count across all slots
\n– Supports all Minecraft materials and items
\n– Easy-to-edit YAML configuration with clear examples<\/p>\n
### Multi-Layer Protection
\nThe plugin prevents players from exceeding limits through multiple methods:
\n– **Ground Pickup Prevention**: Blocks picking up items when at limit, allows partial pickup when close to limit
\n– **Container Interaction Blocking**: Prevents taking items from chests, barrels, shulkers, and other containers
\n– **Shift-Click Protection**: Stops shift-clicking items from containers to inventory
\n– **Drag & Drop Prevention**: Blocks dragging limited items into inventory
\n– **Cursor Movement Blocking**: Prevents manually moving limited items with mouse cursor<\/p>\n
### Automatic Enforcement
\n– **Periodic Inventory Scans**: Configurable timer checks all online players’ inventories
\n– **Automatic Excess Removal**: Removes items that exceed limits during scans
\n– **Player Notifications**: Clear, color-coded messages inform players when limits are reached
\n– **Smart Partial Pickup**: When picking up would exceed limit, only the allowed amount is collected<\/p>\n
### Administrative Features
\n– **Bypass Permission**: Ops and trusted players can bypass all limits
\n– **Reload Command**: Update configuration without restarting the server
\n– **Tab Completion**: User-friendly command interface
\n– **Detailed Logging**: See which limits are loaded on startup<\/p>\n
### Performance & Compatibility
\n– **Optimized Checks**: Efficient event handling minimizes server impact
\n– **Configurable Intervals**: Set scan frequency to balance enforcement and performance
\n– **Paper API**: Built specifically for Paper 1.21.8 and compatible forks
\n– **Java 21**: Modern codebase using latest Java features<\/p>\n
## Use Cases<\/p>\n
### Economy Servers
\n– Limit currency items like emeralds or diamonds to maintain balanced economy
\n– Prevent inflation by controlling valuable item accumulation
\n– Create scarcity for rare items to drive player trading<\/p>\n
### Survival Servers
\n– Limit TNT or explosive items for safety and grief prevention
\n– Control enchanted golden apples to maintain challenge
\n– Restrict netherite ingots to preserve endgame progression<\/p>\n
### Mini-Game Servers
\n– Balance player inventories in competitive game modes
\n– Ensure fair gameplay by limiting powerful items
\n– Create custom challenges with item restrictions<\/p>\n
### Roleplay Servers
\n– Enforce realistic inventory limitations
\n– Control special roleplay items and prevent hoarding
\n– Maintain immersion with inventory capacity restrictions<\/p>\n
## Configuration Example<\/p>\n
“`yaml
\ncheck-interval: 60 # Scan inventories every 60 seconds<\/p>\n
item-limits:
\n DIAMOND: 64 # Limit to one stack
\n EMERALD: 32 # Limit to half stack
\n GOLDEN_APPLE: 16 # Limit golden apples
\n ENCHANTED_GOLDEN_APPLE: 4 # Heavily limit god apples
\n NETHERITE_INGOT: 32 # Control endgame materials
\n TNT: 64 # Prevent TNT hoarding
\n ENDER_PEARL: 16 # Limit mobility items
\n TOTEM_OF_UNDYING: 2 # Rare survival items
\n“`<\/p>\n
## Commands & Permissions<\/p>\n
**Commands:**
\n– `\/itemlimiter reload` – Reload configuration (Permission: `itemlimiter.reload`)
\n– Aliases: `\/ilimit`, `\/il`<\/p>\n
**Permissions:**
\n– `itemlimiter.reload` – Allows reloading the plugin (Default: op)
\n– `itemlimiter.bypass` – Bypass all item limits (Default: op)<\/p>\n
## Player Experience<\/p>\n
When a player encounters a limit, they receive clear feedback:
\n– **At Limit**: “\u00a7c[Item Limiter] You cannot pick up more DIAMOND (limit: 64)”
\n– **Partial Pickup**: “\u00a7e[Item Limiter] Picked up 10 EMERALD (limit reached: 32)”
\n– **Excess Removed**: “\u00a7c[Item Limiter] Removed 15 TNT (limit: 64)”<\/p>\n
Messages use Minecraft color codes for visual clarity and are designed to be informative without being intrusive.<\/p>\n
## Technical Details<\/p>\n
– **Version**: 1.0.0
\n– **Minecraft Version**: 1.21.8
\n– **Server Software**: Paper (or compatible forks like Purpur, Pufferfish)
\n– **Java Version**: 21+
\n– **Main Class**: `com.Orange.itemLimiter.ItemLimiter`
\n– **Dependencies**: None (Paper API provided by server)<\/p>\n
## Installation<\/p>\n
1. Download `ItemLimiter-1.0.0.jar`
\n2. Place in server’s `plugins\/` folder
\n3. Restart server or load with plugin manager
\n4. Edit `plugins\/ItemLimiter\/config.yml` to configure limits
\n5. Use `\/itemlimiter reload` to apply changes<\/p>\n
## Building from Source<\/p>\n
Requires Maven and JDK 21:
\n“`bash
\nmvn clean package
\n“`<\/p>\n
Output: `target\/ItemLimiter-1.0.0.jar`<\/p>\n
## Support<\/p>\n
Developed by Electric Orange
\nWebsite: electric-orange.co.uk<\/p>\n
For issues, feature requests, or questions, please contact through the website.<\/p>\n
## Why Choose Item Limiter?<\/p>\n
\u2713 **Simple Yet Powerful** – Easy configuration, comprehensive protection
\n\u2713 **Performance Focused** – Minimal server impact with optimized code
\n\u2713 **Actively Maintained** – Built for latest Minecraft versions
\n\u2713 **Fully Customizable** – Control exactly which items and quantities
\n\u2713 **Player Friendly** – Clear messages and smart partial pickup
\n\u2713 **Admin Friendly** – Bypass permissions and hot-reload support <\/p>\n
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.<\/p>\n","protected":false},"excerpt":{"rendered":"
Allows you to limit the amount of items players can hold.<\/p>\n","protected":false},"featured_media":86703,"template":"","meta":{"_minecraft_slug":"item-amounts","_minecraft_project_id":"1u1kxOzv","_minecraft_author":"0ranges_","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":27,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"item-amounts.zip","_minecraft_size_bytes":21352,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:14:32.385714Z","_minecraft_date_created":"2026-01-25T22:39:03.462052Z","_minecraft_date_modified":"2026-01-25T13:00:55.672452Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/item-amounts","_minecraft_icon_attachment_id":86703,"_minecraft_imported_at":"2026-06-04T22:52:51+00:00","_minecraft_import_hash":"084cb1ee6be7968ea0782c845def6abb","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-86702","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n