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

Game Mechanics, Utility

Report ItemBlocker?

R

2.4.0

Added

  • Item filters: block one specific item by text in its name or lore, custom model data, plugin data (such as nexo:id=ruby_sword) or an enchantment, with /ib filter add <id> hand or the criteria as options. /ib filter list, /ib filter remove and the matching filters in /ib show hand. Needs itemblocker.filter.
  • Option values in double quotes may contain spaces.
  • Item groups: /ib group add *_sword blocks every item type matching a wildcard or an item tag such as #swords. Needs itemblocker.group.
  • Allowed items: /ib allow add wooden_sword keeps an item type out of a preset's item rules and groups. Needs itemblocker.allow.
  • Exceptions: bypass:<permission> on block, edit, filter add and group add lets players with that permission ignore just that rule, and itemblocker.bypass.preset.<name> ignores a whole preset.
  • Scanning: /ib scan players|containers reports forbidden items already in inventories, ender chests and containers; add remove or confiscate to take them away, and get confiscated items back with /ib confiscated take <owner>. Needs itemblocker.scan.
  • Logs: every blocked action is written to logs/<date>.log, /ib log [player] shows the most recent ones, and log.discord.webhook in config.yml sends alerts to Discord. Needs itemblocker.log.
  • API for other plugins: ItemBlockerApi.get() checks rules and adds temporary rules for everyone or one player, and ItemBlockedEvent can be cancelled to let a blocked action through. Available through JitPack as com.github.kuqk:ItemBlocker.

Changed

  • The ItemBlocker in the message prefix is purple. Language files with an earlier default prefix are updated automatically.

Compatibility

  • Java 17+
  • Folia, Paper, Purpur and Spigot
  • Minecraft 1.20 to 26.3
  • Optional: WorldGuard 7.0.9+, PlaceholderAPI 2.11.6+

Information

Published
November 2, 2026
Author
0Downloads

Platforms

Paper
Paper
1.20–26.3