For each objective, the best Behavior Handler is automatically chosen by QuestBotAlternative, and it is tasked with creating a sequence of actions to take to handle a specific quest. eg, go over there and click that tree.

The most common handlers used in behavior overrides are: Kill, CollectItem, UseQuestItemOnTarget, NPCGossip, UseQuestItemAtLocation

All handlers now support multiple ID's. Use a comma to separate them.

eg: <objective ... ID="1234,1235,1236,1239" handler="Kill">

Many handlers work without any options or settings at all, but some require very specific details. Some also allow you to change their actions using handler_options in each objective. Multiple handler_options can be specified separated by a comma.

eg: <objective .... handler_options="WaitTime=5000,MeleRange"

CastSpellOnTarget

CastSpellOnTarget moves into range and casts a predefined spell on a target.

casts only on units.

used with behaviour override handler only.

<Objective ... ID="...id of target..." handler="CastSpellOnTarget" handler_options="spell=12345|Magic Missle">

requires: ID - the entry id of the unit to

requires: handler="CastSpellOnTarget"

requires: handler_options="spell=" identifying the spell id or exact the spell name (case sensitive).

CollectIntermediateItemsThenUse

CollectIntermediateItemsThenUse identifies quests that require you to collect specific items that require you to click or click a quest object to combine them to complete the quest.

requires ID to match the id in your bags, not a game object's ID.

used automatically when a quest has type="CollectIntermediateItem" objectives and you're already carnying the right number of items to fulfil the objectives. See CollectItem.
used with a behaviour override by setting handler for a quest.

<Quest handler="CollectIntermediateItemsThenUse">

requires: ID - the entry id of the item to collect. this item is clicked on once the quest objective is completed.

CollectItem

CollectItem collects objects until this objective is complete. These include world game objects, items carried by friendly or neutral units (it can detect a few cases), or items themselves (unlikely to exist in the game world).

see similar handler: QuestKillUnitToCollectItem

used automatically when an objective is of type CollectItem or CollectIntermediateItem, and the ID matches a world game object.

used with a behavior override by setting type (prefered) or handler, and ID to a world game object

<Objective ... ID="...game object..." type="CollectItem">

requires: ID - the entry id of the world game object to collect.

EscortFollow

Follows and attempts to protect an escort target.

<Objective ... ID=".. id of escort npc .." handler="EscortFollow" handler_options="AttemptTimelimit=12345">

Requires: ID - the entry id of the npc you're meant to be escorting.

Optional: AttemptTimelimit - Limit how long we will follow the target for (milliseconds) (default: no limit).

Interact

Moves within interact range of a target, and right clicks it.

<objective ... ID="..." handler="Interact" handler_options="WaitTime=1000,OnTop">

requires: ID - the entry id of the unit or world game object to interact with.

optional: WaitTime - time in milliseconds to wait after interacting

optional: OnTop - stand virtually on top of the target before interacting. Normally Interact detects the normal interact range, but for a few buggy quests this isn't close enough!

Kill

Kill is the primary handler for any kill quest.

it is automatically chosen if the ID matches the entry id, faction id of another matching unit (disabled) or the group id (not faction id) of a hostile unit in game.

used with a behavior override by setting the type and ID

<Objective ... ID="... unit id ..." handler="kill">
requires: ID, the entry of the mob to kill

KillUnitToCollectItem

Kills units that drop a quest item.

automatically detects attackable units that drop a item identified by ID with the objective type CollectItem or CollectIntermediateItem.

can be used with a behavior override that forces this handler with any objective type.

<Objective ... ID="... item id ..." type="CollectItem">

requires: ID - the entry id of the item to collect (not the mob to kill)

NPCGossip

NPCGossip interacts with a unit and randomly chooses from their available gossip entries (those entries with the white speech bubble).

If an option causes a StaticPopup1 to be visible ("Are you sure you wish to pay 1 copper to this beggar") it will select the left most button, usually "Accept"

Automatically detects some friendly units that require interaction. However so far this detection has been unreliable.

Behavior overrides are the primary method of triggering this handler.

<Objective ... ID=".. id of NPC to gossip with ..." handler="NPCGossip" handler_options="wait_time=5000,index=2,AtLocation=1,2,3">

If the NPC has no gossip options the handler stops automatically.

requires: ID - the entry id of the friendly NPC to gossip with.

optional: wait_time - A time in milliseconds to wait after the gossip frame has closed (NPCGossip will select random options until the frame closes). Used for those quests with lenghty role-play.

optional: index - Instead of at random, always select this gossip entry (usually unnecessary). Indexes are in the same order as displayed in WoW, but contrary to everything else in game, these can sometimes start at 0!

use + to separate multiple indexes in a row for those dialogues that have multiple pages of options. eg: 0+3. Click the first gossip option then on the next page click the forth.

optional: AtLocation - a location to move to before interacting with the target. this option prevents the use of MoveToInteractRange, so the location must be within range!

PurchaseItemFromVendor

Purchases an item from a vendor. What did you think it would do?

Used by behavior overrides only.

<Objective ... ID="... id of NPC vendor to buy from ..." handler="PurchaseItemFromVendor" handler_options="item=12345,count=1">

requires: ID - the entry id of the NPC to purchase from

requires: item - the entry id of the item to purchase

optional: count - the number of that item to purchase (default is 1)

QuestTypeSpecialA

Moves to a location and dismounts.

SpecialA is a type of quest where all you have to do is go somewhere. The quest automatically completes itself once you get there.

<Objective ... handler="QuestTypeSpecialA" handler_options="WaitTime=3000">
    <AreaPoints>
        <Hotspot ... />
    <AreaPoints>
</Objective>

Requires at least 1 x Hotspot. If multiple Hotspots are supplied it tries them all until the object is complete, starting at the closest.

Optional: WaitTime - time in milliseconds to wait after reaching hotspot. Defaults to 3000.

UseItem

See UseQuestItemOnTarget - you probably want to use it instead.

Uses an item that you must be carrying at least 1 of and that is on cooldown.

Because it requires no travelling it is treated as a high priority objective.

Probably best used with a condition, otherwise it'll probably keep using it over and over.
<Objective ... ID=".. entry id of item .." handler="UseItem" count="1" handler_options="AtLocation=1,2,3,WaitTime=5000,ClickRemoteLocation=1,2,3" conditions="!Me.HasAura(12345)">
Requires: ID - the id of the item you wish to use.

Requires: count - only use the item(s) if we're carrying this many.

Optional: AtLocation - a place to move to before attempting to use the item.

Optional: WaitTime - how long to wait after using item. Default 5000 milliseconds.

Optional: ClickRemoteLocation - specifies the point to click for ClickRemoteLocation items (for example, a grenade).

UseQuestItemAtLocation

Used for those quests where you have to go somewhere and simply click your quest item (StartingItemId).

<Objective ... handler="UseQuestItemAtLocation" handler_options="WaitTime=15000">
    <AreaPoints>
        <Hotspot ... />
    </AreaPoints>
</Objective>

Requires a quest with a StartingItemId.

Requires at least 1 x AreaPoint (If you supply multiple AreaPoints then one will be chosen at random)

Unlike most behavior handlers, ID is not required.

Optional: WaitTime - time to wait after using quest item. Defaults to 15000.

UseQuestItemOnTarget

Moves into range, faces and then uses a quest item on a target unit or object.
<Objective ... ID="..." hander="UseQuestItemOnTarget" />
Requires a quest with a StartingItemId.
Requires: ID - the entry id of the object or unit the quest item is to be used on.

If the quest item is a ClickRemoteLocation item this handler will click the location of the target (for example, throw a grenade at target).

The option DuringCombat="True" is assumed if no handler_options are included.

handler_options="IsAlive"
If the target is a unit, only target them when they're alive.
(default)
handler_options="IsDead"
If the target is a unit, only target them when they're dead.
handler_options="PullRange"
Move into pull range before using quest item.
(default)
handler_options="MeleRange"
Some quest items require you to be standing in mele range before they work.
handler_options="AtLocation=123,566,788"
Use the quest item while standing at this location.
handler_options="NoMovement"
Prevent handler from attempting to move into range before using item.
Probably only useful for Taxi related quests.
handler_options="WaitTime=5000"
Wait X milliseconds after using the quest item.
This handler attempts to use the quest item multiple times if it isn't on cooldown. WaitTime is also used to override the time between attempts.
(default = 3000)
handler_options="PullDistance=15"
Used if you need to controll the pull distance for this objective.
For example a quest where you need to throw a grenade at 10-20 yards away. Further than mele, and less than pull range.
Don't forget options like IgnoreCombat and DuringCombat can be used with every handler and are especially useful here.

VehicleAttack

Used to control a vehicle.

<Objective ... ID=".. id of targets to attack .." handler="VehicleAttack" handler_options="NoMovement,RangedAttack,button_priority=231,ExactHotspot=1,2,3" conditions="Me.HasAura(.. id of vehicle aura, depends on the vehicle ..)" />

Requires ID - the entry id of the unit you want to attack

Optional NoMovement - don't attempt to move.

Optional RangedAttack - move to pull range rather than mele range to attack (mele range the default)

Optional button_priority - which abilities to do in order (default: use buttons randomly)

Optional ExactHotspot - only attack mobs if they're at this exact location (within 0.5 yards)

RawQueueCreator

An advanced option used as a last resort, allowing actions to be taken when no other handler can fulfill the role.

QueueItemTypes are not documented here. It is a publicly accessible enum, so reference in visual studio or something if you wish to see them.

Attempts to automatically use xml attributes to match and set each QueueItem's properties.

<Objective .... handler="RawQueueCreator">
	<Queue>
		<QueueItem index="0" type="MoveTo" X="1914.765" Y="-2644.561" Z="59.82264" />
		<QueueItem index="1" type="MoveToInteractRange" ID="45400"  />
		<QueueItem index="2" type="Interact" ID="45400" />
		<QueueItem index="3" type="Wait" wait_timer="1000"  />
		<QueueItem index="4" type="QuestGossip"  />
	</Queue>
</Objective>

Dont Use:

Done use these. These overrides are either automatic and not meant to be used in an override, or have been replaced, still exist, but are not meant to be used anymore.

LootUnit

Loot unit automatically detects units nearby that need looting.

Uses the builtin HB looting blacklist to avoid buggy mobs that cant be looted.

Vendor

UseQuestItemOnUnitWitoutAura

Dont use.

use UseQuestItemOnUint with conditions="Target.HasAura(1234)" instead

NoObjectivesUseQuestItemAtLocation

Automatically detects quests with a quest item, that has no objectives. These sort of quests are almost a use quest item at location type quest.

See UseQuestItemAtLocation.

ItemStartsAQuest

ItemStartsAQuest detects if you've looted a quest item, and need to click it pick up its quest.

This is automatic, you shouldn't need to use this.

If you've already completed the quest the handler will destroy the item instead.

SpellPracticeCreditObjective

Exists for the quests in each racial starting zone that requires you to attack a target dummy for a while.

UseGameObject

Used to detect and use (interact) with world game objects that might be for a quest objective.

See Interact