This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Playerbots are programmed to respond to chat commands. The Multibot addon is designed to handle most of the common chat commands for the player, but you may still have need for manual chat commands as you play. It is important to distinguish between "Altbots" and "Rndbots": Altbots are manually player-created bots on a normal account, whereas "Rndbots" and their accounts are automatically generated based on .conf settings. Rndbots will automatically gear themselves, apply talents, and roam the world whereas Altbots will not.

Altbot Setup Commands

Altbots are characters that you create on your account (or others) first, and then get assigned bot control via the commands below.

command	action
.playerbots bot add [name1,name2,name3]	login altbots. Note that you are also able to login altbots from other accounts depending on your configurations.
.playerbots bot addaccount [accountname]	login an entire account of altbots. Depending on your configurations you can login other accounts.
.playerbots bot remove name1,name2,name3	logout altbots
.playerbots bot add *	login all altbots that are in your party/raid
.playerbots bot remove *	logout all altbots that are in your party/raid
.playerbots bot refresh=raid *	unbind all saved instances from all altbots that are in your party/raid. WARNING: This function is not perfect yet. If you are already in a raid, after the command is executed, the AI ​​needs to go back online or exit the raid and re-enter.
maintenance	enable altbot to learn all available spells and skills, supplement consumables, enchant gear, and repair. Can also be used on rndbots, but they automatically do this. Whisper for an individual bot or use /p or /r to simultaneously target multiple bots.
autogear [option]	automatically gear your altbot, Quality based on AutoGearQualityLimit and AutoGearScoreLimit. Options: a quality color/level (eg. green/uncommon, artifact, heirloom), match to match the master average item level, an item level such as autogear 200, reset to strip all gear and regear from scratch (combinable, e.g. autogear reset green), or bis/bis 245 to pull from the playerbots_bis_gear table (requires AiPlayerbot.AutoGearBisCommand = 1 and AutoGearQualityLimit = 4, falls back to plain autogear when no tier matches).
talents	check current spec of bot
talents spec list	check specs available for the class
talents spec [spec name]	force bot to change their talents to the chosen spec, see the .conf for list of spec names or whisper your bot "talents spec list"
talents apply <link>	apply talents link to bot
glyphs	lists the bot’s currently equipped glyphs in the client locale, using item links for proper translations
glyph equip [GlyphID1 GlyphID2 GlyphID3 GlyphID4 GlyphID5 GlyphID6]	bot applies given glyphs
reset botAI	reset bot settings
reset	reset current bot actions like casting spell, moving etc.

AddClass Setup Command

AddClass bots utilize unused Rndbots in your system. They are currently recommended only to be used for testing purposes i.e. quickly forming a raid group to test certain bots in a given raid, whereas Altbots are strongly recommended for long-term progression playthroughs.

command	action
.playerbots bot addclass [className]	summon a new Rndbot of the desired class (note: death knight syntax is dk, otherwise the rest are standard)

Party/Raid General Commands

command	action
summon	summon bot to you (see .conf for different options to configure this command)
release	bot will release spirit when dead
revive	revive bot when near a spirit healer
leave	bot will leave party
attack	attack selected target; no action override and no error message if it fails
do attack my target	overrides current actions and attack selected target, will tell you if it fails
follow	bot will run toward player (/w for individual or /p or /r for party/raid)
flee	bot will run toward player ignoring everything else (/w for individual or /p or /r for party/raid)
stay	bot will stay in place
runaway	bot will kite mob // note: currently non-functional
grind	bot will attack anything
disperse set x	force bots to maintain a distance of x yards from each other
disperse disable	resets disperse distance to default value
give leader	if bot is party/raid leader it will pass it to their master
lfg	bot joins the requester's group/raid, filling an open tank/healer/dps slot
lfg x	same as above but targets a specific group/raid size [5,10, 20, 25, 40]
help	the bot will tell you all available commands it will accept

Furthermore, you can specify by group or type for some commands like "attack" and "follow", such as:

• "@group1 follow"
• "@group2 attack"

This following are other groups that can be targeted:

• @tank, @dps, @heal, @ranged, @rangeddps, @meleedps, @[className]

You can also command multiple groups at a time like below:

• "@Group1,4"
• "@group2-5,8"

Playerbot Spell Commands

command	action
spells	show bot's spells
cast [spell_name]	/w a bot to cast a spell
cast [spell_name] on [PlayerName]	/w a bot to cast a spell on a specified Player
ss +[spell id]	add spell to exclude spells list
ss -[spell id]	remove spell from exclude spells list
ss reset	removes all spells from exclude spells list
trainer	show what bot can learn from the selected trainer
trainer learn	learn from the selected trainer

Party/Raid Target Selection

RTSC is a system that enables players to save locations for specified bots to go to using the "aedm" spell that is given when the "rtsc" command is used. Aedm is a spell you use to point and click a particular location that can be saved and used via some of the commands below.

RTI is a system that enables players to focus bots on specified targets using standard WoW icons.

command	action
rtsc	toggles on rtsc and gives players the "aedm" spell which will appear in the general category of their spellbook
rtsc cancel	toggles off rtsc and removes the "aedm" spell from the spellbook
rtsc save [#]	while rtsc is enabled, this command will save a location as the specified number when the player uses the aedm spell and clicks on a location
rtsc unsave [#]	clears the saved location
rtsc go [#]	command bots to go to the saved location, this command can be whispered to individual bots or filtered in party/raid chat with the same chat filters listed in Party/Raid General Commands (e.g., "@Tank rtsc go 5" will send all tanks to saved location 5)
[name/group] rtsc toggle	toggles the ability to point and click with mouse button to save a location for specified bots to move to, can specify by group or class (ie "@druid rtsc toggle" or "@group1 rtsc toggle")
rtsc go save	command bots to move back into saved rtsc position
rti <icon>	sets the target icon for the bot to prioritize (icons: skull, cross, circle, star, square, triangle, diamond, and moon)
do attack rti target	overrides current actions and commands bots to attack their assigned rti target, will tell you if it fails
rti cc <icon>	sets a specific icon as the cc target (the default is moon)
focus heal +[PlayerName]	add a party/raid member to the bot's focus heal target list. While focus heal targets are set, healer bots and bots using offheal will prioritize healing only the listed players.
focus heal -[PlayerName]	remove a player from the focus heal target list
focus heal +[Player1],+[Player2],-[Player3]	add or remove multiple players in one command. Names must be members of the bot's current group or raid.
focus heal ?	show the bot's current focus heal target list
focus heal clear	clear all focus heal targets
focus heal none	clear all focus heal targets
focus heal unset	clear all focus heal targets

Video guide: https://www.youtube.com/watch?v=Pwt7schIC08

Strategies

The bots are programmed to respond to triggers by listing possible actions and choosing one based on a strategy. Bots use two categories of strategies: combat and non-combat. You can add, subtract, or toggle strategies using the combat (co) and non-combat (nc) prefixes in your commands:

co +strategy1,-strategy2,~strategy3
nc +strategy1,-strategy2,~strategy3

You can query the bot to report what strategies are currently being used:

co ?
nc ?

You can reset specific strategy type:

co !
nc !

Combat Strategies

General

strategy	description
tank	use threat-generating abilities (warrior, paladin, druid will use bear)
tank assist	make tank pull mobs off of others
dps	use dps abilities (rogue, hunter, shaman, priest, druid will use cat)
cc	use cc abilities (requires cc rti target, default is moon icon; it is useful to know that bots will not attack rti target and will not try to use cc if target is not stunnable)
assist	target one mob at a time
aoe	target many mobs at a time
boost	bots will use big cds (useful to use -boost and +boost on macros to control when to burst on bosses)
threat	dps will actively avoid grabbing threat (useful for bosses that wipe aggro or if tanks are struggling to hold aggro)
grind	attack any visible target, then switch to another one and so on.
heal	focus on party healing (shaman, priest, druid, paladin)
focus	stop casting aoe spell or debuff spells on multiple attackers (focus on the single target)
avoid aoe	automatically avoid the majority of harmful aoe spells
save mana	healers save mana by prioritizing high-efficiency spells when mana falls below a threshold
healer dps	healers cast damage spells if they have enough mana
tank face	ensure the current target does not face ranged players in the group (to counter breath and cleave-like spells)
behind	move to the target's back (rear flank) when they are not positioned behind the target
wait for attack	bots will wait setted time before they start attack/heal in combat. Time is set via command wait for attack time 5 where 5 is time which they wait in seconds
pull	tank bot will pull mob using range skill. Commands pull my target or pull rti target
pull back	together with pull strategy bot will pull mob using range skill and back to point here he started pull
mark rti	Enables the bot to automatically mark unmarked combat attackers (prioritizing the lowest health one) with its configured rti icon.

Druid

strategy	description
bear, cat, caster	dictates overall strategy for druids, note that these are already handled by their talent selection
feral charge	enables Feral Charge in the cat/bear rotation (feral only, enabled by default; disable with co -feral charge to keep the druid out of dangerous melee zones like Anub'arak's locust swarm or Iron Council's overload)
tranquility	enables Tranquility in the resto healing rotation (resto only, enabled by default; disable to suppress the cast on raid-wide damage or heavy-movement phases where it underperforms — in 25-man it only heals the druid's own party)
blanketing	resto druid pre-hots tanks, then melee, then ranged with Wild Growth and Rejuvenation regardless of current health to maximize Revitalize uptime (resto only, enabled by default)

Hunter

strategy	description
trap weave	enables the trap weave strat for hunters, dropping an explosive trap as part of their rotation (hunter only)

Mage

strategy	description
frost, fire	mage only, note that these are already handled by their talent selection
firestarter	enables the firestarter strat for fire mages, resulting in the mage going into melee to utilize the instant cast flamestrike from the firestarter talent (fire mage only)

Shaman

strategy	description
[totem name]	shaman will add totem into their call of the elements cast (ie "co +tremor" will add that totem for the shaman)

Warlock

strategy	description
meta melee	default strategy for demonology warlocks, makes warlock go melee while using metamorphosis and immolation aura (demonology warlock only)

Non-Combat Strategies

Note: Altbots do not autonomously grind and quest like Rndbots do. However, you can currently somewhat achieve this by inviting your Altbots into party/raid (or whispering outside of party if only 1 Altbot) and using the command below and then you can disband the party/raid. "/p nc +new rpg,+grind,-follow"

General

strategy	description
new rpg	bot will follow the new rpg strategy which includes questing and works in conjunction with the grind strategy
grind	bot will seek nearby level appropriate targets to grind
follow	bot will follow master
food	initiate or stop eating/drinking
pvp	turn on or off pvp mode
loot	enable looting everything by bots. Note: adding or removing that strategy for randombots requires GM level

Priest

strategy	description
rshadow	priest will cast shadow protection

Paladin

strategy	description
bmight, bwisdom, bkings, bsanc	paladin blessing strategies (might, wisdom, kings, and sanctuary respectively)
rfire, rfrost, rshadow, baoe, barmor, bcast, bspeed	paladin aura strategies (fire, frost, shadow, retribution, devotion, concentration, and crusader aura respectively)

Hunter

strategy	description
bdps, bspeed, bmana, rnature	hunter aspect strategies (dragonhawk/hawk, pack/cheetah, viper, and wild respectively)

Warlock Pet Strategies (Note that defaults are as follows: Affliction uses felhunter, Demonology uses felguard, and Destruction uses imp)

strategy	description
imp	force warlock to use imp
voidwalker	force warlock to use voidwalker
succubus	force warlock to use succubus
felhunter	force warlock to use felhunter
felguard	force warlock to use felguard

Warlock Soulstone Strategies

strategy	description
ss master	force warlock to use soulstone on master
ss self	force warlock to use soulstone on self
ss tank	force warlock to use soulstone on tank
ss healer	force warlock to use soulstone on healer

Raid-Specific Strategies

Note: These raid strategies are now automatically applied upon entering the instance. You should receive a whisper from your bots confirming activation.

Classic

strategy	description
moltencore	enable Molten Core strats
onyxia	enable Onyxia's Lair strats
bwl	enable Blackwing Lair strats (Note: grants Onyxia Scale Cloak buff to all bots, bots automatic disabling of suppression devices, and bots automatically clear Brood Affliction: Bronze on Chromaggus)
aq20	enable Ruins of Ahn'Qiraj strats (Note: Ossirian only, rest are beatable without strats)

The Burning Crusade

strategy	description
karazhan	enable Karazhan strats
gruulslair	enable Gruul's Lair strats
magtheridon	enable Magtheridon's Lair strats
ssc	enable ssc strats
tempestkeep	enable Tempest Keep: The Eye strats
hyjal	enable The Battle for Mount Hyjal strats
blacktemple	enable Black Temple strats
zulaman	enable Zul'Aman strats
tbc-mech	enable Tempest Keep: The Mechanar strats
tbc-seth	enable Auchindoun: Sethekk Halls strats
tbc-ac	enable Auchindoun: Auchenai Crypts strats

Wrath of the Lich King raids

strategy	description
naxx	enable Naxxramas strats
wotlk-os	enable Obsidian Sanctum strats (Note: strat is only functional up to OS+2, need to kill Vesperon first)
wotlk-eoe	enable Eye of Eternity strats
ulduar	enable Ulduar strats (Note: all bosses except for Algalon are doable)
voa	enable Vault of Archavon strats (Note: up to Emalon)
icc	enable Icecrown Citadel strats
rs	enable Ruby Sanctum strats

Wrath of the Lich King dungeons

strategy	description
wotlk-uk	enable Utgarde Keep strats
wotlk-up	enable Utgarde Pinnacle strats
wotlk-nex	enable The Nexus strats
wotlk-occ	enable The Oculus strats
wotlk-an	enable Azjol-Nerub strats
wotlk-ok	enable Ahn'kahet: The Old Kingdom strats
wotlk-dtk	enable Drak'Tharon Keep strats
wotlk-cos	enable The Culling of Stratholme strats
wotlk-gd	enable Gundrak strats
wotlk-hos	enable Halls of Stone strats
wotlk-hol	enable Halls of Lightning strats
wotlk-vh	enable Violet Hold strats
wotlk-toc	enable Trial of the Champion strats
wotlk-fos	enable The Forge of Souls strats
wotlk-pos	enable Pit of Saron strats

Loot

You can control which items to loot (ll stands for loot list):

command	action
nc +loot	activate looting (note grind strategy activates looting as well)
ll all	loot everything
ll normal	loot anything except BOP (bind-on-pickup) items
ll gray	loot only gray items
ll quest	loot only quest items
ll skill	loot only items based on their skills (herbalism, mining, or skinning)
ll [item]	add specific item to loot list
ll -[item]	remove specific item from loot list

Items

command	action
[item]	bot will tell you how many it has, and quest status
e [item]	equip item
ue [item]	unequip item
u [item]	use item
u [item] [target]	use item on target (use gem on item)
open items	open items in inventory that have loot, ie Satchel of Spoils
destroy [item]	destroy item roll [item]
roll [item]	bots in party/raid will roll for the linked item if it is an upgrade for them
roll	bots in party/raid will all roll
s [item]	sell item
s *	sell all grey items
s vendor	sell all items that can be sold
b [item]	buy item
2g 3s 5c	give you gold
bank [item]	deposit item in bank
bank -[item]	withdraw item from back
gb [item]	deposit item in guild bank
gb -[item]	withdraw item from guild bank
outfit ?	List your saved outfits and show outfit usage help.
outfit <name> +[item]	Add the linked item(s) to outfit  (creates it if new).
outfit <name> -[item]	Remove the linked item(s) from outfit .
outfit <name> equip	Equip the items saved in outfit .
outfit <name> replace	Unequip everything currently worn, then equip outfit .
outfit <name> update	Overwrite outfit  with the bot's currently equipped items.
outfit <name> reset	Clear all items from outfit .

Item Keywords

Anywhere a command takes [item] you can use a category keyword instead of an item link. These are handled by the shared item parser, so they work with gb, bank, s, b, e, destroy, mail and the loot list, not just one command.

category	keywords
quality	poor/gray/grey, normal/common/white, uncommon/green, rare/blue, epic/violet/purple, legendary/yellow/orange, artifact, heirloom
trade goods	cloth, leather, metal/stone/ore, meat, herb, elemental, enchanting/disenchants
consumables	potion, elixir, flask, scroll, food, bandage, enchant
projectiles	arrows, bullets
equipment slots	head, neck, shoulder, shirt, chest, waist, legs, feet, wrist, hands, finger 1, finger 2, trinket 1, trinket 2, back, main hand, off hand, ranged, tabard
recipes	recipe matches only recipes the bot can actually use, recipe all matches every recipe in the bags for moving or trading them in bulk

Examples: gb herb deposits all herbs into the guild bank, gb recipe all deposits every recipe, s gray sells all grey items.

Note: gems and jewels are not keywords. Gems are their own item class rather than a trade goods subclass, so there is no trade goods match that would catch them.

Quests

command	action
quests	show quest summary
quests all	shows a list with links of all quests in quest log
accept [quest]	accept quest at the selected quest giver
accept *	accept all quests at the selected quest giver
drop [quest]	abandon quest
r [item]	choose quest reward
[quest]	show quest and objectives status
talk	talk to the selected npc (to complete a quest)
u [game object]	use game object (use "los" command to obtain the game object link)

General Pet Commands

command	action
pet aggressive	changing pet stance on aggresive
pet passive	changing pet stance on passive
pet defensive	changing pet stance on defensive
pet stance	display current pet stance
pet attack	pet attack selected target
pet follow	pet follow his master
pet stay	pet stay in place

Hunter Tame Commands

command	action
tame	tame help
tame name "name"	summon a tameable pet by name
tame id "id"	summon a tameable pet by database creature ID
tame family	tame family help
tame family "family"	randomly summon a tameable pet of the given family
tame rename "new name"	rename the current pet and refresh its name in the client UI

Account linking for Altbot control

As an alternative to controlling the characters from your own account or guild member accounts, this allows to link up different accounts together to allow control of the characters as Altbots. This is based on the AiPlayerbot.AllowTrustedAccountBots = 1 option in the playerbots config file.

command	action
.playerbots account setKey somePlayerDefinedSecurityKeyValue	Define a securityKey for the current account (the key will be overridden when defined multiple times)
.playerbots account link ACCOUNTNAME somePlayerDefinedSecurityKeyValue	Link an account by using its securityKey
.playerbots account linkedAccounts	Shows a list of accounts, which are currently linked with this account
.playerbots account unlink ACCOUNTNAME	Remove a linked account (this will remove the link for both sides, ensuring that access to the characters can be canceled from both sides anytime)

Professions

strategy	description
master fishing	The strategy is automatically added when EnableFishingWithMaster is enabled in the config. Strategy can be added manually. Strategy is automatically removed if further than EndFishingWithMaster from water. Strategy also overrides the follow distance to FishingDistanceFromMaster.

Miscellaneous Commands

command	action
los	list game objects, items, creatures and npcs the bot can see
stats	show stat summary (inventory, gold, xp, etc.)
home	set home at the selected innkeeper
playerbot bot initself	CAREFUL WITH THIS - re-rolls YOUR character
playerbot bot list	lists your altbots (and your other characters you can add as bots if you have that enabled, but I'd be very careful if you do that as you can then re-roll your other characters using the init command)
playerbot bot tweak	sets the tweakvalue (seems to be related to a config value that's no longer present and the variable it changes doesn't seem to actually do anything anymore)
playerbot bot self	make yourself into a bot, use it again to disable
playerbot bot lookup	doesn't do anything but print out a useless usage message (which says you're supposed to give it a class parameter but doing so doesn't change anything because the function called is literally just the usage message there's no functionality there)
.playerbots bot init=rare name1,name2,name3	respawn bot at your level with talents & rare gear (gearing currently bugged, recommend autogear instead)
who	show bot race, spec, talents, class, level, average item level, current zone
who [profession name]	show bot profession skill level

RPG Commands

command	action
rpg status	report the bot's current rpg state
rpg status idle	put the bot into the idle state
rpg status rest	put the bot into the rest state
rpg status wander random	send the bot wandering to a random destination
rpg status wander npc	send the bot wandering toward nearby npcs
rpg status go grind	send the bot to a grind position. Whispers back if no grind position is available
rpg status go camp	send the bot to a camp position. Whispers back if no camp position is available
rpg status travel flight	send the bot to travel by flight path. Whispers back if no flight path is available
rpg status outdoor pvp	put the bot into the outdoor pvp state
rpg status do quest	switch to the do quest state, picking the first quest in the bot's log that has usable objective locations. Whispers back if it cannot find one
rpg status do quest [id]	switch to the do quest state on a specific quest id (a plain number, not a link). The bot must already be on that quest and it must be incomplete or complete, otherwise it whispers back "Invalid quest"
rpg do quest [id]	switch to the do quest state on any valid quest, given as an id or a quest link. Unlike rpg status do quest, the bot does not have to already be on the quest, and this command is not restricted to the master or a GM

Reactions

The bots will automatically do certain things based on what the party leader is doing.

your action	bot reaction
accept a quest	bot will accept it as well
talk to a quest giver	bot will turn in his completed quests
use meeting stone	teleport using the stone
start using game object and interrupt	use the game object
open trade window	show inventory and start trading
invite to a party/raid	accept the invitation
start raid ready check	tell his ready status
mount/unmount	mount/unmount as well
go through a dungeon portal	follow into the dungeon

Console Only Commands

command	action
playerbot pmon toggle	enables/disables the performance monitor
playerbot pmon stack	shows cumulative performance since toggled on
playerbot pmon tick	shows cycle performance averages per update
playerbot pmon reset	resets the performance monitor
playerbot rndbot reset	clears acore_playerbots.playerbots_random_bots table (seems to contain events) and requires server restart after
playerbot rndbot stats	prints rndbot stats (numbers of rndbots per level, per class, etc)
playerbot rndbot reload	reloads playerbots.conf
playerbot rndbot update	triggers a "full tick" (call to RandomPlayerbotMgr::UpdateAIInternal())
playerbot rndbot init	re-rolls the rndbots (useful when you've modified settings like min/max level, the spec probabilities, etc)
playerbot rndbot clear	reset bots back to starting level (55 for Deathknight)
playerbot rndbot level	level up all rndbots by 1
playerbot rndbot refresh	revives rndbots if dead, uses botAI->Reset(), rerolls gear, while keeping the same level
playerbot rndbot teleport	teleports all bots to appropriate area for level
playerbot rndbot revive	(BUGGED: will double number of rndbots) revive rndbot, refresh, and teleport (combo of "refresh" and "teleport")
playerbot rndbot grind	(BUGGED: crashes server) teleport rndbot only if needed (needs more testing)
playerbot rndbot change_strategy	re-roll whether bots are grinding or RPG'ing (based on AiPlayerbot.RandomBotRpgChance setting)

Special thanks to Whipowill for creating the original Playerbots Operators Manual https://github.com/whipowill/wow-addon-playerbots/blob/master/MANUAL.md, fuzz1111 for contributing many confirmed active commands, and Ky for testing many old and new commands.