Getting Started
Install
Section titled “Install”Install through Foundry’s module manager by searching for Macro Keybinds, or paste this manifest URL into the Install Module dialog:
https://github.com/Sayshal/macro-keybinds/releases/latest/download/module.jsonEnable the module in Manage Modules for your world.
Bind a macro to a key
Section titled “Bind a macro to a key”Each user manages their own keybinds. The bindings a player creates are stored against their Foundry user account, not against the macro.
- Open a macro’s configuration window. Click the macro on the hotbar, or right-click and pick Edit Macro.
- Find the Keybind field below the macro type selector.
- Click into the field and press the key combination you want. Modifier keys combine with a non-modifier key.
- Reload the world for the new binding to take effect. Foundry registers keybindings at startup.
The field shows the combination in a readable form. To clear a binding, focus the field and press Delete or Backspace.
New macros and existing macros
Section titled “New macros and existing macros”For an existing macro, the binding saves as soon as you press the combination. The field reports “Keybind saved. Reload page to apply changes.”
For a new macro you are still authoring, the binding stays pending until you click Save Macro. The field shows “Keybind will be applied when macro is saved” while pending. The pending binding expires if you do not save.
Disable the default hotbar number keys
Section titled “Disable the default hotbar number keys”Foundry maps the number keys to your macro hotbar slots. To free those keys for your own bindings, enable Disable Default Hotbar Numbers in module settings. The setting requires a reload.
Where to go next
Section titled “Where to go next”- Settings covers the client setting and how user keybinds are stored.
- Troubleshooting covers reload requirements, conflicts, renames, and syncing with Foundry’s Controls Configuration window.