nchebrov/azerothcore_installer
1
0
Fork 0
mirror of https://github.com/hermensbas/azerothcore_installer.git synced 2026-01-13 00:28:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

wiki update

Browse Source
This commit is contained in:
bash
2025-08-10 13:21:27 +02:00
committed by GitHub
parent 1a1cdb8cff
commit 9a5c6c2685
7 changed files with 725 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
wiki/Home.md Normal file
View File

@@ -0,0 +1,12 @@
Welcome to the mod-playerbots wiki! If you are new to this project, it is strongly recommended to take the time to read through each section to get a better understanding of what you can or can't do with Playerbots as well as how best to configure your setup for success.
## [Playerbot Addons](https://github.com/liyunfan1223/mod-playerbots/wiki/Playerbot-Add%E2%80%90ons)
Recommended addons which allow for a smoother experience in controlling your Playerbots.
## [Playerbot Commands](https://github.com/liyunfan1223/mod-playerbots/wiki/Playerbot-Commands)
Available commands and strategies to best manage your Playerbots.
## [Playerbot Configuration](https://github.com/liyunfan1223/mod-playerbots/wiki/Playerbot-Configuration)
Recommended configuration and hardware for high server performance with Playerbots.

24
wiki/Playerbot-Addons-and-Sub‐Modules.md Normal file
View File

@@ -0,0 +1,24 @@
## Multibot (by Macx-Lio)
Multifunctional tool designed to help control your playerbots. Actively maintained.
* [MultiBot](https://github.com/Macx-Lio/MultiBot)
## Unbot (by Liyunfan)
Original Playerbot addon used to control your playerbots, not actively maintained.
* Chinese version: [Unbot Addon (zh)](https://github.com/liyunfan1223/unbot-addon).
* English version (translated by @Revision): [Unbot Addon (en)](https://github.com/noisiver/unbot-addon/tree/english).
## Other Recommended Addons
* https://gitlab.com/Tsoukie/compactraidframe-3.3.5
* https://github.com/Zidras/DBM-Warmane
## Recommended Modules
Mod Playerbot Level Brackets: Allows you to set the distribution of rndbots by level bracket.
* https://github.com/DustinHendrickson/mod-player-bot-level-brackets (by DustinHendrickson)
Mod Junk To Gold: Enables autosell of gray items providing QOL for players and reducing inventory buildup for bots.
* https://github.com/noisiver/mod-junk-to-gold (by Revision)
Mod Ollama Chat: Ollama LLM - Playerbot integration (warning - in early stages of development and very cpu/gpu intensive)
* https://github.com/DustinHendrickson/mod-ollama-chat (by DustinHendrickson)

358
wiki/Playerbot-Commands.md Normal file
View File

@@ -0,0 +1,358 @@
Playerbots are programmed to respond to chat commands. The Multibot and Unbot addons are 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
``.playerbots bot remove *`` | logout all altbots
``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`` | automatically gear your altbot, with quality based on your .conf settings AutoGearQualityLimit and AutoGearScoreLimit. Can also be used on rndbots, but they automatically do their own gear initilization upon level up.
``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`` | release spirit when dead
``revive`` | revive when near a spirit healer
``leave`` | leave party
``attack`` | attack selected target
``follow`` | run toward player (/w for individual or /p or /r for party/raid)
``flee`` | run toward player ignoring everything else (/w for individual or /p or /r for party/raid)
``stay`` | stay in place
``runaway`` | kite mob
``grind`` | 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
Furthermore, you can specify by group or type for some commands like "attack" and "follow", such as:
- "@group1 follow"
- "@group2 attack"
- "@tank follow"
- "@ranged attack"
- "@rangeddps attack"
- "@meleedps attack"
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 ignored spells list
``ss -[spell id]`` | remove spell from ignored spells list
``trainer`` | show what bot can learn from the selected trainer
``trainer learn`` | learn from the selected trainer
## Party/Raid Target Selection
command | action
:---|:---
``rti <icon>`` | sets the target icon for the bot to prioritize (icons: skull, cross, circle, star, square, triangle, diamond, and moon)
``attack rti target`` | commands bots to attack their rti target
``<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
``rtsc cancel`` | cancel rtsc toggle
``rti cc <icon>`` | sets a specific icon as the cc target (the default is moon)
Video demonstration:
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 ?
```
### Combat Strategies
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)
``caster`` | wasn't in docs but is in game
``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
``frost``, ``fire`` | mage only
``bear``, ``cat``, ``caster`` | druid only
``bdps`` | buff dps (paladin will use seal of might)
``bspeed`` | buff movement speed (hunter only)
``bhealth``, ``bmana`` | buff health or mana (paladin will use seal of light vs seal of wisdom)
``rfire``, ``rfrost``, ``rshadow``, ``rnature`` | resistance strategies (paladin auras and hunter aspects)
``meta melee`` | default strategy for demonology warlocks, makes warlock go melee while using metamorphosis and immolation aura (demonology warlock only)
``trap weave`` | enables the trap weave strat for hunters, dropping an explosive trap as part of their rotation (hunter only)
``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)
### Non-Combat Strategies
General (WIP)
strategy | description
:---|:---
``food`` | initiate or stop eating/drinking
``pvp`` | turn on or off pvp mode
``loot`` | enable looting everything by bots. For add or remove that strategy for randombots is required GM level > 1
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.
strategy | description
:---|:---
mc | enable Molten Core strats (Note: Baron Geddon only, rest are beatable without 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)
voa | enable Vault of Archavon strats (Note: up to Emalon)
naxx | enable Naxxramas strats (Note: only certain bosses, rest are beatable without 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
uld | enable Ulduar strats (Note: Strats implemented up to Hodir and Freya, WIP on future bosses)
onyxia | enable Onyxia's Lair strats
icc | enable Icecrown Citadel strats (Note: all normal mode currently doable, HC is WIP)
### Defaults
- Tank classes default w/ ``tank aoe``
- Non-tank classes default w/ ``attack weak``
- Strategies that are incompatible, such as ``stay`` and ``follow``, are ignored
## 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
## 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)
## Hunter Pet Commands
command | action
:---|:---
``pet name "name"`` | summon a tameable pet by name
``pet id "id"`` | summon a tameable pet by database creature ID
``pet family "family"`` | randomly summon a tameable pet of the given family
``pet 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)
## 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, you have to logout to turn this off, dont run it twice without doing so (it wont toggle it back off like its supposed to, it actually seems to apply multiple AI's onto yourself all fighting to do different things, sounds fun until it crashes the server)
``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
## Overrides
You can override everything and instruct the bot to do something specific:
command | description
:---|:---|
``do attack`` | attack target
``do loot`` | loot target
``do attack my target`` | attack my target
``do add all loot`` | check every corpse and game object for loot
## Example Macros
To make bots flee with you from the danger:
```
/p reset
/p nc -stay,+follow,+passive
/p co +passive
/p do follow
```
To make bots follow you and assist you in attack:
```
/p nc -stay,+follow,-passive
/p co -passive
/p do follow
```
To make bots stay in place and assist you in attack:
```
/p nc -follow,+stay,+passive
/p co +passive
/p do stay
```
## Help
The bot can tell you all available commands it will accept:
```
/w help
```
## 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
## Rndbot Console Only Commands
command | action
:---|:---
``playerbot pmon toggle`` | enables/disables the performance monitor
``playerbot pmon stack`` | displays the performance monitor, useful to show which actions/triggers cost the most performance
``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.

237
wiki/Playerbot-Configuration.md Normal file
View File

@@ -0,0 +1,237 @@
## Bot activity profiles and performance
Before going into the configuration options we need explain the logic abit. Every update tick of the server its calculated whether a bot can
or can't be active. An active bots takes and eats alot more resources then an idle bot.
The following logic is applied to determine whether a bot is active or not, applied in the explained order.
```
1. NOT ACTIVE: When server uptime smaller then (max amount of bots * 0.12 seconds)
2. ALWAYS ACTIVE: When bot is in battleground, instance or raid.
3. ALWAYS ACTIVE: When in combat and not in party (defend urself)
4. ALWAYS ACTIVE: If the zone where the bot is located has real players
5. ALWAYS ACTIVE: When the bots is a member of a guild with real players
6. ALWAYS ACTIVE: Has real player as master
7. ALWAYS ACTIVE: if grouped and the leader is a real player
8. ALWAYS ACTIVE: if in battleground queue
9. ALWAYS ACTIVE: if looking for group
10. ALWAYS ACTIVE: If bot has a real player within the radius 300 yards
11. ALWAYS ACTIVE: When bot is on a friendlist of a online real player
12. ALWAYS ACTIVE: When bot has more then 10 other bots within the sightDistance, force to spread out
```
These rules will always be applied regardless what value you have configured **'AiPlayerbot.BotActiveAlone'**.
***
All remaining situations e.g. bots in zones or maps without real players, empty server etc will be configured
based on the **'AiPlayerbot.BotActiveAlone'** value. That value basically means that the bot has about
% chance to get active for only a few seconds. Unless in those few seconds one of the above rules
is triggered then it might result staying active longer.
Then **'AiPlayerbot.botActiveAloneSmartScale'** basically auto scale the activity percentages
based on the latency, relative to the configured value of **'AiPlayerbot.BotActiveAlone'**. And only when the bots are in level scope of the configured values of:
* **'AiPlayerbot.botActiveAloneSmartScaleWhenMinLevel'**
* **'AiPlayerbot.botActiveAloneSmartScaleWhenMinLevel'**
***
#### 1. best performance with high bot count.
My personal preference is that i keep my bots idle when i am not in the zone or map, which is applied with the following config
and in this specific requirement it doesnt rlly matter autoscale is on or off but i leave it on.
```
AiPlayerbot.BotActiveAlone = 10
AiPlayerbot.botActiveAloneSmartScale = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMinLevel = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMaxLevel = 80
```
#### 2. Default; best effort to enforce 100% acitivity but auto adjust when needed
(prolly best profile with a server with more real players spread over different zones and maps).
When you want all bots active in all situations but you want to server to compensate the bot
acitivity based on your latency then use (basically best effort for 100%) :
```
AiPlayerbot.BotActiveAlone = 100
AiPlayerbot.botActiveAloneSmartScale = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMinLevel = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMaxLevel = 80
```
#### 3. All bots active regardless your latency and performance impact.
```
AiPlayerbot.BotActiveAlone = 100
AiPlayerbot.botActiveAloneSmartScale = 0
AiPlayerbot.botActiveAloneSmartScaleWhenMinLevel = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMaxLevel = 80
```
#### 4. All bots active and only apply autoscale on a level range (e.g. high levels)
```
AiPlayerbot.BotActiveAlone = 100
AiPlayerbot.botActiveAloneSmartScale = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMinLevel = 75
AiPlayerbot.botActiveAloneSmartScaleWhenMaxLevel = 80
```
***
#### Verify bot performance
Use the command '.server info' to see your server latency. The general latency should be under 70-80 and the percentiles maxed out around
100, 120, 150. Next to that verify how quick a bot executes your command. It should be pretty much instant. If not to should choose a different profile
and/or lower your bot amount.
If you dont use these performance checks it might result into strange and incorrect bot behaviours and/or huge amount of memory footprint growth in a relative short time (OOM)
##### Reference
I use 'profile 1' with 5000 bots with an AMD 5700x (4.6ghz, 6 cores), linux, 20GB mem with the following result:
![image](https://github.com/user-attachments/assets/6760feaf-3dc7-4d7a-9534-d4183ff43284)
## Recommended hardware
```
Memory
minimal: 16GB (when all map grids are loaded 11-12GB)
preferable: 32GB or more
CPU cores:
minimal: 4 cores
preferable: 6 or more cores
CPU speed:
minimal: 3000mhz
preferable: 4400mhz or more
```
## Recommended config
worldserver.conf
```bash
# bots might not pickup quests in certain condidations
Quests.IgnoreAutoAccept = 1
# performance
PreloadAllNonInstancedMapGrids = 0
SetAllCreaturesWithWaypointMovementActive = 0
DontCacheRandomMovementPaths = 0
MapUpdate.Threads = 4 or 6
MapUpdateInterval = 10
MinWorldUpdateTime = 1
# no player limit for the bots
PlayerLimit = 0
# prevent buggy situations
LeaveGroupOnLogout.Enabled = 1
```
playerbots.conf
```bash
#-------------------------------------------------------------------
# general
#-------------------------------------------------------------------
AiPlayerbot.Enabled = 1
AiPlayerbot.DeleteRandomBotAccounts = 0
AiPlayerbot.RandomBotAccountPrefix = "rndbot"
#-------------------------------------------------------------------
# randombots
# - RandomBotMaps: 0=Eastern Kingdoms, 1=Kalimdor, 530=Outland, 571=Northrend
#-------------------------------------------------------------------
AiPlayerbot.RandomBotMinLevel = 1
AiPlayerbot.RandomBotMaxLevel = 80
AiPlayerbot.AutoTeleportForLevel = 1
AiPlayerbot.RandomBotMaps = 0,1,530,571
AiPlayerbot.ProbTeleToBankers = 0.25
AiPlayerbot.RandomBotMaxLevelChance = 0.01
AiPlayerbot.RandomBotFixedLevel = 0
AiPlayerbot.DisableRandomLevels = 0
AiPlayerbot.RandombotStartingLevel = 5
AiPlayerbot.SyncLevelWithPlayers = 0
AiPlayerbot.DisableDeathKnightLogin = 1
AiPlayerbot.SyncQuestWithPlayer = 1
AiPlayerbot.AutoDoQuests = 1
#-------------------------------------------------------------------
# command (gear: 1 = normal, 2 = uncommon, 3 = rare, 4 = epic, 5 = legendary)
#-------------------------------------------------------------------
AiPlayerbot.AutoGearQualityLimit = 4
AiPlayerbot.AutoGearScoreLimit = 0
AiPlayerbot.AutoGearCommand = 1
AiPlayerbot.MaintenanceCommand = 1
AiPlayerbot.AllowPlayerBots = 1
AiPlayerbot.AllowGuildBots = 1
#-------------------------------------------------------------------
# chat and broadcast (default; RepeatDelay = 2000)
#-------------------------------------------------------------------
#AiPlayerbot.RepeatDelay = 2000
AiPlayerbot.EnableBroadcasts = 0
AiPlayerbot.RandomBotTalk = 0
AiPlayerbot.RandomBotEmote = 0
AiPlayerbot.RandomBotSuggestDungeons = 0
AiPlayerbot.EnableGreet = 0
AiPlayerbot.ToxicLinksRepliesChance = 0
AiPlayerbot.ThunderfuryRepliesChance = 0
AiPlayerbot.GuildRepliesRate = 0
AIPlayerbot.GuildFeedback = 0
AiPlayerbot.RandomBotSayWithoutMaster = 0
#-------------------------------------------------------------------
# intervals
#-------------------------------------------------------------------
AiPlayerbot.RandomBotUpdateInterval = 20
AiPlayerbot.RandomBotCountChangeMinInterval = 1800
AiPlayerbot.RandomBotCountChangeMaxInterval = 7200
AiPlayerbot.MinRandomBotInWorldTime = 3600
AiPlayerbot.MaxRandomBotInWorldTime = 1209600
AiPlayerbot.MinRandomBotRandomizeTime = 7200
AiPlayerbot.MaxRandomBotRandomizeTime = 1209600
AiPlayerbot.RandomBotsPerInterval = 60
AiPlayerbot.MinRandomBotReviveTime = 60
AiPlayerbot.MaxRandomBotReviveTime = 300
AiPlayerbot.MinRandomBotTeleportInterval = 3600
AiPlayerbot.MaxRandomBotTeleportInterval = 18000
AiPlayerbot.RandomBotInWorldWithRotationDisabled = 31104000
#-------------------------------------------------------------------
# distance
#-------------------------------------------------------------------
AiPlayerbot.FarDistance = 20.0
AiPlayerbot.SightDistance = 75.0
AiPlayerbot.SpellDistance = 28.5
AiPlayerbot.ShootDistance = 26.0
AiPlayerbot.ReactDistance = 150.0
AiPlayerbot.GrindDistance = 75.0
AiPlayerbot.HealDistance = 38.5
AiPlayerbot.LootDistance = 25.0
AiPlayerbot.FleeDistance = 8.0
AiPlayerbot.TooCloseDistance = 5.0
AiPlayerbot.MeleeDistance = 1.5
AiPlayerbot.FollowDistance = 1.5
AiPlayerbot.WhisperDistance = 6000.0
AiPlayerbot.ContactDistance = 0.5
AiPlayerbot.AoeRadius = 10
AiPlayerbot.RpgDistance = 200
AiPlayerbot.AggroDistance = 22
#-------------------------------------------------------------------
# performance related
#-------------------------------------------------------------------
AiPlayerbot.BotActiveAlone = 10 (either use 10% or 100% anything is between is kinda useless)
AiPlayerbot.botActiveAloneSmartScale = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMinLevel = 1
AiPlayerbot.botActiveAloneSmartScaleWhenMaxLevel = 80
PlayerbotsDatabase.WorkerThreads = 1
PlayerbotsDatabase.SynchThreads = 2
```
## Memory footprint
The memory footprint does grow in most cases. Consider restarting your server every x hours depending on your
configuration, hardware, player base/usage.
e.g. with a cronjob
..

1
wiki/Playerbot-Macro-Collection.md Normal file
View File

@@ -0,0 +1 @@
### todo

50
wiki/Playerbot-Queries.md Normal file
View File

@@ -0,0 +1,50 @@
### clear bots
```bash
USE `acore_playerbots`;
DELETE FROM `playerbots_random_bots`;
DELETE FROM `playerbots_account_type`;
USE `acore_characters`;
DELETE FROM `characters` WHERE `account` IN (SELECT `id` FROM `acore_auth`.`account` WHERE `username` LIKE 'RNDBOT%') OR `account` NOT IN (SELECT `id` FROM `acore_auth`.`account`);
DELETE FROM `arena_team_member` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `arena_team` WHERE `arenaTeamId` NOT IN (SELECT `arenaTeamId` FROM `arena_team_member`);
DELETE FROM `character_account_data` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_achievement` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_achievement_progress` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_action` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_aura` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_glyphs` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_homebind` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `item_instance` WHERE `owner_guid` NOT IN (SELECT `guid` FROM `characters`) AND `owner_guid` > 0;
DELETE FROM `character_inventory` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_pet` WHERE `owner` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `pet_aura` WHERE `guid` NOT IN (SELECT `id` FROM `character_pet`);
DELETE FROM `pet_spell` WHERE `guid` NOT IN (SELECT `id` FROM `character_pet`);
DELETE FROM `pet_spell_cooldown` WHERE `guid` NOT IN (SELECT `id` FROM `character_pet`);
DELETE FROM `character_queststatus` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_queststatus_rewarded` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_reputation` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_skills` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_social` WHERE `friend` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_spell` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_spell_cooldown` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_talent` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `corpse` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `groups` WHERE `leaderGuid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `group_member` WHERE `memberGuid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `mail` WHERE `receiver` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `mail_items` WHERE `receiver` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `guild` WHERE `leaderguid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `guild_bank_eventlog` WHERE `guildid` NOT IN (SELECT `guildid` FROM `guild`);
DELETE FROM `guild_member` WHERE `guildid` NOT IN (SELECT `guildid` FROM `guild`) OR `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `guild_rank` WHERE `guildid` NOT IN (SELECT `guildid` FROM `guild`);
DELETE FROM `petition` WHERE `ownerguid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `petition_sign` WHERE `ownerguid` NOT IN (SELECT `guid` FROM `characters`) OR `playerguid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_arena_stats` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
DELETE FROM `character_entry_point` WHERE `guid` NOT IN (SELECT `guid` FROM `characters`);
USE `acore_auth`;
DELETE FROM `account` WHERE `username` LIKE 'RNDBOT%';
DELETE FROM `realmcharacters` WHERE `acctid` NOT IN (SELECT `id` FROM `account`);
```
[Thanks to noisiver@Revision](https://github.com/noisiver/codebase/blob/master/SQL%2FAzerothCore%2Fdelete_playerbots.sql)

43
wiki/Playerbot-Raid-Completion-Status.md Normal file
View File

@@ -0,0 +1,43 @@
## Raid Completion Status
This page is intended to keep track of raids that are currently possible to complete with playerbots and note which raids have active strategies implemented. A pure list of implemented raid strategies can be found here: https://github.com/liyunfan1223/mod-playerbots/wiki/Playerbot-Commands#raid-specific-strategies
"Unknown" denotes raids that have not been thoroughly tested and verified.
## Vanilla
Raid | Completion Status | Notes
:---|:---|:---
``Molten Core`` | Completable | Raid strategy implemented for: Baron Geddon. Otherwise every boss is defeatable with minimal knowledge and planning.
``Blackwing Lair`` | Completable | Raid strategy implemented for: added automatic Onyxia Scale Cloak buff to playerbots, bots automatically disable suppression devices, and bots automatically clear Brood Affliction: Bronze on Chromaggus. Otherwise every boss is defeatable with minimal to moderate knowledge and planning.
``Zul'Gurub`` | Completable | No raid strategies implemented. Every boss is defeatable with minimal to moderate knowledge and planning.
``Ruins of Ahn'Qiraj`` | Completable | Raid strategy implemented for: Ossirian. Otherwise every boss is defeatable with basic knowledge and planning.
``Ahn'Qiraj`` | WIP | Needs strategies. No strategies implemented at this time. Every boss up to Twin Emperors and C’thun is completable
``Naxxramas`` | Not supported |
## Burning Crusade
Raid | Completion Status | Notes
:---|:---|:---
``Karazhan`` | Completable | No strategies implemented, but bosses are doable with little to significant planning depending on the boss. Chess event not coded but is possible to solo.
``Magtheridon`` | Completable | No strategies implemented, but they are not needed. Boss is defeatable with moderate knowledge and planning.
``Gruul’s Lair`` | Completable | No strategies implemented, but they are not needed. Every boss is defeatable with moderate knowledge and planning.
``Serpentshrine Cavern`` | Unknown | Unknown
``Hyjal Summit`` | Unknown | Unknown
``Tempest Keep`` | Unknown | Unknown
``Black Temple`` | Unknown | Unknown
``Zul’Aman`` | Unknown | Unknown
``Sunwell Plateau`` | Unknown | Unknown
## Wrath of the Lich King
Raid | Completion Status | Notes
:---|:---|:---
``Naxxramas`` | Completable | Raid strategy implemented for: most bosses. Otherwise every boss is defeatable with moderate knowledge and planning. Not applicable for 40 man
``Vault of Archavon`` | WIP | Raid strategy implemented for: Emalon. Needs more strategies. Archavon is defeatable with minimal knowledge and planning.
``Obsidian Sanctum`` | Completable | Raid strategy implemented for: Sartharion up to two drakes. Must kill Vesperon first.
``Eye of Eternity`` | Completable | Raid strategy implemented for: Malygos.
``Ulduar`` | WIP | Raid strategy implemented for: Up to General Vezax.
``Trial of the Crusader`` | WIP | Needs strategies.
``Onyxia’s Lair`` | Completable | Raid strategy implemented for: Onyxia.
``Icecrown Citadel`` | Completable | All necessary raid bosses have implemented raid strategies. Heroic mode is still WIP.
``Ruby Sanctum`` | Unknown | Unknown