Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/winstxnhdw/botaq
BotAQ is an extensible Python bot that utilises template matching to perform specific tasks in Adventure Quest.
https://github.com/winstxnhdw/botaq
adventure-quest bot pyautogui template-matching
Last synced: 2 days ago
JSON representation
BotAQ is an extensible Python bot that utilises template matching to perform specific tasks in Adventure Quest.
- Host: GitHub
- URL: https://github.com/winstxnhdw/botaq
- Owner: winstxnhdw
- Created: 2021-02-27T09:45:42.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-04-17T13:08:43.000Z (over 1 year ago)
- Last Synced: 2024-04-20T00:47:17.316Z (6 months ago)
- Topics: adventure-quest, bot, pyautogui, template-matching
- Language: Python
- Homepage:
- Size: 3.35 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BotAQ
[![dependabot.yml](https://github.com/winstxnhdw/BotAQ/actions/workflows/dependabot.yml/badge.svg)](https://github.com/winstxnhdw/BotAQ/actions/workflows/dependabot.yml)
BotAQ is a CLI bot made to grind bosses in Adventure Quest. It utilises the PyAutoGUI library to simulate human input and perform template matching. Unfortunately, this was not made with versatility in mind, as it requires the player to reach certain specific conditions within the game.
## Install
We will install the dependencies in a Python virtual environment to avoid polluting the global environment.
```bash
python -m venv venv
```Then we will activate the virtual environment in our shell. For Windows, execute the following commands.
```ps1
venv\Scripts\activate
```If you are on Linux, you should prepend the `source` command like so.
```bash
source venv/Scripts/activate
```You may install the dependencies once you have activated the virtual environment.
```bash
pip install -r requirements.txt
```## Usage
```bash
python main.py
```## Custom Bosses
Save a screengrab template of the boss you have chosen and save it into the templates folder
## How it works
BotAQ is based on five fundamental steps.
### Finding the Boss
A template matcher looks for the selected boss and challenges it.
### Prepare
The preparationary phase is only engaged once per battle. This is used to cast semi-permanent buffs on the player.
### Attack
An attack is performed on the boss and checked if it is killed for every attack. If the boss is not killed, the function is repeated.
### Repeat
If the boss is killed, the steps are repeated without the setting the loadout again. This cycle eventually stops when the maximum daily limit of fighting the boss is reached. Player has the choice whether to keep last experience points gained from previous sessions.