Admins can prevent ClickSorted from ever touching specific items — they are never sorted, moved, or packed/unpacked regardless of player preferences. Two enforcement channels are unioned and both checked at sort time.
Config channel
Add entries to config.yml under blacklist.materials and blacklist.names. These rules apply to every player server-wide.
materials— a list of Bukkit Material names (case-insensitive, exact match).names— a list of plain-text display names matched case-insensitively against the item's resolved name (custom name →item_namedata component → vanilla name).
Unknown material names are warned and skipped on load/reload.
blacklist:
materials:
- nether_star
- totem_of_undying
names:
- "Creative Menu"
Permission channel
Grant dynamic permission nodes via a permissions plugin (e.g. LuckPerms):
clicksorted.blacklist.material.<material>— e.g.clicksorted.blacklist.material.nether_starclicksorted.blacklist.name.<slug>— e.g.clicksorted.blacklist.name.creative_menu
Name slug rule: strip legacy §X color codes → lowercase (Locale.ROOT) → collapse non-[a-z0-9] runs to _ → strip edge underscores. For example, "Creative Menu" → creative_menu.
Both channels use isPermissionSet before hasPermission so OPs without an explicit grant are unaffected.
This blacklist is admin-only and not exposed to players via any command or GUI. For player-controlled bundle exclusions, see Bundle packing.