Playerbot Commands

'''Playerbot Commands''' is the command reference for controlling and managing Playerbots on the Shadowmourne Realm.

Shadowmourne uses the AzerothCore '''mod-playerbots''' system.

There are two different command types:

.playerbots commands — used for bot management and administration
bot chat commands — sent directly to Playerbots for movement, combat and AI behavior

Main Command

The primary Playerbots command is:

.playerbots

Depending on command parsing, abbreviated forms such as:

.pl

may also work.

The canonical registered command is:

.playerbots

Main Command Tree

.playerbots bot
.playerbots account
.playerbots rndbot
.playerbots gtask
.playerbots pmon
.playerbots debug

Playerbot Management

The main player-level bot command is:

.playerbots bot

Supported operations include:

.playerbots bot list
.playerbots bot reload
.playerbots bot tweak
.playerbots bot self
.playerbots bot add PLAYERNAME
.playerbots bot init PLAYERNAME
.playerbots bot remove PLAYERNAME
.playerbots bot addclass CLASSNAME

List Bots

.playerbots bot list

Displays bots available to the Playerbot manager.

This is useful for checking which characters are currently available for Playerbot control.

Add Bot

Syntax:

.playerbots bot add PLAYERNAME

Example:

.playerbots bot add Frostmage

Attempts to add the named character as a Playerbot.

Remove Bot

Syntax:

.playerbots bot remove PLAYERNAME

Example:

.playerbots bot remove Frostmage

Removes the specified character from Playerbot control.

This does not necessarily delete the character.

Initialize Bot

Syntax:

.playerbots bot init PLAYERNAME

Example:

.playerbots bot init Frostmage

Initializes Playerbot state for the selected character.

Use initialization commands carefully on established bots.

AddClass

The AddClass system creates or assigns a bot of a requested class.

Syntax:

.playerbots bot addclass CLASSNAME

Optional gender:

.playerbots bot addclass CLASSNAME male
.playerbots bot addclass CLASSNAME female

Numeric gender values may also be accepted:

.playerbots bot addclass CLASSNAME 0
.playerbots bot addclass CLASSNAME 1

Supported class names:

warrior
paladin
hunter
rogue
priest
shaman
mage
warlock
druid
dk

Examples:

.playerbots bot addclass warrior
.playerbots bot addclass priest female
.playerbots bot addclass dk male
.playerbots bot addclass mage

See AddClass Bots.

Account Commands

Playerbot account commands are:

.playerbots account setKey
.playerbots account link
.playerbots account linkedAccounts
.playerbots account unlink

These are player-level commands.

Set Security Key

Syntax:

.playerbots account setKey SECURITYKEY

Example:

.playerbots account setKey MyPrivateBotKey

Sets a Playerbot security key for account linking.

'''Never publicly share your security key.'''

Link Account

Syntax:

.playerbots account link ACCOUNTNAME SECURITYKEY

Example:

.playerbots account link MYALTACCOUNT MyPrivateBotKey

Links another account using its Playerbot security key.

See Playerbot Account Linking.

View Linked Accounts

.playerbots account linkedAccounts

Displays accounts linked to the current Playerbot account.

Unlink Account

Syntax:

.playerbots account unlink ACCOUNTNAME

Example:

.playerbots account unlink MYALTACCOUNT

Removes the selected account link.

Random Bot Commands

Random Bot administration uses:

.playerbots rndbot

These commands require Game Master access.

Supported operations include:

.playerbots rndbot stats
.playerbots rndbot update
.playerbots rndbot reset
.playerbots rndbot init
.playerbots rndbot refresh
.playerbots rndbot add
.playerbots rndbot remove

See Random Bots.

Random Bot Stats

.playerbots rndbot stats

Displays Random Bot statistics.

Random Bot Update

.playerbots rndbot update

Triggers Random Bot update processing.

Random Bot Refresh

.playerbots rndbot refresh

Refreshes Random Bot state.

Random Bot Add

.playerbots rndbot add

Adds Random Bot activity according to the configured Random Bot manager.

Random Bot Remove

.playerbots rndbot remove

Removes Random Bot activity according to the Random Bot manager.

Random Bot Init

.playerbots rndbot init

'''Warning:''' this is a powerful administrative command.

The Playerbots configuration warns that reinitializing Random Bots completely resets them.

Do not use this command casually on the live realm.

Random Bot Reset

.playerbots rndbot reset

Resets Random Bot state.

This should only be used by administrators who understand the effects.

Performance Monitor

Playerbot performance monitoring uses:

.playerbots pmon

Supported commands:

.playerbots pmon reset
.playerbots pmon tick
.playerbots pmon stack
.playerbots pmon toggle

These commands require Game Master access.

Reset

.playerbots pmon reset

Resets Playerbot performance statistics.

Tick

.playerbots pmon tick

Prints Playerbot tick performance information.

Stack

.playerbots pmon stack

Prints performance stack information.

Toggle

.playerbots pmon toggle

Enables or disables the Playerbot performance monitor.

Guild Task Command

.playerbots gtask

Passes commands to the Playerbot Guild Task system.

This requires Game Master access.

See Playerbot Guild Tasks.

Debug Commands

Playerbot debugging includes:

.playerbots debug bg

This accesses Playerbot battleground debugging tools.

Requires Game Master access.

Bot Chat Commands

Bot chat commands are different from .playerbots commands.

These are sent directly to a Playerbot.

Important commands include:

help
follow
stay
attack
co
nc
maintenance
autogear

Help

help

Requests Playerbot command help.

When unsure what a bot supports, this is the best command to try first.

Follow

follow

Orders the bot to follow its master.

Useful for:

traveling
regrouping
dungeon movement
recovering separated bots

Stay

stay

Orders the bot to remain in position.

Useful for:

healer positioning
ranged positioning
boss encounters
preventing unwanted movement

Attack

attack

Orders the bot to attack the master's selected target.

Combat Strategies

The combat strategy command is:

co

Typical syntax:

co +STRATEGY
co -STRATEGY

Example:

co +tank

Available strategies depend on class, specialization and AI configuration.

See Playerbot Strategies.

Non-Combat Strategies

The non-combat strategy command is:

nc

Typical syntax:

nc +STRATEGY
nc -STRATEGY

Non-combat strategies can affect behavior such as:

follow
questing
looting
food
mounting
buffs
travel
PvP behavior

See Playerbot Strategies.

Maintenance

maintenance

Runs Playerbot maintenance behavior when enabled.

Maintenance may manage:

spells
talents
bags
ammunition
food
consumables
potions
reagents
mounts
glyphs
gems
enchants
reputation
skills
pets
pet talents

See Playerbot Maintenance.

Autogear

autogear

Runs the automatic equipment system.

Autogear attempts to improve the bot's gear based on:

level
class
specialization
equipment slot
configured item-quality limits
configured item-level limits

See Playerbot Autogear.

Autogear BiS

The module also contains support for:

autogear bis

This uses the Playerbot Best-in-Slot gear database.

Availability depends on server configuration.

If BiS autogear is disabled, use:

autogear

Quick Reference

Player Commands

.playerbots bot list
.playerbots bot add PLAYERNAME
.playerbots bot init PLAYERNAME
.playerbots bot remove PLAYERNAME
.playerbots bot addclass CLASSNAME

.playerbots account setKey SECURITYKEY
.playerbots account link ACCOUNTNAME SECURITYKEY
.playerbots account linkedAccounts
.playerbots account unlink ACCOUNTNAME

Bot Chat Commands

help
follow
stay
attack
co
nc
maintenance
autogear

Game Master Commands

.playerbots rndbot stats
.playerbots rndbot update
.playerbots rndbot reset
.playerbots rndbot init
.playerbots rndbot refresh
.playerbots rndbot add
.playerbots rndbot remove

.playerbots pmon reset
.playerbots pmon tick
.playerbots pmon stack
.playerbots pmon toggle

.playerbots gtask
.playerbots debug bg

Main Command

Main Command Tree

Playerbot Management

List Bots

Add Bot

Remove Bot

Initialize Bot

AddClass

Account Commands

Set Security Key

Link Account

View Linked Accounts

Unlink Account

Random Bot Commands

Random Bot Stats

Random Bot Update

Random Bot Refresh

Random Bot Add

Random Bot Remove

Random Bot Init

Random Bot Reset

Performance Monitor

Reset

Tick

Stack

Toggle

Guild Task Command

Debug Commands

Bot Chat Commands

Help

Follow

Stay

Attack

Combat Strategies

Non-Combat Strategies

Maintenance

Autogear

Autogear BiS

Quick Reference

Player Commands

Bot Chat Commands

Game Master Commands

Related Pages