Advanced Options - xod-wow/LiteMount GitHub Wiki

The Advanced Options sub-panel in the LiteMount settings exposes some of the addon's internal workings to allow more advanced customization. You can see and edit the action lists that are associated with each of the four LiteMount key bindings.

This is the default action list from LiteMount 11.0.0-16:

LeaveVehicle
Dismount [nofalling]
CopyTargetsMount
ApplyRules
SwitchFlightStyle [mod:rshift]
IF [mod:shift]
    IF [submerged]
        Limit -SWIM
    ELSEIF [flyable]
        Limit -DRAGONRIDING/FLY
    ELSEIF [floating]
        Limit -SWIM
    END
END
SmartMount
IF [falling]
  # Slow Fall, Levitate, Zen Flight, Glide, Flap
  Spell 130, 1706, 125883, 131347, 164862
  # Hearty Dragon Plume, Rocfeather Skyhorn Kite
  Use 182729, 131811
  # Last resort dismount even if falling
  Dismount
END
Macro

The format of a LiteMount action list is:

• Each line is run in turn until one succeeds.
• Lines beginning with # are comments and are ignored.
• Each line contains an action, optionally one or more tests to restrict when the action is tried, and finally a set of action parameters.
• Each test is contained inside square brackets []
• Tests are logically OR-ed; they are successful if ANY match.
• Each test (inside []) is a set of conditions, separated by commas.
• Conditions are logically AND-ed; they are successful only if ALL match.
• An action is not attempted unless its tests match.

• ApplyRules
• CancelAura SPELLS
• CopyTargetsMount
• Dismount
• Limit LIMITS / Endlimit
• LeaveVehicle
• Macro
• Mount MOUNTS
• PreCast SPELLS
• PreUse ITEMS
• PriorityMount MOUNTS
• Script SCRIPTLINE
• SmartMount MOUNTS
• Spell SPELLS
• Stop
• SwitchFlightStyle
• Use ITEMS
• IF / ELSEIF / ELSE / END

The Mount, PriorityMount and SmartMount actions take a MOUNTS parameter.

The parameter is a comma separated list of mount selections, all of which must match ("AND") for a mount to be included. Selections may additionally be separated with / (slash), which matches any of those conditions ("OR"). Selections may be negated with ~SELECTION.

A selection that is the word NONE (in all capitals) never matches any mounts.

A selection that is all numbers is an exact mount spell ID to match.

The selection mt:<n> matches mounts with mountType <n>.

The selection id:<n> matches exactly the one mount with mountID <n>

The selection family:<name> matches mounts with that family.

All other selections are either an exact mount name, a mount flag to match, or a group name. The possible mount flags are:

• RUN
• FLY
• SWIM
• DRAGONRIDING
• RIDEALONG
• SLOW (set on RUN mounts that are slow, e.g. the heirloom chauffeurs)
• JOURNAL (mounts from the Mount Journal, nothing extra)
• FAVORITES

The Limit action limits the set of mounts that will be considered by all later action list lines.

The beginning set of mounts is all mounts you know.

Limits that begin with + (plus) add the matching mounts (from all mounts) to the considered set.

Limits that begin with - (minus) remove the matching mounts from the considered set.

Limits that begin with = (equals) replace the considered set completely.

All other limits filter the considered set to those mounts who match the new selection as well.

The Endlimit action reverts the list of mounts to that prior to the most recent Limit action.

The Mount action randomly chooses from all of the matching mounts, ignoring priority.

The PriorityMount randomly chooses from all of the matching mounts, with priority.

The SmartMount action is location-aware and uses priority. It will look for the type of mount that is best for the current situation (Ground / Flying / Aquatic) and choose a mount of that type from the filtered mounts.

Evaluate the rules from the Rules options panel.

The SPELLS parameter is a comma-separated list of buff names or buff spell IDs to cancel. CancelAura will only cancel spells that you are able to reapply, meaning it won't (for example) cancel Slow Fall someone else cast on you if you aren't a mage.

Attempts to copy the mount of your target.

Dismount if mounted. This includes canceling mount-like forms.

For druids, the Dismount action will attempt to put you back in the form you were most recently in if you have that option enabled.

Leave vehicle if in one.

Does nothing when activating LiteMount using a macro on an action bar.

Run the "Unavailable" macro from the LiteMount settings. See the Script action if you want to run your own script line.

Has no effect when activating LiteMount using a macro on an action bar.

The SPELLS parameter is a comma-separated list of spell names or spell IDs to attempt to cast before summoning a Mount Journal mount. You can use this to turn on Crusader Aura, Path of Frost, or Water Walking (as examples). E.g.,

PreCast Crusader Aura, Path of Frost, Water Walking, Slow Fall

Has no effect when activating LiteMount using a macro on an action bar.

The ITEMS parameter is a comma-separated list of items (see "Use" action for details) to attempt to use before summoning a Mount Journal mount.

PreUse Prismatic Bauble

Has no effect when activating LiteMount using a macro on an action bar.

Run a slash command exactly as if you had typed it into the chat box. You must include the entire line including the starting /.

If you need to include commas or [macroconditions] in your script, quote the whole script line with "double quotes".

If a script command matches it is always run and LiteMount ends processing, even if it does nothing.

The SPELLS parameter is a comma-separated list of spell names or spell IDs to cast. If you need to include commas in your spell names, quote them with "double quotes". The first one that is known and usable is cast.

Stop processing and don't perform any action.

The ITEMS parameter is a comma-separated list of item IDs, item names, toy names, or inventory slot numbers, similar to the /use macro command.

Checks each item in turn to see if it is usable. You cannot use this to equip items.

Flow control options. These take no parameters but operate off the given [tests]. The tests use the same format as all other action lines, with one or more conditions inside square brackets.

E.g.,

IF [instance:1]
  ...
END

These can all be prefixed with "no" to reverse the check. E.g., [nopvp]

There are two randomizing conditions available:

[draw:<x>/<y>]

Makes a shuffled deck of cards with y cards, x of which are success and the rest are failure. Draw and discard the top card of the deck. When the deck is empty, reshuffle it.

[random:<percentage>]

Roll a 1-100 die, and if the number is <= the given percentage, return success.