Macro/Keybind Mod 1.12.2, Wiki

The Macro/Keybind Mod is a versatile client-side modification for Minecraft that empowers players to automate various in-game actions by binding commands, chat messages, and intricate scripts to their keyboard keys. It provides a user-friendly graphical interface for managing keybinds and macros, eliminating the need for manual configuration file editing. The mod supports a wide range of functionalities, from simple command execution to complex, multi-step automation, and can adapt its configurations based on the server being played on.

The mod offers an intuitive in-game graphical user interface (GUI) for creating, editing, and managing keybinds. To access the keybinding menu, players typically press a designated key, which defaults to the grave accent () key (often located to the left of the '1' key on the keyboard), or a combination like[SNEAK KEY]+GRAVE`. This key can be reconfigured within the Minecraft controls menu.

Within the keybinding screen, users can visually select any key on an on-screen keyboard to assign a macro or command. Saving a keybind is usually done by pressing ENTER, while ESC cancels the process. Existing keybinds can be edited by repeating the binding process for the desired key.

Override Function

One of the mod's key features is its ability to bind macros to keys that are already used for other in-game functions (e.g., WASD, T, I). This is achieved through an 'override' function, which typically defaults to the sprint key (Left Control). When the override key is held down, any subsequent key press will execute its bound macro instead of its original Minecraft function. A visual indicator often appears to confirm the override function is active.

Macros are the core of the mod, allowing players to define sequences of actions or commands. The mod supports various types of actions and execution modes.

Macro Actions

Macros can perform several types of actions:

• Execute Command: Runs a Minecraft command (e.g., /home, /spawn).
• Type Message Without Send: Types text into the chat input field without automatically sending it.
• Send Message: Types and immediately sends a message to chat.

Macro Modes

Macros can be configured to execute in different ways:

• Simple: The macro executes once per key press.
• Toggle: A sustained press of the key causes the macro to execute repeatedly at a set interval.
• Repeat: A single press activates a timer, causing the macro to run multiple times at a specified frequency.
• Delayed: The macro executes once after a predefined delay following the key press.

In-Game Text Editor

For creating more complex macros, the mod includes an in-game text editor. This allows users to write and edit macro scripts directly within Minecraft, eliminating the need to switch to external programs. Macros can also be installed by creating plain text files in the .minecraft/mods/macros folder and then binding them to a key using a specific syntax like $${<nameofyourmacro.txt>}$$.

The Macro/Keybind Mod offers powerful scripting capabilities, enabling highly customized and automated gameplay. While extensive, scripting allows for the creation of sophisticated functionalities beyond simple command binding.

Parameters

The mod provides numerous easy-to-use parameters that can be incorporated into macros and scripts. These parameters facilitate dynamic actions such as managing lists of friends, creating automatic responses, setting warp points, or interacting with town systems.

Scripting Examples

With scripting, players can build custom auto-announcers, implement time-delayed messages, or create toggleable keys for actions like auto-walk, sneak, or sprint. A command reference or 'cheat sheet' is typically available (often by pressing F1 within the macro editor) to list all available scripting commands.

Custom GUI Buttons

Beyond keyboard binds, the mod allows for the creation of custom graphical user interface buttons. These buttons can be added to a grid within the mod's interface and bound to any command, offering an alternative way to trigger actions.

The mod is designed with flexible configuration options to suit diverse player needs and server environments.

Multiple Configurations

Players can set up multiple configurations, allowing for different sets of keybinds and macros depending on the server they are playing on. The mod can automatically switch between these configurations, providing seamless integration across various multiplayer experiences.

Global and Server-Specific Macros

Macros can be designated as 'global,' meaning they are active regardless of the current profile or server. Alternatively, macros can be created specifically for individual servers, which is useful for server-specific commands or automations. It is also possible to assign multiple macros to a single key.

Permissions System

For server administrators, the mod may include a Client Permissions plugin. This system allows admins to control and lock down specific features of the mod, ensuring seamless integration with existing server rank systems and maintaining server rules.