{"id":15671321,"url":"https://github.com/winstxnhdw/botaq","last_synced_at":"2025-03-30T05:22:49.088Z","repository":{"id":49384319,"uuid":"342821344","full_name":"winstxnhdw/BotAQ","owner":"winstxnhdw","description":"BotAQ is an extensible Python bot that utilises template matching to perform specific tasks in Adventure Quest.","archived":false,"fork":false,"pushed_at":"2023-04-17T13:08:43.000Z","size":3514,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-05T07:30:07.824Z","etag":null,"topics":["adventure-quest","bot","pyautogui","template-matching"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/winstxnhdw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-27T09:45:42.000Z","updated_at":"2023-02-18T09:11:54.000Z","dependencies_parsed_at":"2024-10-03T15:04:57.890Z","dependency_job_id":"704252be-4217-4d7d-8d42-62b5e5c48b65","html_url":"https://github.com/winstxnhdw/BotAQ","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winstxnhdw%2FBotAQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winstxnhdw%2FBotAQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winstxnhdw%2FBotAQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winstxnhdw%2FBotAQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/winstxnhdw","download_url":"https://codeload.github.com/winstxnhdw/BotAQ/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246278819,"owners_count":20751835,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adventure-quest","bot","pyautogui","template-matching"],"created_at":"2024-10-03T15:01:50.657Z","updated_at":"2025-03-30T05:22:49.068Z","avatar_url":"https://github.com/winstxnhdw.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BotAQ\n\n[![dependabot.yml](https://github.com/winstxnhdw/BotAQ/actions/workflows/dependabot.yml/badge.svg)](https://github.com/winstxnhdw/BotAQ/actions/workflows/dependabot.yml)\n\nBotAQ 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.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"resources/terminal.gif\" \\\u003e\n\u003c/div\u003e\n\n## Install\n\nWe will install the dependencies in a Python virtual environment to avoid polluting the global environment.\n\n```bash\npython -m venv venv\n```\n\nThen we will activate the virtual environment in our shell. For Windows, execute the following commands.\n\n```ps1\nvenv\\Scripts\\activate\n```\n\nIf you are on Linux, you should prepend the `source` command like so.\n\n```bash\nsource venv/Scripts/activate\n```\n\nYou may install the dependencies once you have activated the virtual environment.\n\n```bash\npip install -r requirements.txt\n```\n\n## Usage\n\n```bash\npython main.py\n```\n\n## Custom Bosses\n\nSave a screengrab template of the boss you have chosen and save it into the templates folder\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"resources/snipping.gif\" \\\u003e\n\u003c/div\u003e\n\n## How it works\n\nBotAQ is based on five fundamental steps.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"resources/flowchart.png\" \\\u003e\n\u003c/div\u003e\n\n### Finding the Boss\n\nA template matcher looks for the selected boss and challenges it.\n\n### Prepare\n\nThe preparationary phase is only engaged once per battle. This is used to cast semi-permanent buffs on the player.\n\n### Attack\n\nAn 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.\n\n### Repeat\n\nIf 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinstxnhdw%2Fbotaq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwinstxnhdw%2Fbotaq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinstxnhdw%2Fbotaq/lists"}