Keybinds Expanded

Bind anything to anything. Put several actions on one key, use key combos and sequences, build small macros with conditions and loops, and switch whole sets of binds per server.

Client-side only. Works in singleplayer and on any server.

A note on servers. Macros that press several things for you are against the rules on many servers, especially PvP and minigame servers. The mod lets you do it, but using macros there is not recommended. Check the server rules first.

What it does

One key, many actions

Each bind runs a list of actions from top to bottom:

• press any key binding: vanilla or from other mods (click, hold for N ticks, press and release, toggle)
• select a hotbar slot
• select an item by id (ender_pearl, *_sword), pulling it from your inventory into the hotbar if needed
• go back to the slot you started on
• wait N ticks, or wait until something is true (on ground, not using an item...)
• send a chat message or a command, with placeholders like {x} {y} {z} {biome} {held_item}
• show a short message on the HUD
• switch profile

Example: press R to pick your ender pearl, throw it, and go back to the sword.

Logic

• If / Else / End with conditions: holding an item, offhand item, has item, health below, hunger below, dimension, sneaking, sprinting, on ground, in water, using an item, gliding, a key held, a menu open. Any condition can be negated.
• Repeat / End: a set number of times, or while the key is held, with an optional clicks-per-second pace.
• Stop ends the macro early.

Triggers

• Single keys, mouse buttons (side buttons too) and the scroll wheel
• Combos: Shift + 1, Ctrl + E, Alt + Mouse 4. The most specific combo wins, so R and Shift + R can do different things.
• Sequences: press G, then H
• Modes: on press, on release, double tap, long press, while held (loops until released), toggle (first press starts, second stops)
• Optional: hide the key from vanilla, work inside inventories and chests, stop on damage, stop when another key is pressed

Profiles

• Separate sets of binds, for example "PvP" and "Building"
• Switch with a key, from a macro, or automatically by server address, singleplayer world or dimension
• Export a profile to the clipboard as JSON and import it on another PC or share it

Radial menu

Hold the radial key, point at a bind, let go. Any bind can be shown there, and binds without a key can live only in the radial menu.

Better Controls screen

The vanilla Key Binds screen gets a search box, a "Conflicts only" filter and categories you can collapse by clicking their title.

HUD

• Active profile (when you have more than one)
• Running toggles and held loops
• Short messages when a bind fires (optional)
• A cheat sheet with all your binds while you hold its key

Getting started

1. Press K to open Keybind Expanded.
2. Press Add, give the bind a name and click Trigger, then press the key or combo.
3. Press Add action and pick what it should do.
4. Save.

The first launch adds three example binds, all turned off: quick pearl, share coords and toggle sneak.

Keys for the radial menu, cheat sheet, next profile and "stop all macros" are not bound by default. Set them in Options > Controls > Key Binds > Keybind Expanded.

Compatibility

• Fabric, Minecraft 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2 and 26.3 (download the file for your version)
• Requires Fabric API
• Works with key bindings added by other mods

Config: config/keybind-expanded.json.