
If you're a server admin, a player on a server with lots of plugins, or a user of Single Player Commands you will honestly wonder how you lived without this mod...

- Ridiculously easy to use! Just activate the mod then just press the key you want to bind. No memorizing key codes or names!
- Bind keys which are already used for something else! Want to put a macro on the number keys or WASD? Using the override function you can use these keys for both their normal function or as macros when you need them.
- Edit keybinds quickly. Change your binds whenever you want. You can even copy and move macros from key to key with drag 'n drop.
- Multiple configurations. Different binds in different servers? No problem! It even switches automatically.
- In-game text editor. Want to make a complex macro? No need to alt-tab to notepad, create and edit text files inside minecraft.
- Lots of easy-to-use parameters. Lists of friends, automatic responses, warp points, towns, you name it.
- Scripting! Build custom auto-announcers, time-delay messages, or create your own auto-walk, toggleable-sneak or sprint keys.
This mod is compatible with most other mods and works well with Single Player Commands. It uses ModLoader for compatibility and does not edit any Notch classes at all.
In essence, this mod modifies the minecraft client to allow you to bind any keyboard key you like to chat commands or simple script functions (like sprinting or opening a gui). Most importantly, it lets you do this without knowing any key codes and has a full, easy-to-use GUI! No more typing obscure commands in order to bind keys. Plus you can edit your binds any time you like and even move and copy them to other keys with just drag-n-drop!
There are also some advanced features like including files and parameters in your macros including a nifty item selection screen, customisable friends list, and lots more. You can also have multiple different configurations and quickly switch between them (for example so that you can have different binds for single player or online).
This mod requires Risugami's ModLoader so make sure you install that first!

- Install ModLoader
- Download the .zip file here (direct link) and save it into your "mods" folder (create the "mods" folder if it does not already exist)
- Run the Minecraft client
- Check the Controls screen in the Minecraft configuration to make sure there are no conflicts with other keys you use. This mod adds pages to the Controls screen for enhanced configuration of any mods which use ModLoader



Expand for more images:

To bind keys:
- In-game, simply press [SNEAK KEY]+GRAVE (change the key in the options if this doesn't work for you) and you will be prompted to press a key.
- Press the key you would like to bind or click it on the on-screen keyboard
- Enter the chat command (including the / at the start), separate multiple commands with pipe "|"
- Press ENTER to save the keybind, press ESC to cancel it. To edit a keybind repeat the same process.

To get started quickly with the mod, you can use the following codes in your keybind macros to have the mod prompt you for the value to insert. A more extensive list and guide to the other features in the mod is available in the readme.txt
- Include the code $$? anywhere in your macro as many times as you like to be prompted for a parameter when you run the macro, the parameter will be inserted wherever you enter $$?
- Include the code $$f anywhere in your macro to be prompted for a friend name (works the same as a parameter)
- Include the code $$u to prompt for an online user
- Include the code $$[name] to prompt for a named variable! Unlimited variables!
- Include the code $$i to prompt for an item with a scrollable list, or $$i:d to include the damage value for the item (to get coloured wool or different steps)
- Include the code $$<filename.txt> to insert a file (the file must end with .txt and be enclosed in < > as shown. You can include, $$?, $$i, $$f and even other $$<file.txt> in your file.
- Include the code $$! to halt processing of the macro and leave the last command in the chat buffer.
- Include the code $$h to prompt for a "home", this option supports automatically fetching homes from the server
- Include the code $$t to prompt for a "town", this option also supports auto-population
- Include the code $$m to prompt for a text file to include, similar to $$<file.txt> but allows you to choose the file on-the-fly
- Include the code $$0 through $$9 to prompt for a text list, supports unlimited text entries of unlimited length
- Include the code $$w to prompt for a "warp point". This works the same as homes and towns and supports automatic retrieval from the server
- Include the code $$p to prompt for a "place" (a set of coordinates). You can also include $$px, $$py, $$pz and $$pn to insert only the X, Y, Z or NAME parts of the place respectively.

- If the key doesn't have any other function (eg. it is not bound to any other built-in command or function) then just press the key
- If the key is bound to another function (such as the WASD keys or T,I etc) press your [MACRO ACTIVATE] key (as you set in the options) followed by the key.
- Alternatively if the key is bound to another function press [MACRO OVERRIDE]+[KEY] (again, you can set this in the Controls screen)






As of version 0.8.5 language packs are no longer required as the supported languages are directly integrated into the main download and will automatically switch based on the chosen Minecraft language. If you would like to provide a language pack for your language please contact me via PM.
Current language packs in the mod:
- German Language pack by AJFire
- French Language pack by Chokapix
- Polish Language pack by kamild1996

Here's a short video showing the basics of using this mod:

Changes for version 0.8.7:
- Updated for Minecraft 1.2.5
- Added option to log sent messages in the local chat history (defaults to off)
- Added RANDOM, TIME and PLAYSOUND script actions
- Added optional 5th parameter to MATCH to specify default value to use if the match fails
- Event bind buttons now have icons
- Event-specific help content added when editing an event binding
- Added YAW, PITCH and DIRECTION global variables
- Added onPickupItem and onPlayerJoined events
- Fixed list parameters not retriggering macro compilation
- Made some improvements to the key injection subsystem to support more reliable injection of key events

- To uninstall the mod, just delete the .zip file from your "mods" folder
- Key binds are saved in a file macros.txt in your minecraft folder, you can save and restore this file if you want to copy your macros to another computer
- This mod shouldn't create conflicts with other mods using modloader, but to be certain it is worth avoiding binding keys used by other mods. If in doubt delete the macros.txt file and ensure other mods run as normal. Also ensure that you install modLoader before installing Improved Chat, as mentioned in the Improved Chat thread.

If you would like to show your support for the mod by including a clickable banner in your sig, click the spoiler next to one of the banners below and copy the code into your forum signature:





Thanks to the MCP team and everyone who's given suggestions and feedback. Special thanks to AJFire for making the original mod logo and providing the german translation. Thanks also to Chokapix for the french translation and kamild1996 for the Polish translation.
Enjoy! Please post feedback, comments, abuse here.
Curse
MMO-Champion
WowStead
Arena Junkies
Minecraft Forums
DarthHater
Diablo Fans
Terraria Online

















