# ItemLimiter<\/p>\n
**ItemLimiter** is a lightweight and highly configurable Minecraft plugin that allows server owners to **limit how many of a specific item a player can hold in their inventory**.<\/p>\n
It prevents players from hoarding powerful items such as **Totems, Ender Pearls, Golden Apples, or any other material** by enforcing a configurable maximum amount per item.<\/p>\n
The plugin is designed to be **fully configurable**, **lightweight**, and **safe**, while preventing bypasses through containers, crafting, inventory manipulation, and item pickups.<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### \ud83d\udce6 Inventory Item Limits<\/p>\n
Each configured item can have a **maximum amount that a player may carry**.<\/p>\n
If a player attempts to exceed that amount:<\/p>\n
– the action will be **blocked**
\n– or the **excess items will automatically drop** from their inventory<\/p>\n
Example use cases:<\/p>\n
– Limit **Totems to 1**
\n– Limit **Ender Pearls to 16**
\n– Limit **Golden Apples to 8**<\/p>\n
—<\/p>\n
### \ud83e\udde9 Configurable Item Actions<\/p>\n
Each item can restrict different types of interactions:<\/p>\n
| Action | Description |
\n|——–|————-|
\n| `pickup` | Prevents players from picking up additional items when the limit is reached |
\n| `containers` | Prevents players from taking the item out of containers |
\n| `inventory` | Prevents moving items into the player’s inventory |
\n| `craft` | Prevents crafting items if the limit from their inventory would be exceeded |
\n| `global` | Prevents crafting items if the global limit from this item would be reached |<\/p>\n
Example config:<\/p>\n
“`json
\n{
\n “TOTEM_OF_UNDYING”: {
\n “limit”: 1,
\n “action”: [“pickup”, “containers”, “inventory”]
\n },
\n “ENDER_PEARL”: {
\n “limit”: 16,
\n “action”: [“pickup”]
\n }
\n “MACE”: {
\n “limit”: 1,
\n “action”: [“global”]
\n }
\n}
\n“`<\/p>\n
Limits are based on **total items in the player’s inventory\/global crafting**.<\/p>\n
—<\/p>\n
### \ud83d\udee1\ufe0f Smart Limit Enforcement<\/p>\n
If a player already exceeds a limit, for example after plugin installation or configuration changes, the plugin will automatically:<\/p>\n
1. Detect the excess items
\n2. Remove them from the player’s inventory
\n3. Drop them naturally on the ground<\/p>\n
This prevents players from bypassing limits with previously stored items.<\/p>\n
—<\/p>\n
### \ud83d\udce6 Container-Friendly Logic<\/p>\n
Players can still **store items in containers** without restriction.<\/p>\n
Allowed:<\/p>\n
– Inventory to chest using shift-click
\n– Inventory to shulker boxes
\n– Inventory to bundles<\/p>\n
Blocked when limit is reached:<\/p>\n
– Chest to inventory
\n– Bundle to inventory
\n– Hopper to inventory<\/p>\n
This ensures players can **store items but cannot exceed their personal limit**.<\/p>\n
—<\/p>\n
### \u2699\ufe0f Fully Configurable<\/p>\n
The plugin uses **Bukkit material names** and JSON configuration.<\/p>\n
Structure:<\/p>\n
“`text
\nplugins\/ItemLimiter\/<\/p>\n
config.json
\nconfig-examples.txt<\/p>\n
translations\/
\n messages.json
\n“`<\/p>\n
Features include:<\/p>\n
– Editable messages
\n– Configurable item limits
\n– Configurable actions per item
\n– Built-in documentation examples<\/p>\n
—<\/p>\n
### \ud83d\udd04 Hot Reload Support<\/p>\n
You can reload the configuration and translation files without restarting the server.<\/p>\n
“`text
\n\/itemlimiter reload
\n“`<\/p>\n
If configuration files are missing, the plugin will **automatically recreate them**.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Why Use ItemLimiter?<\/p>\n Many servers suffer from **item hoarding or stacking issues**, such as:<\/p>\n – Carrying dozens of Totems ItemLimiter provides a **clean and configurable way** to balance gameplay without restricting storage.<\/p>\n —<\/p>\n ## Compatibility<\/p>\n – Minecraft **1.20+** —<\/p>\n ## Example Use Cases<\/p>\n Common items servers limit:<\/p>\n “`text —<\/p>\n ## Configuration Philosophy<\/p>\n ItemLimiter is designed to be:<\/p>\n – **Simple** You decide **which items**, **how many players can carry**, and **which interactions are restricted**.<\/p>\n —<\/p>\n ## Support<\/p>\n If you encounter issues or have feature requests, feel free to open a ticket in the Discord server.<\/p>\n Enjoy a balanced and controlled inventory system for your server.<\/p>\n","protected":false},"excerpt":{"rendered":" A simple and lightweight ItemLimiter plugin!<\/p>\n","protected":false},"featured_media":87014,"template":"","meta":{"_minecraft_slug":"itemlimiter","_minecraft_project_id":"4nl3owbf","_minecraft_author":"nieuwjaar","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":64,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemlimiter.zip","_minecraft_size_bytes":42214401,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T20:48:28.584119Z","_minecraft_date_created":"2026-03-19T03:41:01.377804Z","_minecraft_date_modified":"2026-05-14T09:39:42.520407Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemlimiter","_minecraft_icon_attachment_id":87014,"_minecraft_imported_at":"2026-06-04T23:19:00+00:00","_minecraft_import_hash":"669ce0a003eb709308ae50fa6a5509c6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-87013","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|——–|————-|
\n| `\/itemlimiter help` | Displays all plugin commands |
\n| `\/itemlimiter list [page]` | Lists configured item limits |
\n| `\/itemlimiter info
\n| `\/itemlimiter check
\n| `\/itemlimiter add
\n| `\/itemlimiter edit
\n| `\/itemlimiter remove
\n| `\/itemlimiter reload` | Reloads plugin configuration |<\/p>\n
\n|———–|————-|———|
\n| `itemlimiter.help` | Allows `\/itemlimiter help` | true |
\n| `itemlimiter.info` | Allows `\/itemlimiter info` | op |
\n| `itemlimiter.list` | Allows `\/itemlimiter list` | op |
\n| `itemlimiter.check` | Allows `\/itemlimiter check` | op |
\n| `itemlimiter.globalcheck | Allows `\/itemlimiter globalcheck | op |
\n| `itemlimiter.reload` | Allows `\/itemlimiter reload` | op |
\n| `itemlimiter.add` | Allows adding new item limits | op |
\n| `itemlimiter.edit` | Allows editing item limits | op |
\n| `itemlimiter.remove` | Allows removing item limits | op |
\n| `itemlimiter.update.notify` | Allows receiving update notifications | op |<\/p>\n
\n– Excessive Ender Pearl stacking
\n– Golden Apple hoarding
\n– Item imbalance in PvP or survival<\/p>\n
\n– Spigot \/ Paper
\n– Lightweight with minimal performance impact<\/p>\n
\nTOTEM_OF_UNDYING
\nENDER_PEARL
\nELYTRA
\nMACE
\nGOLDEN_APPLE
\nENCHANTED_GOLDEN_APPLE
\nSHIELD
\nTRIDENT
\n“`<\/p>\n
\n– **Flexible**
\n– **Server-friendly**<\/p>\n