Синтаксис маршрутов

Route category enum. Common values are leveling, speedrun, campaign, etc.

Route selection rules; see the supported scopes in Filters and Conditions.

Expansion enum used to group the route in the UI.

Client family: "retail", "forever" or "classic". Incompatible routes are hidden and unavailable.

Display name shown in the route list.

Main map ID for the route. Used as route metadata and zone fallback.

Follow-up route keys. Conditional entries must also pass the target route's selection rules.

Declare before steps. Insert eligible groups at the current position, or after the current InstanceQuest block. Single EquipItem/UseItem actions inherit live group conditions; other groups retain activation-only conditions.

For a single UseItem action, allow a fresh activation after the previous action was passed and the conditions became false then true (for example, another book was received).

Prefab membership and ordering. Entry conditions select membership without hiding manual route selection.

Required route keys. Applicable unfinished requirements are added before this route; hard visibility failures waive them, temporary level/spec/zone restrictions do not.

Main ordered list of route steps.

Previous labels recognized when resolving saved route names.

Allows starter-route detection on the route's map.

Prioritize this starter route and protect it from automatic prefab reset suggestions.

Hide the route from manual route selection.

Temporary guide that preserves the parent route for resuming afterward.

Completed Sojourner achievement that allows campaign auto-skip when the player enables that setting.

Scenario variants for an instance route; each has scenarioID, steps and optional label/index.

Marks a route as a Delve guide.

Track an achievement or criterion. Prefer criteriaID over positional criteriaIndex; if both are given, the ID wins.

Move every listed bag stack into the open Classic character bank and bank bags; excludes guild, reagent and warband banks.

Move every listed Classic character-bank stack into bags while the bank is open.

Buy quantities from the open merchant as a main or secondary action. MerchantNPC restricts the merchant; place junk sales before purchases.

Selects a specific Chromie Time timeline by option ID.

Wait for death, confirm resurrection at a spirit healer, then finish on resurrection. Does not kill the character or accept an ordinary player resurrection as completion.

Delete every bag stack of the listed items and wait until absent; no quantity limit.

Show the localized item name and an item button; complete once the specified slot contains the item. Use possession and level conditions for deferred parallel reminders.

Quests to turn in. The step completes once all listed quests are handed in. If using DoneDB, keep a base Done field as well.

Alternative quest IDs counted as the same hand-in. Requires Done.

Indicates that the player should complete the scenario.

Defines passive or active dropped-quest tracking. When used without DropQuest, it behaves like a filler hint.

Quest obtained from a mob drop. Must be paired with a corresponding DroppableQuest.

Requires performing an emote on a target or at a step.

Guides the player into an instance.

Guides the player to a scenario entrance.

Exile's Reach specific step that auto-skips if the exit quest is no longer tracked.

Optional side objectives that can progress during any step without blocking the route.

Learn a flight path node.

Wait until the level/XP threshold is reached; supports numbers, absolute XP and named profiles.

Marks an optional group quest and shows a popup (questID, Number).

Associates the step with WantedQuestList to store the player's decision for a group quest.

Checks if a specific profession spell is learned.

Train spells at a trainer. Waits if unavailable or unaffordable; add the required MinLevel and class filters.

Prompts to leave the instance once objectives are done.

Abandons a single quest from the quest log.

Abandons multiple quests from the quest log.

Prompts to leave the scenario once objectives are done.

Wait for each quantity (default 1) in bags plus the saved character bank. A completed questID also satisfies its entry; no virtual loot or remembered counts.

Wait for cash plus carried items' estimated vendor value to reach copper; shows a progress bar. Excludes banks and uncached prices. See resource fields below.

Automatically validates when a mount / boarding event is detected.

Informational step accepting a string or array of strings. Seen notes are remembered and can auto-skip on later resets / revisits.

Automatically dismounts to talk to the targeted NPC.

List of quest IDs to pick up. The step remains active until all quests are in the log. If using PickUpDB, keep a base PickUp field as well.

Alternative quest IDs for the same pickup step (class / faction variants). Requires PickUp.

Quest objectives to complete, mapped by quest ID and objective index.

Alternative quest IDs for the same Qpart block. Requires Qpart.

Splits a single objective into guided sub-parts. Commonly paired with TrigText. Supports fraction and percentage style progress markers.

Open the declared NPC's vendor option and repair automatically, independently of general auto-gossip/auto-repair settings. Skip when every durable equipped item reaches minDurability (default 90%). Show the REPAIR label in both panels.

Wait for the target standing, renown or friendship rank; shows progress within the current rank. See reputation types below.

Shows a confirmation popup that resets the active route back to step 1.

Marks the route as finished and triggers route completion flow. Must stay as the last step.

Fine-grained scenario objective tracking (scenarioID, stepID, criteriaID, etc.), optionally tied to a quest ID.

Sell listed stacks and/or grey junk at the open merchant. npcID restricts the vendor; no quantity limit. Junk uses the localized default label; put extra advice in Note.

Step to set the Hearthstone.

Show TAMEBEAST (Tame the %s beast) with the cached localized NPC name, falling back to the beast name in Text; update both panels when a live unit reveals its name. Offer spell and target buttons; complete after a successful cast on the specified NPC.

Treasure or vignette step. The addon tracks the treasure's anchor quest, with optional item details for the tooltip.

Dalaran Hearthstone variant.

Step for using a flight master. Validates once the flight is complete.

Garrison Hearthstone variant.

Step to use the Hearthstone.

Standalone item-use action. questID is required; APR resolves the use spell from the item unless itemSpellID is supplied. Use Button when the item supports another objective.

Standalone spell-cast action. questID is required. Use SpellButton when the spell supports another objective.

Forces exiting a vehicle.

Ask the player to enable War Mode; completes when it is desired. The quest ID supplies the label. XP bonuses require active War Mode.

Indicates the player should take a boat instead of flying. Requires UseFlightPath.

World coordinates used by the arrow (x, y in WoW units).

Multiple coordinate variants for the same step. Typically paired with Zones; each entry should include its own Zone.

Duration in seconds of the AFK countdown, started once after the matching step emote is performed via the button, chat command or APR. Displaying the step does not start it.

Estimated AFK timer duration in seconds.

Starts an AFK timer after gossip confirmation.

Marks instance steps; delays automatic Delve suggestions. A nearby matching DoScenario is replaced by the guide while preserving preceding setup steps.

Allows auto-accepting quests from the Adventure Map.

Optional custom name to override the taxi node name.

Hides the navigation arrow for this step.

Prevents automatic flight / gossip selection for this step.

Flight path node ID used on UseFlightPath steps.

Prevents the step from being skipped manually.

Distance in yards from Coord to consider the location reached.

Display only the distance to the next waypoint instead of the remaining waypoint chain.

Hides the AFK timer even if ETA is set.

Start the AFK timer after the successful cast of spellID, or the use spell of itemID.

Use a portal; completes at mapID or when the linked quest is completed. Destination names come from the map ID.

Quest-related waypoint displayed until completion.

Alternative waypoint quests that allow skipping if already completed. Requires Waypoint.

Expected map ID for the step.

Multiple valid map IDs for a single step. Also acts as a condition: the step is only considered valid when the player is in one of those maps.

Automatically validates the step when entering the specified radius.

Adds a reminder to use Heroism / Bloodlust.

List of buff spell IDs to recommend.

Item buttons keyed by quest ID or questID-objective. A value may be one item ID or a nonempty list of item IDs, displayed in list order on the same step. Keep one key per quest/objective; repeated Lua keys overwrite earlier values.

NPC ID whose gossip should be closed automatically.

Prevents automatic skipping of cutscenes or videos.

Prompts use of the special extra action button.

Additional helper lines displayed in the current step panel. Supports numbered variants such as ExtraLineText2, ExtraLineText3, etc. Accepts localization keys or literal text.

Automatically select dialogue by option ID, rather than position.

Indicates vehicle status (1 = enter, 2 = stay in vehicle).

Limit the step purchase to this merchant NPC.

Keep the quest pickup visible but require manual acceptance.

Keep the quest hand-in visible but require manual interaction.

Displays one or more clickable image previews in the current step panel. Relative paths are resolved from APR-Core/assets/; full Interface\\... paths are also accepted.

NPC ID to mark with a raid icon.

Spell buttons keyed by quest ID or questID-objective. A value may be one spell or a nonempty list of spells, displayed in list order on the same step. Prefer numeric spell IDs; names must be understood by the client language. Keep one key per quest/objective; repeated Lua keys overwrite earlier values.

Automatically completes the step when the given spell is cast.

Text fragments used as completion triggers (TrigText, TrigText2, etc.).

Displays available gliders for controlled jumps.

Marks the step as part of a campaign.

Restricts based on whether the character is an allied race.

Require every enclosed condition table to match. Useful for repeated predicates such as several quest-presence checks.

Requires at least one alternative condition table to match, in addition to all other conditions on the step/group. An empty list never matches.

Exact effective level check. The player must be at least this level, but below the next whole level.

Require one or more classes; accepts tokens or class IDs.

Exclude one or more classes; route mismatches hide the route.

Restricts to a specialization ID. For routes, failing this condition makes the route disabled rather than hidden.

Require at least quantity items (default 1) in bags plus the saved character bank, using the same count as LootItems.

Visible only if the achievement is missing.

Requires the aura to be absent.

Requires a spell to be unknown by both the player and pet. With a list, none of the listed spells may be known. Uses the same spellbook wrapper as HasSpell.

Require one slot entry or a nonempty list (every entry must pass). Omit itemID for any item; invert = true negates that entry.

Compare a slot's stat token, QUALITY or LEVEL. A nonempty list requires every entry to pass. See resource fields below.

Restricts to a specific APR event mode, such as Remix.

Restricts to a faction ("Alliance" or "Horde").

Restricts to a gender (1 neutral, 2 male, 3 female).

Require Hardcore (true) or non-Hardcore (false). Clients without C_GameRules.IsHardcoreActive count as non-Hardcore.

Requires a specific achievement.

Requires a specific buff or aura.

Requires the player or pet to know a specific spell.

Minimum client interface version; route mismatches hide the route.

Requires at least one quest in the list to be completed.

Account-wide variant of IsOneOfQuestsCompleted.

Requires none of the listed quests to be completed (negates IsOneOfQuestsCompleted).

Account-wide variant of IsOneOfQuestsUncompleted.

Requires a single quest to be completed.

Requires the quest to be absent from this character's current log. Combine with IsQuestUncompleted to exclude completed quests too.

Requires the quest in this character's current log; account completion is not sufficient.

True for a quest in this character's log with completed objectives, or a quest already turned in by this character. A list requires every quest to be ready.

Requires all listed quests to be completed.

Account-wide variant of IsQuestsCompleted.

Requires at least one listed quest to still be incomplete.

Account-wide variant of IsQuestsUncompleted.

Requires a single quest to be incomplete.

Compare current item counts, summing itemIDs if supplied. Includes equipped items; optional bank/toy counting. See resource fields below.

Minimum level/XP threshold; see level requirement forms below.

Maximum level/XP threshold, inclusive.

Minimum level/XP threshold; keeps rewards eligible at higher levels.

Compare cash actually owned, in copper. See resource fields below.

Compare cash plus carried items' estimated vendor value; uses the same inventory/equipment rules as LootMoney.

Dynamic threshold for step Level, MinLevel, MaxLevel, SkipForLvl and Grind; see Configurable Level Profiles.

Invert the complete enclosed condition table.

Shows and executes the step only in one of these current player map IDs; otherwise skips it. Does not set navigation coordinates.

Specifies the chosen Loa in Zandalar (1 = Bwonsamdi, 2 = Rezan).

Prevents the optional group popup if a questline is intentionally skipped.

Require one or more races; accepts names or race IDs.

Shows the step only after the requested standing, renown level, or friendship rank has been reached.

Compare learned skill rank, or its cap with maximum = true. Accepts a key, skill ID or localized name; default rank is 1 and operator is >=.

Skips the step once the player's effective level is greater than or equal to the given value.

Skip once at least X primary professions are learned (positive integer). 2 keeps the step with zero or one profession. Cooking, fishing, first aid and archaeology never count.

Hides and skips the step once the requested standing, renown level, or friendship rank has been reached.

Hides and skips the step in any of these current player map IDs. Does not set navigation coordinates.

Require an exact client interface version.

Skips this step when the item cooldown exceeds the threshold on entry. Use spellID for a spell. Omit once to monitor continuously, for example < 300 on a farming/waiting step.

Internal index auto-generated during route packaging. Do not edit manually.

Legacy field for displaying a static localized helper line.

Legacy field for automatically selecting a gossip option by index.

Meaning of level: Friendship rank number shown for the NPC faction.

Meaning of level: Renown level shown on the major faction track.

Meaning of level: Standard standing ID from 1 through 8.

Standing ID: 8

Standing ID: 5

Standing ID: 1

Standing ID: 6

Standing ID: 2

Standing ID: 4

Standing ID: 7

Standing ID: 3

Reusable XP-bonus sources referenced by name in profiles.

Any listed active aura OR a true predicate activates the source once. Item ownership alone never activates a bonus.

Any listed active aura OR a true predicate activates the source once. Item ownership alone never activates a bonus.

Percentage contributed while active.

Achievement ID → percentage; highest completed tier wins, while the source must still be active.

Aura ID → percentage or stack-count tiers. Selects the highest active variant and highest matched stack tier; missing/restricted counts use one application.

Inclusive minimum and exclusive maximum; sources outside their range contribute nothing.

Inclusive minimum and exclusive maximum; sources outside their range contribute nothing.

Usable item IDs offered as optional reminders when the source's aura is absent.

Named profiles with bonuses = { "SourceName", ... } and levels = { [0] = 88, [20] = 87.25 }.

Named profiles with bonuses = { "SourceName", ... } and levels = { [0] = 88, [20] = 87.25 }.

[0] required. Greatest bonus breakpoint not exceeding the active total wins; no interpolation (12% uses 10%, if the next row is 20%).

Step fields Grind, Level, MinLevel, MaxLevel and SkipForLvl also accept { level = N, xp = signedInteger }. This extends the existing level resolver; numeric levels, fractional levels and named level profiles keep their behavior.