Combat Assist MQ2Melee

Contents

1. Features
2. Commands
   1. /melee
3. INI File
4. Top-Level Objects
   1. Debugging TLOs
5. Troubleshooting
6. FAQ
7. More Examples & Guides

The classic MQ2Melee, used for automating melee skills, abilities, AA's and movement in combat. It can also be configured to handle pets and some items depending on combat conditions.

Features

• Auto use abilities according to user settings and game conditions.
• Auto-equip defined items for bashing, backstabbing or ranged attack.
• Built in user conditions to restrain the use of certain abilities.
• CHAT MONITORING:
  • Auto-stand on Failed/Broken Feign Death.
  • Monitoring of "Begin to Cast" messages for automatic Bash/Slam/Kick or casting of defined stuns.
  • Automatic turning on/off of Attack on Enrage/Infuriate.
• MELEE:
  • Auto-equipping of weapon set(s) prior to engaging (aggro/non-aggro sets).
  • Auto-use of defined combat or other abilities.
  • User-configurable /stick arguments.
• MELEE (AGGRO MODE):
  • Auto Taunt when you loose aggro on target.
  • Configurable spells to cast to gain/maintain aggro.
• MELEE (NON AGGRO MODE):
  • Back off/Feign/Evade fight if your health goes below a point.
  • Auto Resume fight if your health goes back above a point.
• SPELL HANDLING:
  • Provoke can be configured to cast any AA, disc or spell. It will auto-detect if you lose aggro, and then attempt to use any of the defined spells to regain it.
    • To determine the proper Spell ID for any Discipline, Alternate Ability or Spell to be used with the provoke/stun commands use one of the following commands:
      • For Disciplines use: /echo ${Me.CombatAbility[${Me.CombatAbility[<disc>]}].ID}, replacing <disc> with the name of the Discipline.
      • For AAs, use /aa info <AA name>. The first number (before the AA name) is the Spell ID.
      • For Spells, use /echo ${Spell[<spell>].ID}, replacing <spell> with the spell name.
    • Alternatively, you can look on Lucy for the discipline/spell/AA and get the ID from there.
  • Stuns can also be configured to cast any AA, disc or spells when MQ2Melee detects that your target begins to cast a spell.
  • Provoke and Stun have built-in values, but they can always be overwritten using the command line (eg. /melee provoke0=5015) or by editing the provoke0 setting in the INI file and then typing /melee reload in game.
• RANGED:
  • Toggle between Melee/Ranged mode according to Target distance.
  • Swap In/Out defined ranged items (bow/throwing).
  • Auto refill ammunition slot when less than 80 in a stack.
  • Built-in /throwit command you could use to pull (see below for explanation).
  • Auto-Sleep mode while auto-fire is on.
  • Configurable automatic facing of target.
• PET HANDLING:
  • Issue /pet back and /pet hold after each mobs dies.
  • Configure pet to wait to assist till mobs within range.
  • Configure pet to wait for a specified time before assisting.
  • Pet mend if its life goes below a certain point.
  • Option to automatically re-engage target when no longer mezzed.
  • Backup pet on enrage/infuriate events and re-engaging of target.
  • Auto /pet hold if you manually hit back button or do /pet back.
• USER DEFINED CONDITIONS:
  • Allows for conditional use of various abilities/disciplines.
  • Allows for customized actions based on conditional statements.
• TOP-LEVEL OBJECTS:
  • Provides MQ2Data information for better macro integration and HUD designs.
  • Can be used with custom user-defined conditions.

COMMANDS


INI FILE

TLOs (Top-Level Objects)

TROUBLESHOOTING

• I have made changes to my INI settings. How do I activate the new settings?
  If you have MQ2Melee loaded and use an editor to make changes to your INI file, use /melee load to reload your settings. Alternatively, you can unload and reload the plugin.
• I keep having to making changes to my melee settings from the command line. How do I save the new settings?
  From the command line type /melee save.
• I can't get the StickCmd to work
  With Version 4 of the MQ2Melee plugin there was a change to the StickCmd, wherein it no longer requires "/stick" in the parameters. The old format of "StickCmd=/Stick hold 10 moveback" thus becomes "StickCmd=hold 10 moveback". Also you will have to execute /melee stickmode=1 to tell the plugin to use stick arguments from ini and not built-in default /stick behaviour.

FAQ

Q. What is the name of my ini file?
A. Your MQ2Melee ini is named after your server and charter in the following format sever_Charactername.ini

• If your character's name is Bob and is on the Povar server the file would be povar_Bob.ini.

Q. Where is my ini file?
A. Your MQ2Melee ini file is located in the root folder of your MQ2 compile. i.e. c:/macroquest2/povar_Bob.ini

Q. Why is there no ini file in my Macroquest folder?
A. MQ2Melee does not automatically create your character ini file. You must use the following command to create the file.
Q. Why are my /melee commands not working?
A. There are some macros that create an alias for /melee that can change what echos in the MQ2 window i.e Zbot. To fix this, type the command below but be aware it will over write any alias your macro created for /melee.
Q. How many downshits/holyshits does MQ2Melee support?
A. MQ2Melee currently supports up to 15 of each downshits/holyshits.

Q. My downshits/holyshits are not working?
A. Check to see if they are turned on. Each downshits/holyshits must be numbered and have corresponding downflag/holyflag set to 1. If you had 4 holyshits in your ini file you need to have 4 holyflags as well See example below.
Q. Why isn't my spell/item/AA isn't being cast?
A. MQ2Melee uses MQ2Cast for casting a spell/item/AA. It must be loaded and the proper syntax is as follows:
Q. Why isn't my Aura casting? ${Me.Aura[Aura of the Pious].ID}
A. Recent changes in MQ2 changed the syntax of Auras as follows: ${Me.Aura[Aura of the Pious].Length} See cleric example below.

More Examples & Guides

Holyshit and Downshit snippets.

Do something when target health below 95%
${Target.PctHPs}<95
Do something when target health above 85%
${Target.PctHPs}>85
Do something when target health between 85% and 98%
${Target.PctHPs}>85 && ${Target.PctHPs}<98

MQ2Melee Examples (Timers and /multiline and Healing, Oh my!) by @Araaak