![\"Paper\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/compact\/supported\/paper_vector.svg\")
\n
![\"Purpur\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/compact\/supported\/purpur_vector.svg\")
\n
![\"Spigot\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/compact\/supported\/spigot_vector.svg\")
\n
![\"GitHub\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/compact\/available\/github_vector.svg\")
\n
![\"Modrinth\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/compact\/available\/modrinth_vector.svg\")
\n
![\"Hangar\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/compact\/available\/hangar_vector.svg\")
\n<\/p>\n# \ud83d\udee1\ufe0f ItemBlocker<\/p>\n
\n
\n
\n
\n
\n
\n \n<\/p>\n
\n Clean, detailed, and flexible item restrictions for modern Minecraft servers.<\/strong> ## \u2728 What Is ItemBlocker?<\/p>\n ItemBlocker is a plugin for server owners who want strong control over items without turning configuration into chaos.<\/p>\n It is built around a simple idea: keep one clear `default` section for global restrictions, then add `presets` for survival, events, minigames, worlds, or special modes when you need more specific rules.<\/p>\n That means you can do things like:<\/p>\n – block TNT everywhere on the server ## \ud83e\udde0 How ItemBlocker Works<\/p>\n ItemBlocker is split into a few clean layers:<\/p>\n – \ud83c\udf0d `default` is your always-available global section In practice, that means you are not limited to “item yes or no”. You can decide:<\/p>\n – what is blocked ## \ud83c\udf0d Default Section<\/p>\n The `default` section lives in `blocked-items.yml` and acts as the global base for the whole server.<\/p>\n Use it when a restriction should always exist unless you intentionally manage something differently with presets.<\/p>\n Inside `default`, you can configure:<\/p>\n – \ud83d\udcac one global `reason` This is the best place for things like:<\/p>\n – admin-only items ## \ud83d\uddc2\ufe0f Presets<\/p>\n Presets live in `presets.yml` and are the main tool for grouped restrictions.<\/p>\n Each preset can have its own:<\/p>\n – \ud83d\udcdd `description` ### \ud83d\udccc Important preset behavior<\/p>\n – A preset can be active only in selected worlds. ## \ud83c\udf10 Worlds And Targeting<\/p>\n ItemBlocker lets you decide where rules apply in two places:<\/p>\n – \ud83c\udf0d on the preset itself ### `worlds: all`<\/p>\n This means the rule works in every world.<\/p>\n ### `worlds: world,world_nether`<\/p>\n This means the rule is only active in those listed worlds.<\/p>\n ### `in:default` and `in: This decides which target you are editing or showing with commands.<\/p>\n Examples:<\/p>\n “`text ## \ud83d\udce6 Item Rules<\/p>\n Item rules are the core of the plugin.<\/p>\n Every item rule answers two questions:<\/p>\n 1. Which actions should be blocked? Each item can have one rule per target, and that rule can contain:<\/p>\n – \u2699\ufe0f `actions` You can target an item directly by material name or use `hand` to use the item from the player’s main hand.<\/p>\n Examples:<\/p>\n “`text ## \u2694\ufe0f Item Actions<\/p>\n ItemBlocker supports the following actions:<\/p>\n – \ud83d\udee0\ufe0f `crafting` – blocks getting the result of a crafting recipe ### \ud83d\udee0\ufe0f `crafting`<\/p>\n Use this when players should be able to own an item in some other way, but should not be allowed to craft it.<\/p>\n ### \ud83d\udce5 `pickup`<\/p>\n Use this when players should not be able to pick an item up from the ground at all.<\/p>\n ### \ud83d\udce4 `drop`<\/p>\n Use this when players should keep the item out of circulation and not throw it around.<\/p>\n ### \ud83d\uddb1\ufe0f `use`<\/p>\n Use this when the item should exist, but should not be usable in normal right-click behavior.<\/p>\n ### \ud83e\uddf1 `place`<\/p>\n Use this when an item should not be placed into the world.<\/p>\n This also covers special placement-style items, not only plain blocks. That makes it useful for things like:<\/p>\n – boats ### \ud83e\ude96 `armor`<\/p>\n Use this when wearable items should not be equipped.<\/p>\n ItemBlocker also enforces armor restrictions when needed, so blocked armor is not only stopped on click but can also be removed from equipped slots when players join or change worlds.<\/p>\n ### \ud83c\udf92 `inventory`<\/p>\n Use this when restricted items should not be moved through GUI inventories and containers.<\/p>\n This helps with:<\/p>\n – chest movement ### \ud83d\udd04 `hopper`<\/p>\n Use this when you want to stop automation from moving the item.<\/p>\n That makes hopper-based bypasses much harder.<\/p>\n ## \ud83d\udd28 Smithing Restrictions<\/p>\n `smithing` is a normal item action in ItemBlocker, not a separate weird subsystem.<\/p>\n That means you can block smithing results the same way you block any other action:<\/p>\n “`text ### What this is good for<\/p>\n – \u26cf\ufe0f blocking netherite upgrades ### Why it is useful<\/p>\n You may want players to:<\/p>\n – own a diamond chestplate That is exactly what `actions:smithing` is for.<\/p>\n ## \u2728 Enchantment Restrictions<\/p>\n Enchantment rules let you block enchants by minimum level.<\/p>\n Example:<\/p>\n “`text ### How enchantment rules work<\/p>\n – \u2728 `sharpness: 2` means Sharpness II and higher are blocked ### What ItemBlocker checks<\/p>\n Enchantment restrictions are used in two important ways:<\/p>\n – \ud83e\ude84 they can block enchanting-table offers and enchanting results That second part is especially useful, because it means the plugin does not only stop future enchanting. It also reacts when players try to use or move items that already carry blocked enchants.<\/p>\n Stored enchantments are also checked, so enchanted books are covered too.<\/p>\n ### Good examples<\/p>\n – block `mending` on a hardcore preset ## \ud83e\uddea Potion Effect Restrictions<\/p>\n Potion rules work similarly to enchantment rules: they use a minimum level.<\/p>\n Example:<\/p>\n “`text ### How potion rules work<\/p>\n – \ud83e\uddea `strength: 2` means Strength II and higher are blocked ### What ItemBlocker actually blocks<\/p>\n Potion rules target the effect itself.<\/p>\n That means ItemBlocker can stop:<\/p>\n – potion effects being applied to a player ### Important note<\/p>\n Potion-effect restrictions are not the same thing as item restrictions.<\/p>\n If you block `strength: 2`, the plugin blocks the Strength II effect itself. If you also want to block the potion item from being used, picked up, or moved, you should combine that with normal item rules.<\/p>\n ## \ud83d\udcac Reasons, Source Info, And Player Feedback<\/p>\n Each target can define a `reason`, and that reason is used in the block message shown to players.<\/p>\n This makes the plugin feel much cleaner in real use, because players do not only see “blocked”. They can also understand why.<\/p>\n Examples:<\/p>\n – `”&cThis item is blocked globally by the server team.”` ItemBlocker can also show the source of the restriction, so players or staff can understand whether the block came from:<\/p>\n – `default` There is also a message cooldown in `config.yml`, which helps avoid chat spam when players keep trying the same blocked action.<\/p>\n ## \ud83e\uddf0 Command Flow<\/p>\n The modern command flow is built around a small set of clear commands:<\/p>\n – \ud83d\udfe2 `\/ib block` – create a rule or merge into an existing one Aliases:<\/p>\n – `\/ib` ### \ud83d\udccc Default command behavior<\/p>\n – If you create a new item rule and do not provide `actions:`, it defaults to `all`. ## \ud83e\uddea Command Examples<\/p>\n ### \ud83d\udce6 Item examples<\/p>\n “`text ### \u2728 Enchantment examples<\/p>\n “`text ### \ud83e\uddea Potion examples<\/p>\n “`text ### \ud83d\uddc2\ufe0f Preset examples<\/p>\n “`text ## \u2699\ufe0f Configuration Files<\/p>\n ItemBlocker uses three main files:<\/p>\n – `config.yml` ### \u2699\ufe0f `config.yml`<\/p>\n This file controls general plugin behavior.<\/p>\n What you can set here:<\/p>\n – \ud83c\udf10 plugin language Supported built-in languages:<\/p>\n – `en` ### \ud83c\udf0d `blocked-items.yml`<\/p>\n This file contains the global `default` section.<\/p>\n What you can set here:<\/p>\n – \ud83d\udcac default reason Example:<\/p>\n “`yml enchantments: potions: items: BEDROCK: NETHERITE_SWORD: ### \ud83d\uddc2\ufe0f `presets.yml`<\/p>\n This file contains grouped restrictions.<\/p>\n What you can set here for each preset:<\/p>\n – \ud83d\udcdd description Example:<\/p>\n “`yml enchantments: potions: items: ELYTRA: NETHERITE_PICKAXE: ## \ud83d\udd10 Permissions<\/p>\n ItemBlocker includes both management permissions and bypass permissions.<\/p>\n ### \ud83e\uddf0 Management permissions<\/p>\n “`text ### \ud83d\udeaa Global bypass<\/p>\n “`text This bypasses every ItemBlocker restriction.<\/p>\n ### \ud83e\udde9 Per-action bypass permissions<\/p>\n “`text This is useful when you want staff or special ranks to ignore only selected checks instead of the whole plugin.<\/p>\n ## \ud83d\ude80 Quick Start<\/p>\n 1. Put the jar into `plugins\/`. ## \ud83d\udce5 Download<\/p>\n – Modrinth: https:\/\/modrinth.com\/plugin\/itemblocker ## \u2705 Compatibility<\/p>\n – \u2615 Java 21+ ## \ud83d\udcdc License<\/p>\n GPL-3.0<\/p>\n","protected":false},"excerpt":{"rendered":" Block items, smithing, enchantments, potion effects, inventory movement, hopper movement, and more.<\/p>\n","protected":false},"featured_media":86920,"template":"","meta":{"_minecraft_slug":"itemblocker","_minecraft_project_id":"klHgtaeR","_minecraft_author":"kuqk","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":508,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemblocker.zip","_minecraft_size_bytes":455378,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T10:31:42.024100Z","_minecraft_date_created":"2025-12-18T00:19:47.798122Z","_minecraft_date_modified":"2026-04-05T16:11:17.580543Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemblocker","_minecraft_icon_attachment_id":86920,"_minecraft_imported_at":"2026-06-04T23:10:17+00:00","_minecraft_import_hash":"2f2044972e2b803bac9ec6ab005461c4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,127,128,129,92],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83],"class_list":["post-86919","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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"],"yoast_head":"\n
\n
\n Block items, smithing results, enchantments, potion effects, inventory movement, hopper movement, and more on Minecraft 1.21.x, 26.1.\n<\/p>\n
\n– block Elytra only in one preset
\n– block Smithing results like netherite tools
\n– block specific enchantments from a chosen level
\n– block potion effects instead of blocking every single potion item manually
\n– stop restricted items from being moved through inventories or hoppers<\/p>\n
\n– \ud83d\uddc2\ufe0f `presets` let you create separate groups of rules
\n– \ud83d\udce6 `items` let you block specific materials and actions
\n– \u2728 `enchantments` let you block enchants from a chosen minimum level
\n– \ud83e\uddea `potions` let you block potion effects from a chosen minimum level
\n– \ud83d\udcac `reason` lets you define the message players should understand<\/p>\n
\n– where it is blocked
\n– how it is blocked
\n– why the player sees that restriction<\/p>\n
\n– \u2728 blocked `enchantments`
\n– \ud83e\uddea blocked `potions`
\n– \ud83d\udce6 blocked `items`<\/p>\n
\n– dangerous survival shortcuts
\n– overpowered enchants
\n– potion effects you never want players to keep<\/p>\n
\n– \ud83d\udcac `reason`
\n– \ud83c\udf0d preset `worlds`
\n– \u2728 enchantment rules
\n– \ud83e\uddea potion rules
\n– \ud83d\udce6 item rules<\/p>\n
\n– An item inside that preset can also have its own `worlds` filter.
\n– If you want the same item to behave differently in different places, use different presets instead of trying to overload one rule.<\/p>\n
\n– \ud83d\udce6 on the individual item rule<\/p>\n
\n\/ib block TNT in:default
\n\/ib block ELYTRA in:survival
\n\/ib show TNT in:default
\n\/ib show potion strength in:survival
\n“`<\/p>\n
\n2. In which worlds should that rule work?<\/p>\n
\n– \ud83c\udf0d `worlds`<\/p>\n
\n\/ib block TNT
\n\/ib block hand actions:use,drop in:survival
\n\/ib edit ELYTRA worlds:world
\n\/ib unblock BEDROCK in:default
\n“`<\/p>\n
\n– \ud83d\udce5 `pickup` – blocks picking the item up from the ground
\n– \ud83d\udce4 `drop` – blocks throwing the item out of inventory
\n– \ud83d\uddb1\ufe0f `use` – blocks normal use of the item
\n– \ud83e\uddf1 `place` – blocks placing blocks and special placeable items
\n– \ud83e\ude96 `armor` – blocks equipping wearable items
\n– \ud83c\udf92 `inventory` – blocks moving restricted items through inventories and containers
\n– \ud83d\udd04 `hopper` – blocks moving restricted items with hoppers
\n– \ud83d\udd28 `smithing` – blocks smithing-table results for that item<\/p>\n
\n– rafts
\n– minecarts
\n– item frames<\/p>\n
\n– shift-click transfers
\n– drag operations
\n– number-key swaps
\n– offhand swaps into inventory UIs
\n– double-click collection behavior<\/p>\n
\n\/ib block NETHERITE_SWORD actions:smithing
\n\/ib block DIAMOND_CHESTPLATE actions:smithing in:survival
\n“`<\/p>\n
\n– \ud83d\udee1\ufe0f blocking armor trim results
\n– \ud83e\uddf0 blocking specific final smithing products without blocking the entire base item<\/p>\n
\n– move it normally
\n– use it normally
\n– but still not create the smithing-table result<\/p>\n
\n\/ib block enchantment sharpness level:2
\n\/ib block enchantment mending level:1 in:survival
\n“`<\/p>\n
\n– \u2728 `mending: 1` means any Mending is blocked
\n– \u2728 rules can live in `default` or inside a preset<\/p>\n
\n– \ud83d\udce6 they can also block items that already contain a blocked enchantment<\/p>\n
\n– allow `sharpness 1` but block `sharpness 2+`
\n– disable `infinity` only in survival worlds<\/p>\n
\n\/ib block potion strength level:2
\n\/ib block potion speed level:2 in:survival
\n“`<\/p>\n
\n– \ud83e\uddea `speed: 2` means Speed II and higher are blocked
\n– \ud83e\uddea rules can be global or preset-based<\/p>\n
\n– blocked effects remaining active when a player joins
\n– blocked effects remaining active when a player changes worlds<\/p>\n
\n– `”&cThis item is disabled on survival worlds.”`<\/p>\n
\n– a specific preset<\/p>\n
\n– \ud83d\udfe1 `\/ib edit` – change only the parts you provide
\n– \ud83d\udd34 `\/ib unblock` – remove a rule
\n– \ud83d\udd0d `\/ib show` – inspect one item, preset, enchantment, or potion rule
\n– \ud83d\udccb `\/ib list` – list configured items, presets, enchantments, potions, or a target
\n– \ud83d\uddc2\ufe0f `\/ib preset` – manage presets
\n– \ud83d\udd04 `\/ib reload` – reload plugin files<\/p>\n
\n– `\/blocker`<\/p>\n
\n– If you create a new item rule and do not provide `worlds:`, it defaults to `all`.
\n– If you do not provide `in:`, the target is `default`.
\n– `block` merges into an existing rule instead of blindly replacing it.
\n– `edit` requires the rule to already exist and only replaces the fields you pass.
\n– Enchantment and potion rules default to level `1` if you do not provide a higher level.<\/p>\n
\n\/ib block TNT
\n\/ib block hand actions:use,drop in:survival
\n\/ib block DIAMOND_CHESTPLATE actions:smithing
\n\/ib edit TNT worlds:world_nether
\n\/ib edit ELYTRA actions:use,inventory in:survival
\n\/ib unblock COMMAND_BLOCK in:event
\n\/ib show TNT
\n\/ib show TNT in:default
\n\/ib list items
\n\/ib list items in:survival
\n“`<\/p>\n
\n\/ib block enchantment sharpness level:2
\n\/ib block enchantment mending level:1 in:survival
\n\/ib unblock enchantment mending in:survival
\n\/ib show enchantment sharpness
\n\/ib show enchantment infinity in:survival
\n\/ib list enchantments
\n\/ib list enchantments in:survival
\n“`<\/p>\n
\n\/ib block potion strength level:2
\n\/ib block potion speed level:2 in:survival
\n\/ib unblock potion strength in:default
\n\/ib show potion speed
\n\/ib show potion speed in:survival
\n\/ib list potions
\n\/ib list potions in:survival
\n“`<\/p>\n
\n\/ib preset list
\n\/ib preset create survival
\n\/ib preset show survival
\n\/ib preset edit survival description Main survival restrictions
\n\/ib preset edit survival reason &cThis item is disabled on survival worlds.
\n\/ib preset edit survival worlds world,world_nether
\n\/ib preset delete event
\n“`<\/p>\n
\n– `blocked-items.yml`
\n– `presets.yml`<\/p>\n
\n– \ud83d\udcac message cooldown
\n– \ud83d\udd10 whether bypass permissions are enabled
\n– \ud83d\udd11 the global bypass permission node
\n– \ud83e\udde9 whether per-action bypass permissions are enabled
\n– \ud83c\udff7\ufe0f the permission prefix for per-action bypasses<\/p>\n
\n– `pl`
\n– `de`
\n– `es`
\n– `fr`
\n– `it`<\/p>\n
\n– \u2728 global enchantment thresholds
\n– \ud83e\uddea global potion thresholds
\n– \ud83d\udce6 global item rules<\/p>\n
\ndefault:
\n reason: “&cThis item is blocked globally by the server team.”<\/p>\n
\n sharpness: 2
\n mending: 1<\/p>\n
\n strength: 2<\/p>\n
\n TNT:
\n actions: all
\n worlds: all<\/p>\n
\n actions: all
\n worlds: all<\/p>\n
\n actions:
\n – smithing
\n worlds: all
\n“`<\/p>\n
\n– \ud83d\udcac reason
\n– \ud83c\udf0d preset worlds
\n– \u2728 enchantment thresholds
\n– \ud83e\uddea potion thresholds
\n– \ud83d\udce6 item rules<\/p>\n
\npresets:
\n survival:
\n description: “Main survival restrictions.”
\n reason: “&cThis item is disabled on survival worlds.”
\n worlds:
\n – world
\n – world_nether<\/p>\n
\n infinity: 1<\/p>\n
\n speed: 2<\/p>\n
\n COMMAND_BLOCK:
\n actions: all
\n worlds: all<\/p>\n
\n actions:
\n – use
\n – inventory
\n worlds: all<\/p>\n
\n actions:
\n – smithing
\n worlds: all
\n“`<\/p>\n
\nitemblocker.*
\nitemblocker.use
\nitemblocker.add
\nitemblocker.remove
\nitemblocker.edit
\nitemblocker.list
\nitemblocker.reload
\nitemblocker.info
\nitemblocker.preset
\nitemblocker.enchantment
\nitemblocker.potion
\n“`<\/p>\n
\nitemblocker.bypass
\n“`<\/p>\n
\nitemblocker.bypass.crafting
\nitemblocker.bypass.pickup
\nitemblocker.bypass.drop
\nitemblocker.bypass.use
\nitemblocker.bypass.place
\nitemblocker.bypass.armor
\nitemblocker.bypass.inventory
\nitemblocker.bypass.hopper
\nitemblocker.bypass.smithing
\nitemblocker.bypass.enchantment
\nitemblocker.bypass.potion
\n“`<\/p>\n
\n2. Start the server once.
\n3. Open `config.yml` and choose your language and bypass setup.
\n4. Add global restrictions in `blocked-items.yml`.
\n5. Create grouped restrictions in `presets.yml` if needed.
\n6. Run `\/ib reload`.
\n7. Test your blocked items, enchantments, potion effects, and presets in game.<\/p>\n
\n– Hangar: https:\/\/hangar.papermc.io\/kuqk\/ItemBlocker
\n– Spigot: https:\/\/www.spigotmc.org\/resources\/itemblocker.131418\/
\n– GitHub: https:\/\/github.com\/kuqk\/ItemBlocker<\/p>\n
\n– \ud83e\udde9 Folia, Paper, Purpur, and Spigot
\n– \ud83c\udfae Minecraft `1.21.x` `26.1`<\/p>\n