Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
7d50cee
Update RandomPlayerbotFactory.cpp
IainD92 Oct 1, 2025
8a68de4
Update RandomPlayerbotFactory.cpp
IainD92 Oct 1, 2025
444be29
v2
IainD92 Oct 1, 2025
24f841f
Verbose logging.
IainD92 Oct 1, 2025
0e4c759
Wishmaster update
IainD92 Oct 2, 2025
3f050a4
Change LOG_INFO to LOG_DEBUG
IainD92 Oct 7, 2025
1d19dea
Update RandomPlayerbotFactory.cpp
IainD92 Oct 22, 2025
cb099bc
Update repository condition for C++ job
kadeshar Nov 1, 2025
586c4d9
- Added codestyle azerothcore python script
kadeshar Nov 1, 2025
bbbf71d
- added missing var for codestyle azerothcore
kadeshar Nov 1, 2025
12a5132
Merge pull request #1793 from kadeshar/codestyle-azerothcore
noisiver Nov 1, 2025
f7fea45
Fix PositionInfo constructors' members order (#1776)
privatecore Nov 2, 2025
43164e7
Normalize line endings for 2025_10_27_00_ai_playerbot_german_texts.sq…
noisiver Nov 2, 2025
7d5c9e3
Update 2025_10_27_00_ai_playerbot_german_texts.sql
Raz0r1337 Nov 4, 2025
d9f0d5a
Merge pull request #1808 from Raz0r1337/typo_fix
kadeshar Nov 4, 2025
e35900f
Merge pull request #1699 from IainD92/RandomBotGuildTotals_fix
kadeshar Nov 4, 2025
983a55d
Implement Gruul's Lair strategy (#1647)
brighton-chi Nov 4, 2025
26a135a
Rewrite RandomPlayerbotFactory for improved maintainability and futur…
privatecore Nov 4, 2025
80dbd22
Fixes equip bug with random suffix rings (#1757)
avirar Nov 4, 2025
d02d61e
Implement Magtheridon strategy (#1721)
brighton-chi Nov 5, 2025
ce51191
Fix. Leave group actions (#1774)
Celandriel Nov 5, 2025
85c7009
Codestyle fix (#1797)
kadeshar Nov 5, 2025
e5bc495
Fixed codestyle fix (#1815)
kadeshar Nov 7, 2025
9c8ba42
FIX: Battlegrounds - Unset bot's master when current master left BG (…
nl-saw Nov 11, 2025
a37dd2b
Clarify random bot timing configuration section and parameter descrip…
biship Nov 11, 2025
0729d14
Fix PlayerbotAI constructors' members order and wrong type comparison…
privatecore Nov 12, 2025
08c739f
Align index with section update (#1831)
brighton-chi Nov 14, 2025
cadbcbd
fix: Resolved an issue where the open spell was being cast by bots on…
SmashingQuasar Nov 15, 2025
6effabf
Core - Fix Bots can pickup the flag in Eye of the Strom instantly, wi…
Wishmaster117 Nov 15, 2025
ce2a990
README.md edits (#1779)
Vortikai Nov 15, 2025
610a032
Bots fly/follow (movePoint core refactor), water walking fixes (#1825)
hermensbas Nov 16, 2025
05057ae
feat: Improve bot mount behavior to faster close distance between bot…
icemansparks Nov 16, 2025
e88c1b7
Minor README.md corrections (#1849)
Vortikai Nov 18, 2025
bb5ed37
Update codestyle_cpp.yml for review events and concurrency (#1836)
nl-saw Nov 18, 2025
27311b7
Revert "feat: Improve bot mount behavior to faster close distance bet…
nl-saw Nov 18, 2025
8e03371
Balance-Druid-improve-Starfall-usage-and-add-CC-safety (#1713)
gacuna89 Nov 19, 2025
0b1b0ea
Core - Fix RTSC SeeSpellAction crash on malformed WorldPacket (#1841)
Wishmaster117 Nov 21, 2025
0c1700c
CORE - Improved language detection for bots (#1784)
Wishmaster117 Nov 21, 2025
d97870f
fix: warning updating movement flags while rooted (#1858)
hermensbas Nov 21, 2025
10213d8
Add thread safety for group operations (#1816)
blinkysc Nov 21, 2025
cf743a1
Fix Wrong Misdirection Spell ID for Gruul's Lair and Magtheridon Stra…
brighton-chi Nov 23, 2025
2424f73
Core Merge PR - Replace OnPlayerChat with OnPlayerCanUseChat (#1838)
Celandriel Nov 23, 2025
d5dbc4d
Hotfix: prevent server crash when whisper 'logout' (#1874)
Celandriel Nov 24, 2025
38e2d85
Add missing break in ApplyInstanceStrategies (#1887)
brighton-chi Nov 28, 2025
52c3e96
Rename groupmaster to groupleader and related variables. (#1875)
Celandriel Dec 3, 2025
353c29d
Bug: Fix bots leaving LFG groups before master (#1876)
Celandriel Dec 8, 2025
e5b2791
Improve Molten Core Strategy (#1852)
HennyWilly Dec 8, 2025
dde1667
Fix: Stop pets from fighting in PVP prohibited zones (#1829)
NoxMax Dec 8, 2025
bb569b4
Fix: Arena - PersonalRating and MMR issue for bot teams (#1789)
icemansparks Dec 8, 2025
910b8a9
fix: Made bots roll in a more reasonable time on group loots. (#1857)
SmashingQuasar Dec 9, 2025
9bd94cb
Merge branch 'UNMERGED-no-pvp-near-fly-inn' into true-master
NoxMax Dec 10, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions .github/workflows/codestyle_cpp.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
name: C++ Codestyle
on:
pull_request:
types:
- opened
- reopened
- synchronize
- ready_for_review
paths:
- src/**
- "!README.md"
- "!docs/**"

concurrency:
group: "codestyle-cppcheck-${{ github.event.pull_request.number }}"
cancel-in-progress: true

jobs:
triage:
runs-on: ubuntu-latest
name: C++
if: github.event.pull_request.draft == false
steps:
- uses: actions/checkout@v4
- name: Setup python
uses: actions/setup-python@v5
with:
python-version: '3.10'
- name: AzerothCore codestyle
run: python ./apps/codestyle/codestyle-cpp.py
- name: C++ Advanced
run: |
sudo apt update -y
sudo apt install -y cppcheck
cppcheck --force --inline-suppr --suppressions-list=./.suppress.cppcheck src/ --output-file=report.txt

if [ -s report.txt ]; then # if file is not empty
cat report.txt
exit 1 # let github action fails
fi
1 change: 1 addition & 0 deletions .suppress.cppcheck
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
cppcheckError
49 changes: 23 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
|
<a href="https://github.com/mod-playerbots/mod-playerbots/blob/master/README_CN.md">中文</a>
|
<a href="https://github.com/brighton-chi/mod-playerbots/blob/readme/README_ES.md">Español</a>
<a href="https://github.com/mod-playerbots/mod-playerbots/blob/master/README_ES.md">Español</a>
</p>


Expand All @@ -18,25 +18,27 @@
</div>

# Playerbots Module
`mod-playerbots` is an [AzerothCore](https://www.azerothcore.org/) module that adds player-like bots to a server. The project is based off [IKE3's Playerbots](https://github.com/ike3/mangosbot) and requires a custom branch of AzerothCore to compile and run: [mod-playerbots/azerothcore-wotlk/tree/Playerbot](https://github.com/mod-playerbots/azerothcore-wotlk/tree/Playerbot).
`mod-playerbots` is an [AzerothCore](https://www.azerothcore.org/) module that adds player-like bots to a server. The project is based off [IKE3's Playerbots](https://github.com/ike3/mangosbot).

Features include:

- The ability to log in alt characters as bots, allowing players to interact with their other characters, form parties, level up, and more;
- Random bots that wander through the world, complete quests, and otherwise behave like players, simulating the MMO experience;
- Bots capable of running most raids and battlegrounds;
- Highly configurable settings to define how bots behave;
- Excellent performance, even when running thousands of bots.
- The ability to log in alt characters as bots, allowing players to interact with their other characters, form parties, level up, and more
- Random bots that wander through the world, complete quests, and otherwise behave like players, simulating the MMO experience
- Bots capable of running most raids and battlegrounds
- Highly configurable settings to define how bots behave
- Excellent performance, even when running thousands of bots

**This project is still under development**. If you encounter any errors or experience crashes, we kindly request that you [report them as GitHub issues](https://github.com/mod-playerbots/mod-playerbots/issues/new?template=bug_report.md). Your valuable feedback will help us improve this project collaboratively.

`mod-playerbots` has a **[Discord server](https://discord.gg/NQm5QShwf9)** where you can discuss the project, ask questions, and get involved in the community!
We also have a **[Discord server](https://discord.gg/NQm5QShwf9)** where you can discuss the project, ask questions, and get involved in the community!

## Installation

### Classic Installation
Supported platforms are Ubuntu, Windows, and macOS. Other Linux distributions may work, but may not receive support.

**All `mod-playerbots` installations require a custom branch of AzerothCore: [mod-playerbots/azerothcore-wotlk/tree/Playerbot](https://github.com/mod-playerbots/azerothcore-wotlk/tree/Playerbot).** This branch allows the `mod-playerbots` module to build and function. Updates from the upstream are implemented regularly to this branch. Instructions for installing this required branch and this module are provided below.

### Cloning the Repositories

As noted above, `mod-playerbots` requires a custom branch of AzerothCore: [mod-playerbots/azerothcore-wotlk/tree/Playerbot](https://github.com/mod-playerbots/azerothcore-wotlk/tree/Playerbot). To install the module, simply run:
To install both the required branch of AzerothCore and the `mod-playerbots` module from source, run the following:

```bash
git clone https://github.com/mod-playerbots/azerothcore-wotlk.git --branch=Playerbot
Expand All @@ -48,7 +50,7 @@ For more information, refer to the [AzerothCore Installation Guide](https://www.

### Docker Installation

**Docker installation is considered experimental.** To install the module on a Docker installation, run:
Docker installations are considered experimental (unofficial with limited support), and previous Docker experience is recommended. To install `mod-playerbots` on Docker, first clone the required branch of AzerothCore and this module:

```bash
git clone https://github.com/mod-playerbots/azerothcore-wotlk.git --branch=Playerbot
Expand Down Expand Up @@ -85,28 +87,23 @@ Use `docker compose up -d --build` to build and run the server. For more informa

## Documentation

The [Playerbots Wiki](https://github.com/mod-playerbots/mod-playerbots/wiki) contains an extensive overview of addons, commands, raids with programmed bot strategies, and recommended performance configurations. Please note that documentation may be incomplete or out-of-date in some sections. Contributions are welcome.
The [Playerbots Wiki](https://github.com/mod-playerbots/mod-playerbots/wiki) contains an extensive overview of AddOns, commands, raids with programmed bot strategies, and recommended performance configurations. Please note that documentation may be incomplete or out-of-date in some sections, and contributions are welcome.

## Frequently Asked Questions
Bots are controlled via chat commands. For larger bot groups, this can be cumbersome. Because of this, community members have developed client AddOns to allow controlling bots through the in-game UI. We recommend you check out their projects listed in the [AddOns and Submodules](https://github.com/mod-playerbots/mod-playerbots/wiki/Playerbot-Addons-and-Sub%E2%80%90Modules) page.

- **Why aren't my bots casting spells?** Please make sure that the necessary English DBC file (enUS) is present.
- **What platforms are supported?** We support Ubuntu, Windows, and macOS. Other Linux distros may work, but will not receive support.
- **Why isn't my source compiling?** Please ensure that you are compiling with the required [custom branch of AzerothCore](https://github.com/mod-playerbots/azerothcore-wotlk/tree/Playerbot). Additionally, please [check the build status of our CI](https://github.com/mod-playerbots/mod-playerbots/actions). If the latest build is failing, rever to the last successful commit until we address the issue.
## Contributing

## Code standards
- https://www.azerothcore.org/wiki/cpp-code-standards
This project is still under development. We encourage anyone to make contributions, anything from pull requests to reporting issues. If you encounter any errors or experience crashes, we encourage you [report them as GitHub issues](https://github.com/mod-playerbots/mod-playerbots/issues/new?template=bug_report.md). Your valuable feedback will help us improve this project collaboratively.

## Addons
If you make coding contributions, `mod-playerbots` complies with the [C++ Code Standards](https://www.azerothcore.org/wiki/cpp-code-standards) established by AzerothCore. Each Pull Request must include all test scenarios the author performed, along with their results, to demonstrate that the changes were properly verified.

Typically, bots are controlled via chat commands. For larger bot groups, this can be unwieldy. As an alternative, community members have developed client Add-Ons to allow controlling bots through the in-game UI. We recommend you check out their projects:
We recommend joining the [Discord server](https://discord.gg/NQm5QShwf9) to make your contributions to the project easier, as a lot of active support is carried out through this server.

- [Multibot](https://github.com/Macx-Lio/MultiBot) (by Macx-Lio), which includes English, Chinese, French, German, Korean, Russian, and Spanish support [note: active development is temporarily continuing on a fork in Macx-Lio's absence (https://github.com/Wishmaster117/MultiBot)]
- [Unbot Addon (zh)](https://github.com/liyunfan1223/unbot-addon) (Chinese version by Liyunfan) [note: no longer under active development]
- [Unbot Addon (en)](https://github.com/noisiver/unbot-addon/tree/english) (English version translated by @Revision) [note: no longer under active development]
Please click on the "⭐" button to stay up to date and help us gain more visibility on GitHub!

## Acknowledgements

`mod-playerbots` is is based off [ZhengPeiRu21/mod-playerbots](https://github.com/ZhengPeiRu21/mod-playerbots) and [celguar/mangosbot-bots](https://github.com/celguar/mangosbot-bots). We extend our gratitude to [@ZhengPeiRu21](https://github.com/ZhengPeiRu21) and [@celguar](https://github.com/celguar) for the continued efforts in maintaining the module.
`mod-playerbots` is based on [ZhengPeiRu21/mod-playerbots](https://github.com/ZhengPeiRu21/mod-playerbots) and [celguar/mangosbot-bots](https://github.com/celguar/mangosbot-bots). We extend our gratitude to [@ZhengPeiRu21](https://github.com/ZhengPeiRu21) and [@celguar](https://github.com/celguar) for their continued efforts in maintaining the module.

Also, a thank you to the many contributors who've helped build this project:

Expand Down
Loading