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.

MQ2CastTimer

MQ2CastTimer is a plugin which allows you to check timers on active spells, and adds a Timer Window that can be used to monitor spells you have cast on others.

Commands
/timer

Syntax:

/timer [on|off] - Turns timer Window on / off

/timer clear [all|target|pc|npc|pet] - Clear Spell timers

/timer autorecast [#][I] - Set Number of seconds left on spell before recasting Default:20[/I]

Top Level Objects (MQ2Data)

• ${SpellTimer[SpawnID,Caster,Spell Name]}
  intReturns time (in seconds) left on "Spell Name" by "Caster" on "SpawnID".
  • Caster must be one of the following: me (default), other or any.

Examples:

This will give the time remaining on the Euphoria spell that you cast on your current target (both examples do the same thing).

${SpellTimer[${Target.ID},other,Euphoria]}
This will give the time remaining on Euphoria on your current target, only if someone else cast it.

${SpellTimer[${Target.ID},any,Euphoria]} OR ${SpellTimer[${Target.ID},All,Euphoria]}
This will give the time remaining on Euphoria on your current target, no matter who cast the spell.

Cast Euphoria on target if you originally cast the spell, and it has less than 15 sec left.

${SpellTimer[${Target.ID},any,"Sha's Legacy","Forlorn Deeds","Desolate Deeds","Turgur's Insects","Balance of Discord"]}
If you want to check if a target is slowed you may use something like this. NOTE: this is just an example

Timer Window
The Timer Window shows the following information:

• Time Left
  The amount of time left on the spell, in HH:MM:SS format. Eg. 00:15:32.
• Tags
  Some information on the target.
  • T: This is your current target.
  • N: Spell did not take hold on this target.
  • I: Target is immune to this spell.
  • E: Event (Show that the timer is an Event)
  • GA: This target is the Group Assist.
  • G1-3: This target is group marked 1-3.
  • RA: This target is the Raid Assist.
  • R1-3: This target is raid marked 1-3.
• Spell Name
  The name of the spell.
• Spawn Name
  The unique name of the spawn.

The buttons/comboboxes at the bottom of the window do the following:

• Button
  Pauses and unpauses the Timer Window.
• Combobox 1
  Select what you want to do when left-clicking the line in the window:
  • Target
  • TargetNAB (Target nearest spawn without this spell)
  • Recast spell (if memmed)
  • Clear (removes timer). You cannot remove an event.
• Combobox 2
  Select what you want to do when right-clicking the line. Same choices as above.

The Timer Settings Tab:

• Target (Current Target)
  Show Target Timers
• NPC
  Show Npc and Npc Pet Timers
• PC
  Show Pc Timers
• PET
  Show Pc Pet Timers
• Events (All Events)
  Show Events
• My Spells (Show Your Spells)
  Show My Spells
• Other's Spells (Show Other Spells)
  Show Other Spells

An example INI entry created by the MQ2CastTimer Window is below. This contains the location, size and colors of the window.

Custom Events

You can add Custom Events to the INI file in the following format:

The duration is in seconds. The event is the text that you see on the screen when you want the event to occur. An example is below: