Command Macro Key
by HuNao
Command Macro Key binds keyboard shortcuts to chat commands or sequences of commands, so a player can run a routine command with one press.
What it does
A macro is defined in a JSON file and tied to a key. Each macro has a command or several commands, sent to the chat field as if typed. Commands can be separated with a newline character to run several in order, which lets a single key replay a routine such as setting a gamemode and then a time of day. Three macro types cover the common cases: a single command that runs once, a delayed command that waits a set number of ticks before running, and a repeating command that runs at a chosen interval for a set count.
Placeholders insert live values into a command when the key is pressed. The supported placeholders include the player name, position coordinates, health, food, experience and level, dimension, biome, facing direction, rotation angles and UUID. The macro reload command reapplies the macro file without restarting the game. Macros are stored in the client config, and a separate macros-server.json5 file holds the options that the server enforces. Installation needs Forge for 1.20.1, with files released under the MIT License as open source.
Key features
Keybound macros
Each macro is assigned a primary key and an optional modifier key, so one press runs a stored command.
Multi-command sequences
Newline separators let a single macro run several commands one after another.
Delayed and repeating macros
Macros can wait a set number of ticks before running, or repeat a command at a set interval for a set number of times.
Placeholder values
Placeholders such as the player name, position, health and biome are replaced with current values when the macro runs.
Reload without restart
The macro reload command reads the macro file again, so changes apply during play.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Players who run the same chat commands often, and server owners who want to control which macro options apply on their server.
How it compares
Syd's Simple Commands is a Forge mod for 1.20.1 that works on client or server, and it is not open source under All rights reserved. KeyBindCommand is a Forge client-side only mod for 1.20.1 under All rights reserved, so only the player's client needs it. Magma Macro covers Fabric, Forge and NeoForge for 1.21 – 1.21.8 as a client-side only mod, and it is not open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Command Macro Key | Forge | 1.20.1 | Client and server | 2024-06-11 |
| Syd's Simple Commands | Forge | 1.20.1 | Client or server, optional | 2024-07-29 |
| KeyBindCommand | Forge | 1.20.1 | Client-side only | 2025-09-22 |
| Magma Macro | Fabric, Forge and NeoForge | 1.21 – 1.21.8 | Client-side only | 2025-12-11 |
Questions
Does Command Macro Key need to be installed on the server?
Which loader and game version does Command Macro Key support?
Can one macro run more than one command?
In the catalog
Command Macro Key is one of 29,952 Game mechanics mods on ModsFinder, and one of 13,316 Game mechanics mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from HuNao
Similar mods
What the author says
Placeholder ~txt player_name player_pos_x player_pos_y player_pos_z player_pos player_health player_food player_exp player_level player_dimension player_biome player_facing player_xRot player_yRot player_uuid ~ ~json [ { "macro":"command_macro_key:single", "command": "/gamemode creative", "primaryKey": 334…
Official listing
- Modrinth page
- modrinth.com/mod/command-macro-key
- Owner
- HuNao
- Published
- 2024-06-06
- Updated on Modrinth
- 2024-06-11
- Facts verified
- 2026-10-15