{"id":87015,"date":"2026-06-05T02:19:10","date_gmt":"2026-06-04T23:19:10","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/"},"modified":"2026-06-05T02:19:10","modified_gmt":"2026-06-04T23:19:10","slug":"itemlimiter_smp","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/","title":{"rendered":"ItemLimiter"},"content":{"rendered":"
\n

![Banner](https:\/\/raw.githubusercontent.com\/PanHaskins\/ItemLimiter\/refs\/heads\/master\/docs\/images\/ItemLimiter-banner.png)<\/p>\n

**Restrict and balance vanilla Minecraft for your SMP server.**<\/p>\n

Cooldowns, inventory caps, acquisition limits, and source blocking – all in simple YAML.<\/p>\n

![Java 21](https:\/\/adoptium.net\/)
\n![Paper 1.21+](https:\/\/papermc.io\/)
\n![Release](https:\/\/github.com\/PanHaskins\/ItemLimiter\/releases)
\n![Wiki](https:\/\/github.com\/PanHaskins\/ItemLimiter\/wiki)<\/p>\n<\/div>\n

—<\/p>\n

## Three systems, one plugin<\/p>\n

\n \"Cooldowns
\n \"Inventory
\n \"Source\n<\/p>\n

Each item in `items.yml` picks any mix of the three. Leave out what you don’t need.<\/p>\n

## Also supported<\/p>\n

– **Acquisition caps** \u2192 per-player and global limits, persisted across restarts
\n– **Enchantment rules** \u2192 max level + per-source blocking (anvil, table, loot, trading\u2026)
\n– **Potion rules** \u2192 level + duration caps, covers splash \/ lingering \/ long \/ strong in one entry
\n– **World restrictions** \u2192 whitelist or blacklist per item
\n– **MySQL \/ SQLite** \u2192 pick either, data survives restarts
\n– **MiniMessage** \u2192 gradients, hex, legacy codes, PlaceholderAPI
\n– **Client cooldown bar** \u2192 via optional PacketEvents<\/p>\n

## Quick start<\/p>\n

“`yaml
\n# plugins\/ItemLimiter\/items.yml
\nENDER_PEARL:
\n limit:
\n in_inventory: 8
\n cooldown:
\n time: 60
\n trigger:
\n – THROW
\n blacklist_sources:
\n – MOB_DROPS
\n – TRADING
\n – BARTERING
\n“`<\/p>\n

1. Grab the JAR from Releases
\n2. Drop it in `plugins\/`, start the server
\n3. Edit `plugins\/ItemLimiter\/items.yml`
\n4. Restart the server<\/p>\n

## Requirements<\/p>\n

| | Version | Notes |
\n|—|—|—|
\n| **Paper** (Purpur, Folia) | 1.21+ | Spigot shouldn’t be supported |
\n| **Java** | 21+ | |
\n| **PacketEvents** | latest | *optional* \u2014 client cooldown bar |
\n| **PlaceholderAPI** | 2.11+ | *optional* \u2014 placeholders in messages |<\/p>\n

## Documentation<\/p>\n

Full configuration reference lives on the **Wiki**:<\/p>\n

– Items Configuration \u2192 every option, explained
\n– Sources & Triggers \u2192 all 13 sources, all 8 triggers
\n– Enchantments & Potions \u2192 level and duration caps
\n– Database Setup \u2192 MySQL \/ SQLite
\n– Messages \u2192 MiniMessage, placeholders, notifications<\/p>\n","protected":false},"excerpt":{"rendered":"

Limit how many items players can have, craft, gain from loot, plus set cooldowns on usage<\/p>\n","protected":false},"featured_media":87016,"template":"","meta":{"_minecraft_slug":"itemlimiter_smp","_minecraft_project_id":"WToVS6jo","_minecraft_author":"Haskins","_minecraft_license":"MIT","_minecraft_downloads":16,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemlimiter_smp.zip","_minecraft_size_bytes":148424,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:45:40.422887Z","_minecraft_date_created":"2026-04-29T03:20:58.367060Z","_minecraft_date_modified":"2026-04-23T18:49:29.386270Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemlimiter_smp","_minecraft_icon_attachment_id":87016,"_minecraft_imported_at":"2026-06-04T23:19:12+00:00","_minecraft_import_hash":"93736840eb5dfa0ead131e63347f315b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,127,128,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-87015","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","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":"\nItemLimiter - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ItemLimiter - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Limit how many items players can have, craft, gain from loot, plus set cooldowns on usage\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/raw.githubusercontent.com\/PanHaskins\/ItemLimiter\/refs\/heads\/master\/docs\/images\/limited-cooldown.gif\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/\",\"name\":\"ItemLimiter - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/itemlimiter_smp-icon-731cc8310d37c8e66df23250242b9e1b8d318b0e.png\",\"datePublished\":\"2026-06-04T23:19:10+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/itemlimiter_smp-icon-731cc8310d37c8e66df23250242b9e1b8d318b0e.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/itemlimiter_smp-icon-731cc8310d37c8e66df23250242b9e1b8d318b0e.png\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/itemlimiter_smp\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ItemLimiter\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ItemLimiter - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/","og_locale":"en_US","og_type":"article","og_title":"ItemLimiter - Minecraft","og_description":"Limit how many items players can have, craft, gain from loot, plus set cooldowns on usage","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/raw.githubusercontent.com\/PanHaskins\/ItemLimiter\/refs\/heads\/master\/docs\/images\/limited-cooldown.gif","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/","name":"ItemLimiter - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/itemlimiter_smp-icon-731cc8310d37c8e66df23250242b9e1b8d318b0e.png","datePublished":"2026-06-04T23:19:10+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/itemlimiter_smp-icon-731cc8310d37c8e66df23250242b9e1b8d318b0e.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/itemlimiter_smp-icon-731cc8310d37c8e66df23250242b9e1b8d318b0e.png","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/itemlimiter_smp\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"ItemLimiter"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/87015","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/87016"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=87015"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=87015"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=87015"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=87015"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}