Combat Assist MQ2Cast 11.4

Are we missing something? Level 2 users can edit this manual to add it. If you make a good change please reply to the discussion for praise / critiques / rewards.

---

MQ2Cast - This is a plugin form of Spell_Routines.inc, and far, far superior. It can, among other things, memorize and cast spells, recast them, and, with the use of MQ2CastTimer, monitor the estimated duration on long term spells like DoTs, Buffs, etc. The plugin can also deal with events, similar to MQ2Events.

Features

• Reliably casts spells (auto-recasts on fizzles or gate collapses). Will attempt to immobilize you before casting. Will cast immediately a spell is available, before the gem is even fully ready.
• Intelligently and reliably memorizes spells and allows saving and loading of custom spell sets. Will attempt to immobilize you if moving.
• Clicks items and activates AAs. Will equip items in bags before clicking, and then return them once clicked.
• Utilizes MQ2Bandolier to swap in sets of items before casting (ie. Focus items).
• Auto-pause Stick and/or Advpath if detected and resume when complete.
• Custom interrupt function, to interrupt spells during casting (includes dismounting).
• Returns control to the macro immediately after it has started (ie. while the spell is casting), to allow the macro to perform other checks. Eg. while casting a heal spell, you could get the macro to check if the target has already been healed and then interrupt your spell if his HPs are above a certain amount.

Commands
/casting
Syntax:
/casting "Name" [type] [options]
Although the [type] is optional, it's always recommended to specify if you're casting a spell (specify the gem or number), clicking an item (specify "item" or the slot name/slot number) or activating an AA (specify "alt"), since there are AAs which have the same name as spells and spells and items can have the same IDs.

The /casting command requires only 1 argument, the name of the spell you wish to cast. If the spell is not memmed, it will try and mem it in gem5 (this is the default if no gem is specified). If the spell has more than one word, make sure to surround it with quotes. For example:
/casting "Minor Shielding"
This will cast the Minor Shielding spell if it is already memmed, or if not, will attempt to memorize it in gem5 before casting.

You can also include the gem number (or just the number) after the name of the spell, to indicate which gem it should be memmed into. For example:
These will both cast Minor Shielding if memmed, or memorize it in gem1 before casting.

The gem number can also be appended to the end of the spell name, separated by a pipe command, like so:

You can also use the ID of the spell you wish to mem/cast. The following 4 examples all do the same thing:
All of the above will cast "Minor Shielding" (ID 288) and mem it in gem1 if not already memmed.

When clicking items you use the same syntax, except the "name" of the spell is the name of the item or the item's ID. It's always recommended to specify the type as "item" or specify the slot name/slot ID if you are clicking an item. For example:

Options:
The following optional parameters can be added to the /casting line:

• bandolier|<name> Equip the bandolier with <name> before casting. Useful for focus effects.
• invis With this parameter, it will not cast if you are invisible.
• kill Keep casting this spell until the target dies.
• maxtries|<#> Cast the spell this many times until successful.
• recast|<#> Recast the spell this many times.
• setin|<name> Same as bandolier (left here for backwards-compatibility purposes).
• targetid|<#> Target this ID before casting.

Examples:


/interrupt

This will interrupt the current spell/item/AA that's casting.

/memorize

Syntax:
/memorize "name" [gem]

As with the /casting command above, the /memorize command can take spell names or IDs, and can use gem# or just the numbers themselves. The gem# or number can also be appended to the end of the name.
See the following examples:


Multiple spells can be memorized with the same line, such as the following example:

/memorize "1234|1" "gate|2" "cannibalize|gem4"

As with /casting, the plugin will attempt to immobilize you before memorizing the spell.

/sss - spell set save, this will save your any number of your currently memmed spells into a spell set.

Syntax:
/sss "name" [gems]
Name is what you want your spell set to be called. If no gems are specified, all your gems are saved (ie. 123456789ABC). You can specify a smaller subset if needed.

/ssm - spell set memorize, this will memorize a previously saved spell set.

Example
/ssm dps

/ssl - Spell Set List, this will list all spell sets that have been saved.

/ssd - Spell Set Delete, this will delete a spell set from the ini file.

Top Level Objects (MQ2Data)

• bool ${Cast}
  Same as ${Cast.Active} (see below).
• bool ${Cast.Active}
  Return TRUE if plugin is loaded and you are in-game.
• spell ${Cast.Effect}
  Returns the name of the spell being casted, or a NULL string if not casting.
• bool ${Cast.Ready}
  Return TRUE if ready to cast a spell, item or AA.
  • bool ${Cast.Ready[M]}
    Return TRUE if ready to memorize a spell.
  • bool ${Cast.Ready[#]}
    Return TRUE if gem # is ready to cast.
  • bool ${Cast.Ready[X]}
    Return TRUE if spell, item, gem, ID, AA, etc is ready to cast. As spells and items can have the same IDs and spells and AAs can have the same names, it's a good idea to specify the type of cast to take place (ie. gem#/item/alt). Examples:

• string ${Cast.Result}
  Returns a string containing the result of the /casting command. It can be one of the following:
  • CAST_ABORTED: Casting Aborted (/interrupt)
  • CAST_CANCELLED: Casting was aborted
  • CAST_CANNOTSEE: Cannot see target
  • CAST_COLLAPSE: Your Gate collapsed
  • CAST_COMPONENTS: Missing Component
  • CAST_DISTRACTED: You were distracted
  • CAST_FIZZLE: Your cast fizzled
  • CAST_IMMUNE: Target is immune the spell's effect
  • CAST_INTERRUPTED: Casting was interupted
  • CAST_INVISIBLE: You are invisible
  • CAST_NOTARGET: No target
  • CAST_NOTREADY: Not ready to cast
  • CAST_OUTOFMANA: Not enough mana to cast spell
  • CAST_OUTOFRANGE: Target is out of range
  • CAST_OUTDOORS: Spell not working here (on mount ect..)
  • CAST_PENDING: Casting is in progress
  • CAST_RECOVER: Spell is not ready
  • CAST_RESIST: Cast was resisted
  • CAST_STANDING: Not standing
  • CAST_STUNNED: You are stunned
  • CAST_SUCCESS: The cast was a success
  • CAST_TAKEHOLD: The spell did not take hold
  • CAST_UNKNOWN: Unknown Spell
• string ${Cast.Return}
  Returns the result of the casting/memorize/interrupt request.
• string ${Cast.Status}
  Returns a string containing all the pending events. This string often contains multiple events (eg. when /casting still has to immobilize you and then memorize the spell before it can cast). The list of possible pending events is:
  • I: idle and waiting for you
  • A: advpath pause
  • F: stick pause
  • S: immobilize in progress
  • M: memorize in progress
  • E: item swapped
  • D: ducking casting
  • T: targeting
  • C: spell casting in progress
• spell ${Cast.Stored}
  Returns the last spell that was cast, or NULL if no spell has been cast.
• bool ${Cast.Taken}
  Return TRUE if last spell cast didn't take hold on target.
• int ${Cast.Timing}
  Returns the estimated number of miliseconds remaining until the spell finished casting.