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 before memorizing.
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:

/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 Object: ${Cast}¶

Type	Member Name	Description
bool	${Cast}	Same as ${Cast.Active} (see below).
bool	Active	Return TRUE if plugin is loaded and you are in-game.
spell	Effect	Returns the name of the spell being casted, or a NULL string if not casting.
bool	Ready	Return TRUE if ready to cast a spell, item or AA.
bool	Ready[M]	Return TRUE if ready to memorize a spell.
bool	Ready[#]	Return TRUE if gem # is ready to cast.
bool	Ready[X]	Return TRUE if spell, item, gem, ID, AA, etc is ready to cast. (See examples below)
string	Result	Returns a string containing the result of the /casting command. (See possible results below)
string	Return	Returns the result of the casting/memorize/interrupt request.
string	Status	Returns a string containing all the pending events. This string often contains multiple events (See possible events below)
spell	Stored	Returns the last spell that was cast, or NULL if no spell has been cast.
bool	Taken	Return TRUE if last spell cast didn't take hold on target.
int	Timing	Returns the estimated number of miliseconds remaining until the spell finished casting.

${Cast.Ready} 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]}

${Cast.Result} Results¶

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

${Cast.Status} Results¶

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

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 Object: ${SpellTimer}¶

Type	Member Name	Description
int	${SpellTimer[SpawnID,Caster,Spell Name]}	Returns time (in seconds) left on the spell. Caster can be me(default), other, or any. (See examples below)

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

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."