KingJayan/keybinds

a fully client-side macro system for minecraft

a fully client-side Fabric mod for Minecraft 26.2: a tick-based macro engine with an in-game editor. every macro pairs a composable trigger with an ordered sequence of tick-scheduled actions. everything runs through vanilla item, inventory, and attack packets, so no server-side mod is required -- works in singleplayer and vanilla multiplayer.

press Right Shift in-game (or the Mod Menu config button) to open the macro editor. macros are saved to config/macros.json when a screen closes

Caution

The use of this mod on some servers may get you banned. Use at your own risk.

macros

each macro can be authored two ways, both backed by the same runtime:

• a visual editor — a searchable action palette with per-action parameter forms, an AND/OR/NOT trigger tree, drag-to-reorder, multi-select, and copy/paste/undo across macros.
• a script in the built-in DSL — one when <trigger> line followed by actions, one per line, with if / else if / else branching on live state. the editor autocompletes triggers, actions, and their arguments.

when holding("minecraft:mace") and mouse(left)
  swap_to_item(items=["minecraft:mace"], rankEnchant="minecraft:density")
  attack
  swap_back

further documentation regarding actions and triggers are available under docs/commands.md

coming features (v2.0.0+)

• actually working attribute swap without injecting attack packets
• recording actions + save/edit as a macro
• recursive macros
• more robust camera/player movement actions
• chat interactions (open chat, type message, submit)
• more of a python-style DSL
• bugfixes

dependencies

• Fabric Loader 0.19.3+
• Fabric API 0.154.0+26.2
• Mod Menu 20.0.0+ (optional)

building

requires JDK 25.

./gradlew build

the jar is written to build/libs/. use ./gradlew runClient to launch a dev client.

license

released under CC0.