• You've discovered RedGuides 📕 an EverQuest multi-boxing community 🛡️🧙🗡️. We want you to play several EQ characters at once, come join us and say hello! 👋
  • IS THIS SITE UGLY? Click "RG3" at the very bottom-left of this page to change it. To dismiss this notice, click the X --->

MQ2React 2020-12-11

Download now: Join us with Level 2 access
or earn your way in with RedCents.
Other Authors
Included in Very Vanilla
Very Vanilla Included! No need to download.
Server Type
Live, Emu, TLP, Test Server

2020 (x2) ESA Winner
(Initial Release -- Open Beta -- I suggest keeping backups of your known-good mq2react configs)

MQ2React is a plugin that allows users to define actions, as well as conditions that determine when to perform those actions. Conditions are defined in MQ2 Macro syntax and actions are mq2 commands. It's up to the user to make sure their defined conditionals and reactions do not conflict with one another; mq2react does no additional action deconfliction. This is similar to the "HolyShit" and "DownShit" behavior of MQ2Melee without the additional automation behavior that exists within the plugin. MQ2React also allows for complex conditions to be defined as global conditions and reused throughout multiple reacts, thus making reacts considerably easier to maintain and reuse.


MQ2React uses a yaml format for configuration. Upon initial execution, a default configuration file will be created with example reacts and an example global condition. The configuration file is case sensitive.



  • /react help - Displays the below list of commands.
  • /react add <nickname> <condition> <action> - add a new reaction to your config with <condition> as the condition, <action> as the action>, and labeled <nickname>. New reacts are disabled by default.
  • /react remove <nickname> - remove a reaction from your config file that has the label <nickname>.
  • /react globaladd <nickname> <condition> - add a global condition with name <nickname> and condition <condition>.
  • /react globalrem <nickname> - remove a global condition with name <nickname>.
  • /react enable <nickname> - enable a reaction with label <nickname> .
  • /react disable <nickname> - disable a reaction with label <nickname>.
  • /react list - Display all condition nicknames.
  • /react reload - Reloads the mq2react config.
  • /react save - Saves the current in-memory configuration to the react config. add, remove, enable, and disable do this automatically.


  • ${React.Condition[reactname]} - Returns the condition from react with 'reactname'
  • ${React.Action[reactname]} - Return the action from the react with 'reactname'
  • ${React.Enabled[reactname]} - Return true if the react is enabled for the currect character or false if it is disabled
  • ${React.Global[globalname]} - Returns the condition from the global condition with 'globalname'

Note: For TLOs that return condition statements, MQ2, by design, will parse these conditions automatically. These TLOs are most useful to provide shortcuts to complex conditions for macros like KissAssist.

Known Issues
  • There's currently a very simple yaml example, I'd like to have us communally put more together, especially as folks have pointed out not everyone is familiar with yaml.
  • This documentation should probably include a set of assumptions and potentially best practices when handling conditions and actions.
  • The YAML library used doesn't yet support the escaping of double-quotes in its serializer (e.g., action: "/cast \"My long spell name\"")
I'd like feedback on:
  1. Any crashes you come across -- even if related to known issues (just mention it's a known issue -- this allows me to judge scope)
  2. How the TLOs and slash commands "feel" to work with or if you ignore the slash commands all together
  3. Any bugs related to the config file having issues.
We're excited to see what configurations people come up with. Please share your creations here,
First release
Last update
5.00 star(s) 1 ratings

More resources from drwhomphd

Latest updates

  1. react processing

    Config setting added to affect rate of react processing.
  2. File Fix & User Experience

    MQ2React will be gentler on your YAML files. File wipe-outs should be reduced (hopefully...
  3. Added globaldadd and globalrem slash commands. (+Bug Fixes)

    The globaladd and globalrem slash commands allow for the adding of new global reacts from the...

Latest reviews

Outstanding plugin Doc!!!