Status LoginPlay Now
FrozenThrone Wiki › Playerbot Commands
Log in

Historical Revision

Playerbot Commands

Revision 1 · Aug 23, 2026, 8:58 PM · GRANDPAGAMER

Back to History
You are viewing an older revision of this page.

'''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.'''

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.

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