PlayerBot module forked from https://github.com/celguar/mangosbot-bots
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Cyberium 90ba744584 Guild: Update quest item counters when sharing part of a stack
Splitting a stack between bots skipped the quest checks done for a whole stack. A giver left with
4 of 5 quest items kept its quest complete and a receiver brought to 5 of 5 kept it incomplete.
2026-11-11 19:11:57 +01:00
.github/workflows Build: Attempt macOS fix 2025-11-28 10:55:23 +01:00
ahbot AhBot: Cache trade skill misses so each item is scanned once (#400) 2026-10-27 17:40:10 +01:00
docs PartyBot: Added old-partybot compatibility 2026-11-11 13:15:54 +01:00
playerbot Guild: Update quest item counters when sharing part of a stack 2026-11-11 19:11:57 +01:00
sql [Feature] Replace hunter boot enchant (#391) 2026-10-06 08:36:27 +02:00
.gitattributes Tweak ai->InterruptSpell 2023-12-19 05:11:13 +03:00
.gitignore -Merge fix 2023-05-05 15:11:37 +02:00
botpch.cpp Improvement for CMaNGOS merge 2024-03-04 21:41:35 +01:00
botpch.h BUILD: expand botpch.h with additional core, playerbot, and STL headers (#224) 2025-11-30 09:59:25 +01:00
CMakeLists.txt Install the bundled AhBot config template (#369) 2026-09-23 07:34:55 +02:00
README.md Update README.md 2024-03-01 09:57:26 +00:00

Playerbots

Bot AI Core from ike3 for cmangos classic, tbc and wotlk

This system brings the following features:

  • Populate the open world with playerbots
  • Populate BGs and Arenas with playerbots
  • Use alt characters as playerbots
  • Do any kind of PvE content (with some guidance on complex mechanics)
  • Very detailed configurations of playerbot behaviors (for the min-maxers out there :D)
  • Multiple commands to request playerbots do what you require

How to install

Compiling Code

If you're new to building CMaNGOS, check the official guide https://github.com/cmangos/issues/wiki/Installation-Instructions

Important: to enable the playerbots you need to check it in cmake ( BUILD_PLAYERBOTS ✅ )

After successful build get aiplayerbot.conf file from "src/modules/Bots/playerbot/aiplayerbot%expansion.conf.dist" (based on expansion you use) and put it to the same folder where mangosd.conf and realmd.conf are, and remove ".dist" from its name

Apply DB modifications

  • Using the InstallFullDB.sh script:

    1. Execute the script once to generate the InstallFullDB.config file, after that close the script
    2. Edit InstallFullDB.config and add PLAYERBOTS_DB="YES" at the end and save it
    3. Depending on if you have a previous installation or want to do a fresh installation:
      • For a fresh install pick the option 4) Full installation
      • To install only the playerbots DB pick the option 5) Advanced DB management and then 8) Create and fill playerbots db
  • Manually:

    1. Go to "src/modules/Bots/sql"
    2. Apply .sql files from "characters" folder to characters database
    3. Apply .sql files from "world" folder to world database

    IMPORTANT: There are several .sql files that are in a vanilla, tbc or wotlk folder. You should only use the files in the folder for the core expansion you are currently using.

After you complete all steps above you can check bots config and start your server. It'll take some time for the first time, as gear/characters for bots will be generated at first launch. Have fun! 🥳

How to Use