Keybindery

Minecraft 版本： 1.21.11

平台： fabric

标签： library utility

Keybindery

Bind multi-key chord shortcuts to any keybind in the game, jump straight to a mod's keybinds from inside that mod's config screen, and search/sort/filter the controls screen.

Three features in one client-side mod.

Multi-key chord keybinds

Hold any combination of keys — Ctrl + Shift + K, X + Z, even mouse buttons — and release to bind. Works on every keybind in the game: vanilla, modded, anything.

Single-key bindings still work exactly as before. Chords are opt-in per binding.

Auto-listed mod keybinds

No more hunting through the Key Binds menu to find a specific mod's keybindings.

• Mods using YACL get a native "Keybinds" tab added to their config screen automatically.
• Other mods' configs get a small "Keybinds" button in the top-right corner — one click opens the controls screen pre-filtered to that mod's bindings.

Mod Menu is recommended (it's how Keybindery discovers which keybinds belong to which mod), but the YACL tab works without it.

Controls screen overhaul

The Key Binds menu gets a toolbar:

• Search keybinds — type a name to narrow the list
• Search Keybind — click and press any chord; the list shows everything that shares a key with that chord (instant conflict-finder)
• Sort — by category (default), alphabetical, or by bound key
• Filter — only conflicting binds, only unbound binds, or no filter

Every row also gets two icons:

• ⚠ Conflicts — opens the controls screen pre-filtered to every keybind this one conflicts with
• ↻ Reset — restores the keybind's default

Long keybind names auto-scroll instead of getting cut off.

The "MISC" category that vanilla dumps every uncategorized mod keybind into is automatically broken up by mod, so you see "Inventory Plus / Shulker Palette / [other mod]" instead of one giant unsorted MISC.

Requirements

• Fabric Loader 0.15 or newer
• Fabric API
• YACL (Yet Another Config Lib) — bundled inside Keybindery via JIJ, no separate install needed
• Mod Menu — strongly recommended for auto-listed mod keybinds

Installing

Drop the jar in your mods/ folder along with Fabric API. Keybindery is client-side only — installing it on a server has no effect.

Compatibility

• Vanilla single-key bindings are fully respected. Mods that don't opt into chords behave unchanged.
• Compatible with the popular Fabric input mods (Controlify, MidnightControls, etc.) — Keybindery uses precise mixin injection at narrow hook points, no @Overwrite.
• Chord bindings serialize alongside vanilla's options.txt. Uninstall later and everything reverts to single-key behavior cleanly.

For mod developers

Keybindery ships a small API (bundled inside the main jar) you can use from your own mod. See the README on GitHub for the API surface.

Credits

Inspired by the design choices in Amecs, Controlling, and the broader Fabric input-mod ecosystem.