MQ2Cast¶

Introduction¶

MQ2Cast by s0rCieR and A_Enchanter_00 is a plugin to handle most things related to spell casting, item clicking and activating of AAs.

The official forum thread for MQ2Cast is here \(VIP Only\).

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.

Requirements¶

MQ2Bandolier For swapping in sets of items before casting \(ie. focus items\)

MQ2Exchange For equipping clickies before using them

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:

/casting "Minor Shielding" 1
/casting "Minor Shielding" gem1

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:

/casting "Minor Shielding|gem1"
/casting "Minor Shielding|1"

You can also use the ID of the spell you wish to mem/cast. The following 4 examples all do the same thing:

/casting 288|gem1
/casting 288|1
/casting 288 gem1
/casting 288 1

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:

/casting "Fabled Journeyman's Boots" item
/casting 68239|item
/casting "Shrunken Goblin Skull Earring" leftear

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

-bandolier|
Equip the bandolier with 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|
Same as bandolier \(left here for backwards-compatibility purposes\).

-targetid|\<#>
Target this ID before casting.

Examples:

/casting "Wunshi's Focusing" gem4 -invis
/casting "Complete Heal|gem1" -kill -targetid|1234
/casting "Fizzle a Lot|gem4" -maxtries|5
/casting "uber nuke|9" -kill
/casting "cannibalize" gem3 -recast|5

/interrupt¶

This will just interrupt the current spell/item/AA that is casting. It's the same as doing /stopcast, or /dismount then /stopcast if you're mounted at the time.

/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:

/memorize "Minor Shielding"
/memorize "Minor Shielding" 1
/memorize 288|gem1

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.

/sss dps 1238
/sss dps 12ABC
/sss wunshi 5

/ssm¶

Spell Set Memorize - This will memorize a previously saved spell set.

/ssm dps

/ssl¶

Spell Set List - This will list all spell sets that have been saved.

/ssl

/ssd¶

Spell Set Delete - This will delete a spell set from the ini file.

/ssd wunshi

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:

${Cast.Ready[spellname or spellid]}
${Cast.Ready[aaname or aaid]}
${Cast.Ready[itemname or itemid]}
${Cast.Ready[1460]}
${Cast.Ready[Death Peace]}
${Cast.Ready[Death Peace|alt]}
${Cast.Ready[Death Peace|gem]}
${Cast.Ready[Death Peace|gem3]}

• 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 [#]

Set Number of seconds left on spell before recasting Default:20

Top Level Objects \(MQ2Data\)¶

• ${SpellTimer $$SpawnID,Caster,Spell Name$$ }

int Returns time \(in seconds\) left on "Spell Name" by "Caster" on "SpawnID".

:* Caster must be one of the following: me \(default\), other or any.

Examples:

${SpellTimer[${Target.ID},Euphoria]}
${SpellTimer[${Target.ID},me,Euphoria]}

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.

/if (${SpellTimer[${Target.ID},Euphoria]} < 15) {
/call mq2cast Euphoria gem1 20s
}

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 somthing like this. NOTE: this is just an example

Timer Window¶

An example of what the Timer Window looks like is \(NOTE: Links removed as they are both dead.\) \(DarkDevil\)

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.

[Settings..]
ChatTop=58
ChatBottom=233
ChatLeft=58
ChatRight=580
Locked=0
WindowTitle=Timers
Fades=1
Delay=0
Duration=500
Alpha=255
FadeToAlpha=255
BGType=1
BGTint.red=93
BGTint.green=83
BGTint.blue=93
ActorModeLeft=0
ActorModeRight=2
DefaultGem=gem8
ShowTarget=0
ShowNpc=1
ShowPC=0
ShowPet=0
ShowEvent=1
ShowMySpells=1
ShowOtherSpells=0

Custom Events¶

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

[Name of Event]
duration=<#>
event=<" event text">
spawntype=<1=pc|2=npc>

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:

[NPC Gating]
duration=5
event="#SpawnName# begins to cast the gate spell."
spawntype=2

[NPC Complete Healing]
duration=10
event="#SpawnName# begins to cast a spell."
spawntype=2

[PC Complete Healing]
duration=10
event="#SpawnName# begins to cast a spell."
spawntype=1

[Redfang Despawn]
duration=240
event="An ear-piercing screech reverberates throughout the surreal cavernous Demi-Plane of Blood, announcing the arrival of Redfang."