yolinlin/mod-playerbots
1
0
Fork 0
mirror of https://github.com/mod-playerbots/mod-playerbots synced 2025-11-29 15:58:20 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update REAME

Browse Source
This commit is contained in:
Yunfan Li
2023-11-04 15:14:55 +08:00
parent a302c2e9b7
commit cbab145cb2
1 changed files with 53 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

63
README.md
View File

@@ -1,14 +1,57 @@
# Playerbots Module
This is a WIP Playerbots module for AzerothCore based on IKE3 Playerbots. Code is port from: https://github.com/ZhengPeiRu21/mod-playerbots
Welcome to the Playerbots Module for AzerothCore, a work in progress project based on the IKE3 Playerbots. These Playerbots utilize actual player data, allowing you to interact with your own alts, form parties, level up characters, and much more.
If you encounter any errors or experience crashes, we kindly request that you report them as GitHub issues. Your valuable feedback will help us improve and enhance this project collaboratively.
## Installation
Please note that this module requires specific custom changes to AzerothCore. To ensure compatibility, you must compile it with a custom branch from my fork, which can be found here: https://github.com/liyunfan1223/azerothcore-wotlk/tree/Playerbot
To install this module, please refer to the AzerothCore Wiki for detailed instructions: https://www.azerothcore.org/wiki/installation
We've provided a simple method to clone the module:
```bash
git clone https://github.com/liyunfan1223/azerothcore-wotlk.git --branch=Playerbot --depth=1
cd module
git clone https://github.com/liyunfan1223/mod-playerbots.git --branch=master --depth=1
```
## Quick Start & Documentation
For a quick start and an extensive set of commands, you can refer to the manual for the original version of playerbots by ike3. Most of the basic commands are available for this module. You can find the documentation here: https://ike3.github.io/mangosbot-docs/. Please note that in our module, you need to replace all occurrences of `.bot` with `.playerbot bot` in the documentation.
Please be aware that documentation for newly added commands is currently lacking as the project is still under development.
## Progress
The module primarily emphasizes the following key features, and we have implemented improvements in these areas:
- **Random Bots:** We have enhanced the behavior of random bots to make them mimic real players more closely, creating a more authentic player server environment.
- **Bots in Raid:** We've empowered bots to conquer challenging raid content by implementing specific strategies for various bosses, making raid encounters more engaging. Additionally, we have enhanced bots' capabilities in various roles such as DPS, healing, and tanking, ensuring they contribute effectively to the success of raid groups.
- **Bots in Battleground:** Bots are now capable of actively participating in battlegrounds alongside real players, adding depth and excitement to these PvP scenarios.
- **Player Progression Path:** We have improved the interaction between real players and bots, enabling players to complete quests and level up with multiple characters while collaborating with bot companions.
- **Interation with Bots:** We have improved the interaction between real players and bots, enabling players to complete quests and level up with multiple characters while collaborating with the bot companions.
- **Stability:** Our efforts have focused on enhancing the overall stability of AzerothCore when using the Playerbots module. These improvements aim to prevent server crashes and ensure a smoother experience for all users.
- **Configuration:** We have introduced a range of configurable options to cater to players with varying requirements, allowing for a more personalized experience.
It's essential to note that there is still a significant amount of work to be done as we continue to enhance the project. We welcome everyone to contribute in various ways.
## Addon
For enhanced control over the bots and to simplify command usage, you can also make use of our addon: https://github.com/liyunfan1223/unbot-addon. Currently, this addon offers better support only for Simplified Chinese client.
## Acknowledgements
The code for this module is ported from https://github.com/ZhengPeiRu21/mod-playerbots. We extend our gratitude to @ZhengPeiRu21 for the continued efforts in maintaining the module.
We also want to express our sincere appreciation to all individuals who have contributed to playerbot development, both in the past and the present. Your dedication and efforts have been instrumental in shaping this project, and we are thankful for your contributions.
I tried to fix many bugs based on the source code, making this playable, and tried to add more interesting functions, such as automatic positioning of the robot to deal with different raid bosses.
You can use this addon to better control the bot and avoid typing a lot of commands: https://github.com/liyunfan1223/unbot-addon
These Playerbots use actual player data, so it is capable to use own alts and play with own party, level up characters, and more. It is mostly usuable but still has many bugs that need to be resolved. Also please note that including this module will currently significantly increase compilation time for AzerothCore.
Please kindly note that this requires some custom changes to AzerothCore, so it is necessary to compile with a custom branch from my fork:
https://github.com/liyunfan1223/azerothcore-wotlk/tree/Playerbot
If encounter errors and crashes, please post as Github issues so that we can resolve them and improve this project together!