Keybind Priority

Held-item conditions

Every binding has an Item button. A binding can react only with a matching held item, or be
preferred (moved to the top) while you hold one.
Filters take item IDs (minecraft:diamond_pickaxe), tags (#minecraft:pickaxes), whole mods
(@mekanism), * wildcards, comma-separated alternatives and ! exclusions.
The editor suggests items, tags and mods as you type and shows live whether the held item matches.

Clearer menu

Each row shows its state: active, backup, off, needs item or preferred.
The item button shows an icon of the item the condition matches.
The editor explains the chosen mode and warns when a preference can't take effect in "all bindings" mode.

Short guide

The first time you open the menu, a five-page guide explains how it works. The ? button brings it back.

Existing configs keep their rankings. Supports Minecraft 1.21 through 1.21.11 on NeoForge, tested on 23 NeoForge versions. Client only.

Download keybind-priority-neoforge-0.4.0.jar and place it in the mods folder.