# BHBot
[Этот файл доступен на Русском языке](README_RU.md)
Gold/XP farming bot for Brawlhalla
Heavily inspired by [BrawlhallaEZ](https://github.com/jamunano/BrawlhallaEZ)
### -------------------------------------------------------------------
### BOT IS BACK TO BEING ACTIVELY MAINTAINED!
###### Join [Discord](https://discord.gg/2HDmuqqq9p "Discord") to help maintain the bot or add new features!
### -------------------------------------------------------------------
**WARNING:** The software was originally developed for private utilization.
While it is not designed to, it may potentially lead to unforeseen outcomes, including the execution of transactions within Mallhalla using in-game currencies.
**The developers disclaims all liability for any damages that may arise from the use of this software. It is advised to proceed with caution and utilize the software at your own discretion.**
(Bot has been tested by multiple people for over 3,000 hours without issue as of 4/18/2024)
# Installation
Latest release can always be downloaded [here](https://github.com/Nick2bad4u/BHBot/releases)
# Features
- Works completely in background
- Sends inputs directly to Brawlhalla to not disturb you
- Automatically launches the game
- Automatically creates/sets up lobby
- Automatically picks/changes character and game duration
- Automatically detects and resets xp limit
- Supports custom modes
- Supports custom languages
- Even supports custom fonts
- ~~Brews you coffee~~ (only tea supported for now)
# Usage
- The process is designed to be intuitive. Simply choose the required settings by clicking the "Settings" button
- Once settings are saved, start the program by clicking on "Start" button
# Limitations
- Bot requires "Collapse crossovers" to be set to Yes. If you think it should automatically set it to be so, please [open an issue](https://github.com/nick2bad4u/bhbot/issues)
- Bot requires ingame language to be set to English. If you think it should automatically set it to be so, please [open an issue](https://github.com/nick2bad4u/bhbot/issues)
# Technical Overview
- The underlying code is always available for review by anyone.
- Essentially, the bot employs the Windows SendMessage API to transmit inputs directly to the Brawlhalla window. It utilizes pixel detection to discern states and determine the appropriate action at any given moment.
- The BrawlhallaBot class can be utilized directly or you may develop a custom wrapper for it. It is designed to operate independently, with gui.py serving merely as a graphical wrapper using PySimpleGUI<img src="https://www.google-analytics.com/collect?v=2&tid=G-6RR5ZF4BJV&cid=555&t=event&en=eventName">
Raw data
{
"_id": null,
"home_page": "https://github.com/Nick2bad4u/BHBot",
"name": "BHBot",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Nick",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/fc/c6/576fba17323d5e119c187b94937dbe9fc1510456b3a1cc809481c73a16ab/bhbot-2.2.tar.gz",
"platform": null,
"description": "# BHBot\n\n[\u042d\u0442\u043e\u0442 \u0444\u0430\u0439\u043b \u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d \u043d\u0430 \u0420\u0443\u0441\u0441\u043a\u043e\u043c \u044f\u0437\u044b\u043a\u0435](README_RU.md)\n\nGold/XP farming bot for Brawlhalla\n\nHeavily inspired by [BrawlhallaEZ](https://github.com/jamunano/BrawlhallaEZ)\n\n### -------------------------------------------------------------------\n\n### BOT IS BACK TO BEING ACTIVELY MAINTAINED!\n###### Join [Discord](https://discord.gg/2HDmuqqq9p \"Discord\") to help maintain the bot or add new features!\n\n### -------------------------------------------------------------------\n\n**WARNING:** The software was originally developed for private utilization. \nWhile it is not designed to, it may potentially lead to unforeseen outcomes, including the execution of transactions within Mallhalla using in-game currencies. \n\n**The developers disclaims all liability for any damages that may arise from the use of this software. It is advised to proceed with caution and utilize the software at your own discretion.**\n\n(Bot has been tested by multiple people for over 3,000 hours without issue as of 4/18/2024)\n\n# Installation\nLatest release can always be downloaded [here](https://github.com/Nick2bad4u/BHBot/releases)\n\n# Features\n\n- Works completely in background\n- Sends inputs directly to Brawlhalla to not disturb you\n- Automatically launches the game\n- Automatically creates/sets up lobby\n- Automatically picks/changes character and game duration\n- Automatically detects and resets xp limit\n- Supports custom modes\n- Supports custom languages\n- Even supports custom fonts\n- ~~Brews you coffee~~ (only tea supported for now)\n\n# Usage\n- The process is designed to be intuitive. Simply choose the required settings by clicking the \"Settings\" button\n- Once settings are saved, start the program by clicking on \"Start\" button\n\n# Limitations\n- Bot requires \"Collapse crossovers\" to be set to Yes. If you think it should automatically set it to be so, please [open an issue](https://github.com/nick2bad4u/bhbot/issues)\n- Bot requires ingame language to be set to English. If you think it should automatically set it to be so, please [open an issue](https://github.com/nick2bad4u/bhbot/issues)\n\n# Technical Overview\n- The underlying code is always available for review by anyone.\n- Essentially, the bot employs the Windows SendMessage API to transmit inputs directly to the Brawlhalla window. It utilizes pixel detection to discern states and determine the appropriate action at any given moment.\n\n- The BrawlhallaBot class can be utilized directly or you may develop a custom wrapper for it. It is designed to operate independently, with gui.py serving merely as a graphical wrapper using PySimpleGUI<img src=\"https://www.google-analytics.com/collect?v=2&tid=G-6RR5ZF4BJV&cid=555&t=event&en=eventName\">\n",
"bugtrack_url": null,
"license": "Unlicense",
"summary": null,
"version": "2.2",
"project_urls": {
"Homepage": "https://github.com/Nick2bad4u/BHBot"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "14940140103e321884c84f29eeddd29ee66faec1be6fa89a1b5e69eb003aff18",
"md5": "7bad5e10cad7259ccb06c8317f69aad5",
"sha256": "d08ea77f10ec7bb03056234b2b213015fc20b6bc10521b72d13edb91ea1c314a"
},
"downloads": -1,
"filename": "BHBot-2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7bad5e10cad7259ccb06c8317f69aad5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 28396,
"upload_time": "2024-04-26T19:39:05",
"upload_time_iso_8601": "2024-04-26T19:39:05.568420Z",
"url": "https://files.pythonhosted.org/packages/14/94/0140103e321884c84f29eeddd29ee66faec1be6fa89a1b5e69eb003aff18/BHBot-2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fcc6576fba17323d5e119c187b94937dbe9fc1510456b3a1cc809481c73a16ab",
"md5": "be9e11cea452d5fbe256b5117dc1bfe8",
"sha256": "9fa3ea3a945be68ed52993ae5d8d973c6ca8d5bc637bb98dad3b86dce9ea6911"
},
"downloads": -1,
"filename": "bhbot-2.2.tar.gz",
"has_sig": false,
"md5_digest": "be9e11cea452d5fbe256b5117dc1bfe8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 24773,
"upload_time": "2024-04-26T19:39:07",
"upload_time_iso_8601": "2024-04-26T19:39:07.144043Z",
"url": "https://files.pythonhosted.org/packages/fc/c6/576fba17323d5e119c187b94937dbe9fc1510456b3a1cc809481c73a16ab/bhbot-2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-26 19:39:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Nick2bad4u",
"github_project": "BHBot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "altgraph",
"specs": [
[
"==",
"0.17.4"
]
]
},
{
"name": "appdirs",
"specs": [
[
"==",
"1.4.4"
]
]
},
{
"name": "asttokens",
"specs": [
[
"==",
"2.4.1"
]
]
},
{
"name": "attrs",
"specs": [
[
"==",
"23.2.0"
]
]
},
{
"name": "auto-py-to-exe",
"specs": [
[
"==",
"2.43.3"
]
]
},
{
"name": "backcall",
"specs": [
[
"==",
"0.2.0"
]
]
},
{
"name": "beautifulsoup4",
"specs": [
[
"==",
"4.12.3"
]
]
},
{
"name": "bleach",
"specs": [
[
"==",
"6.1.0"
]
]
},
{
"name": "bottle",
"specs": [
[
"==",
"0.12.25"
]
]
},
{
"name": "bottle-websocket",
"specs": [
[
"==",
"0.2.9"
]
]
},
{
"name": "bsdiff4",
"specs": [
[
"==",
"1.2.4"
]
]
},
{
"name": "certifi",
"specs": [
[
"==",
"2024.2.2"
]
]
},
{
"name": "cffi",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "chardet",
"specs": [
[
"==",
"5.2.0"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.3.2"
]
]
},
{
"name": "colorama",
"specs": [
[
"==",
"0.4.6"
]
]
},
{
"name": "decorator",
"specs": [
[
"==",
"5.1.1"
]
]
},
{
"name": "defusedxml",
"specs": [
[
"==",
"0.7.1"
]
]
},
{
"name": "Deprecated",
"specs": [
[
"==",
"1.2.14"
]
]
},
{
"name": "docopt",
"specs": [
[
"==",
"0.6.2"
]
]
},
{
"name": "dsdev-utils",
"specs": [
[
"==",
"1.3.0"
]
]
},
{
"name": "Eel",
"specs": [
[
"==",
"1.0.0a1"
]
]
},
{
"name": "executing",
"specs": [
[
"==",
"2.0.1"
]
]
},
{
"name": "fastjsonschema",
"specs": [
[
"==",
"2.19.1"
]
]
},
{
"name": "fonttools",
"specs": [
[
"==",
"4.51.0"
]
]
},
{
"name": "future",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "gevent",
"specs": [
[
"==",
"24.2.1"
]
]
},
{
"name": "gevent-websocket",
"specs": [
[
"==",
"0.10.1"
]
]
},
{
"name": "greenlet",
"specs": [
[
"==",
"3.0.3"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.7"
]
]
},
{
"name": "ipython",
"specs": [
[
"==",
"8.23.0"
]
]
},
{
"name": "jedi",
"specs": [
[
"==",
"0.19.1"
]
]
},
{
"name": "Jinja2",
"specs": [
[
"==",
"3.1.3"
]
]
},
{
"name": "jsonschema",
"specs": [
[
"==",
"4.21.1"
]
]
},
{
"name": "jsonschema-specifications",
"specs": [
[
"==",
"2023.12.1"
]
]
},
{
"name": "jupyter_client",
"specs": [
[
"==",
"8.6.1"
]
]
},
{
"name": "jupyter_core",
"specs": [
[
"==",
"5.7.2"
]
]
},
{
"name": "jupyterlab_pygments",
"specs": [
[
"==",
"0.3.0"
]
]
},
{
"name": "keyboard",
"specs": [
[
"==",
"0.13.5"
]
]
},
{
"name": "MarkupSafe",
"specs": [
[
"==",
"2.1.5"
]
]
},
{
"name": "matplotlib-inline",
"specs": [
[
"==",
"0.1.6"
]
]
},
{
"name": "mistune",
"specs": [
[
"==",
"3.0.2"
]
]
},
{
"name": "nbclient",
"specs": [
[
"==",
"0.10.0"
]
]
},
{
"name": "nbconvert",
"specs": [
[
"==",
"7.16.3"
]
]
},
{
"name": "nbformat",
"specs": [
[
"==",
"5.10.4"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"24.0"
]
]
},
{
"name": "pandocfilters",
"specs": [
[
"==",
"1.5.1"
]
]
},
{
"name": "parso",
"specs": [
[
"==",
"0.8.4"
]
]
},
{
"name": "pbr",
"specs": [
[
"==",
"6.0.0"
]
]
},
{
"name": "pefile",
"specs": [
[
"==",
"2023.2.7"
]
]
},
{
"name": "pickleshare",
"specs": [
[
"==",
"0.7.5"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"10.3.0"
]
]
},
{
"name": "pip",
"specs": [
[
"==",
"24.0"
]
]
},
{
"name": "pipreqs",
"specs": [
[
"==",
"0.5.0"
]
]
},
{
"name": "platformdirs",
"specs": [
[
"==",
"4.2.1"
]
]
},
{
"name": "prompt-toolkit",
"specs": [
[
"==",
"3.0.43"
]
]
},
{
"name": "psutil",
"specs": [
[
"==",
"5.9.8"
]
]
},
{
"name": "pure-eval",
"specs": [
[
"==",
"0.2.2"
]
]
},
{
"name": "pyasn1",
"specs": [
[
"==",
"0.6.0"
]
]
},
{
"name": "pycparser",
"specs": [
[
"==",
"2.22"
]
]
},
{
"name": "Pygments",
"specs": [
[
"==",
"2.17.2"
]
]
},
{
"name": "pyinstaller",
"specs": [
[
"==",
"6.5.0"
]
]
},
{
"name": "pyinstaller-hooks-contrib",
"specs": [
[
"==",
"2024.5"
]
]
},
{
"name": "PyNaCl",
"specs": [
[
"==",
"1.5.0"
]
]
},
{
"name": "pyparsing",
"specs": [
[
"==",
"3.1.2"
]
]
},
{
"name": "pypiwin32",
"specs": [
[
"==",
"223"
]
]
},
{
"name": "PySimpleGUI",
"specs": [
[
"==",
"5.0.4"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.9.0.post0"
]
]
},
{
"name": "PyUpdater",
"specs": [
[
"==",
"4.0"
]
]
},
{
"name": "pywin32",
"specs": [
[
"==",
"306"
]
]
},
{
"name": "pywin32-ctypes",
"specs": [
[
"==",
"0.2.2"
]
]
},
{
"name": "pyzmq",
"specs": [
[
"==",
"26.0.2"
]
]
},
{
"name": "referencing",
"specs": [
[
"==",
"0.35.0"
]
]
},
{
"name": "regex",
"specs": [
[
"==",
"2024.4.16"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "rpds-py",
"specs": [
[
"==",
"0.18.0"
]
]
},
{
"name": "rsa",
"specs": [
[
"==",
"4.9"
]
]
},
{
"name": "setuptools",
"specs": [
[
"==",
"69.2.0"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "soupsieve",
"specs": [
[
"==",
"2.5"
]
]
},
{
"name": "stack-data",
"specs": [
[
"==",
"0.6.3"
]
]
},
{
"name": "tinycss2",
"specs": [
[
"==",
"1.3.0"
]
]
},
{
"name": "tornado",
"specs": [
[
"==",
"6.4"
]
]
},
{
"name": "traitlets",
"specs": [
[
"==",
"5.14.3"
]
]
},
{
"name": "wakepy",
"specs": [
[
"==",
"0.7.2"
]
]
},
{
"name": "wcwidth",
"specs": [
[
"==",
"0.2.13"
]
]
},
{
"name": "webencodings",
"specs": [
[
"==",
"0.5.1"
]
]
},
{
"name": "wheel",
"specs": [
[
"==",
"0.43.0"
]
]
},
{
"name": "whichcraft",
"specs": [
[
"==",
"0.6.1"
]
]
},
{
"name": "wrapt",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "yarg",
"specs": [
[
"==",
"0.1.9"
]
]
},
{
"name": "zope.event",
"specs": [
[
"==",
"5.0"
]
]
},
{
"name": "zope.interface",
"specs": [
[
"==",
"6.2"
]
]
}
],
"lcname": "bhbot"
}
