Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
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>.ymland setlanguage: <code>. /ib showlists 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
placeaction, using the server's placement events instead of guessing from item names. - Emptying a bucket is covered by the
placeaction. - Hoppers picking up item entities are covered by the
hopperaction. - Anvils no longer produce items with blocked enchantments.
Changed
- All rules live in
rules.yml. The 1.xdefaultsection is now thedefaultpreset, which works like any other preset. - Messages live in
lang/<language>.ymland 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 withoutminecraft:. /ib blockadds the given actions and worlds to an existing rule and/ib editreplaces 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-permissionandbypass.per-action.prefixwere removed fromconfig.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.ymlwith 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.ymlis atomic, so a crash during a save cannot leave a half written file.
Upgrading from 1.x
blocked-items.ymlandpresets.ymlare converted torules.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
languagesfolder, is moved tobackup-1.x. Custom message texts are not converted. - Permissions are unchanged;
itemblocker.adminwas added to grant every command at once. - Most commands keep their names.
/ib show <preset>and/ib list presetsare now/ib preset show <preset>and/ib preset list, and enchantment and potion levels are written aslevel:5.
Compatibility
- Java 21+ (Minecraft 26.x servers require Java 25)
- Folia, Paper, Purpur and Spigot
- Minecraft 1.21 to 26.3
Platforms
Paper
1.21–26.3