Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for kuqk

Game Mechanics, Utility

Report ItemBlocker?

R

2.0.0

ItemBlocker 2.0 is a rewrite. Your 1.x files are converted automatically on the first start; see Upgrading below.

Added

  • Hex colors (&#rrggbb) in messages.
  • Custom languages: add lang/<code>.yml and set language: <code>.
  • /ib show lists every preset that blocks an item, enchantment or potion effect.
  • Placing boats on water, minecarts, armor stands, item frames, paintings and end crystals is covered by the place action, using the server's placement events instead of guessing from item names.
  • Emptying a bucket is covered by the place action.
  • Hoppers picking up item entities are covered by the hopper action.
  • Anvils no longer produce items with blocked enchantments.

Changed

  • All rules live in rules.yml. The 1.x default section is now the default preset, which works like any other preset.
  • Messages live in lang/<language>.yml and are fully translated in English, Polish, German, Spanish, French and Italian. Missing entries fall back to the bundled text.
  • Items are written as lowercase keys such as diamond_sword, with or without minecraft:.
  • /ib block adds the given actions and worlds to an existing rule and /ib edit replaces only the given parts.
  • An enchanting table roll that includes a blocked enchantment alongside an allowed one now only loses the blocked enchantment instead of being cancelled.
  • The bypass permission names are fixed; bypass.default-permission and bypass.per-action.prefix were removed from config.yml.
  • Built with Gradle. The plugin compiles against the Spigot API, and Paper-only features live in a separate source set that is only loaded on Paper and its forks.

Fixed

  • Using a blocked item while clicking air, such as throwing an ender pearl, was not blocked, because Bukkit reports those clicks as already cancelled.
  • Holding a blocked item no longer stops players from opening doors, chests and other blocks.
  • Taking off blocked armor moves the item instead of rebuilding it, so it cannot duplicate items.
  • A rules.yml with a YAML error no longer leaves the server without rules: the previous rules stay active and changes are refused until it is fixed.
  • Saving rules.yml is atomic, so a crash during a save cannot leave a half written file.

Upgrading from 1.x

  • blocked-items.yml and presets.yml are converted to rules.yml, including the older formats 1.x still read.
  • The language, message cooldown and bypass settings move to the new config.yml.
  • Every old file, including the languages folder, is moved to backup-1.x. Custom message texts are not converted.
  • Permissions are unchanged; itemblocker.admin was added to grant every command at once.
  • Most commands keep their names. /ib show <preset> and /ib list presets are now /ib preset show <preset> and /ib preset list, and enchantment and potion levels are written as level:5.

Compatibility

  • Java 21+ (Minecraft 26.x servers require Java 25)
  • Folia, Paper, Purpur and Spigot
  • Minecraft 1.21 to 26.3

Information

Published
October 30, 2026
Author
1Downloads

Platforms

Paper
Paper
1.21–26.3