game-bot-helper


Namegame-bot-helper JSON
Version 0.0.1 PyPI version JSON
download
home_page
SummaryA Helper, that accelerates the process of creating a bot for a game
upload_time2024-01-03 11:25:49
maintainer
docs_urlNone
author
requires_python>=3.11
licenseCopyright 2023 Hell Brands Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords game bot helper
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Welcome to Game Bot Helper!

Hi! I like to create Bots for some of the games I play. At least some tasks which are repetitive. This includes almost all mobile games :P
After creating several bots I refined some of my techniques for that and mostly ending up with the same basic structure around the actual botting part.
Since this wrapper does not change at all, I decided to publish this Helper to remove the Boilerplate Code I used to copy&paste from a past project.


## Highlights

- Use Threading under the hood, so you can run multiple methods or bots at once
- Kill-Switch: Can stop every bot action with one button (if the bot os controlling your mouse this is a lifesaver in case of misbehaviour)
- Easy image recognition to click or find specific parts on the screen

## Setup

The class you need to use is called GameBotHelper.
Before that, you should edit the config.toml file to set the screen values to match your current game screen (not your display resolution).
You can also use the change_screen(self, x1, y1, x2, y2, x_mid, y_mid) function, to do so, but this will only change those values for the current instance of the Helper of course.
You should do so in either way, because the bigger the screen, the longer the image recognition will take.

## Functionality
This Helper will start a keyboard listener, so while running you can only press the keys you defined. All other keys will be ignored.
The default Kill-Switch is the "End" key. You can change this with the change_kill_switch(self, key) function.


## Contributions

I made this one open-source, you can contribute on GitHub, if you find a bug or have some additional features in mind.

## Closing words

I hope this little helper will help you in creating your own bots.
If you like my work, feel free to [buy me a coffee](https://www.buymeacoffee.com/HellBrands)

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "game-bot-helper",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": "",
    "keywords": "game,bot,helper",
    "author": "",
    "author_email": "Hell Brands <hell_brands@outlook.com>",
    "download_url": "https://files.pythonhosted.org/packages/dd/dd/991e3d780a2b30edf16ae213c2e5bcaa07dd8d7cba123064ce76ab7898c9/game-bot-helper-0.0.1.tar.gz",
    "platform": null,
    "description": "# Welcome to Game Bot Helper!\r\n\r\nHi! I like to create Bots for some of the games I play. At least some tasks which are repetitive. This includes almost all mobile games :P\r\nAfter creating several bots I refined some of my techniques for that and mostly ending up with the same basic structure around the actual botting part.\r\nSince this wrapper does not change at all, I decided to publish this Helper to remove the Boilerplate Code I used to copy&paste from a past project.\r\n\r\n\r\n## Highlights\r\n\r\n- Use Threading under the hood, so you can run multiple methods or bots at once\r\n- Kill-Switch: Can stop every bot action with one button (if the bot os controlling your mouse this is a lifesaver in case of misbehaviour)\r\n- Easy image recognition to click or find specific parts on the screen\r\n\r\n## Setup\r\n\r\nThe class you need to use is called GameBotHelper.\r\nBefore that, you should edit the config.toml file to set the screen values to match your current game screen (not your display resolution).\r\nYou can also use the change_screen(self, x1, y1, x2, y2, x_mid, y_mid) function, to do so, but this will only change those values for the current instance of the Helper of course.\r\nYou should do so in either way, because the bigger the screen, the longer the image recognition will take.\r\n\r\n## Functionality\r\nThis Helper will start a keyboard listener, so while running you can only press the keys you defined. All other keys will be ignored.\r\nThe default Kill-Switch is the \"End\" key. You can change this with the change_kill_switch(self, key) function.\r\n\r\n\r\n## Contributions\r\n\r\nI made this one open-source, you can contribute on GitHub, if you find a bug or have some additional features in mind.\r\n\r\n## Closing words\r\n\r\nI hope this little helper will help you in creating your own bots.\r\nIf you like my work, feel free to [buy me a coffee](https://www.buymeacoffee.com/HellBrands)\r\n",
    "bugtrack_url": null,
    "license": "Copyright 2023 Hell Brands  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \u201cSoftware\u201d), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \u201cAS IS\u201d, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "A Helper, that accelerates the process of creating a bot for a game",
    "version": "0.0.1",
    "project_urls": null,
    "split_keywords": [
        "game",
        "bot",
        "helper"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "998a7e0d72957485ffb275ad29ff1c73d1b9b4a33af6ff92deacba3134e88b4a",
                "md5": "2d0209c78175342288a5128a881edd02",
                "sha256": "f1dc074fa7f1cff5c0b2c27ac38985eb3c02b7707bc0f9a43d945340ed2d6f53"
            },
            "downloads": -1,
            "filename": "game_bot_helper-0.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2d0209c78175342288a5128a881edd02",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 8039281,
            "upload_time": "2024-01-03T11:25:41",
            "upload_time_iso_8601": "2024-01-03T11:25:41.274379Z",
            "url": "https://files.pythonhosted.org/packages/99/8a/7e0d72957485ffb275ad29ff1c73d1b9b4a33af6ff92deacba3134e88b4a/game_bot_helper-0.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "dddd991e3d780a2b30edf16ae213c2e5bcaa07dd8d7cba123064ce76ab7898c9",
                "md5": "75a62690193c2d06be690cb10a47898c",
                "sha256": "ea2479c961321b5c0c2500f12eef68ab225f16c8f4c586eb736d44b5c1411d44"
            },
            "downloads": -1,
            "filename": "game-bot-helper-0.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "75a62690193c2d06be690cb10a47898c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 6820889,
            "upload_time": "2024-01-03T11:25:49",
            "upload_time_iso_8601": "2024-01-03T11:25:49.698516Z",
            "url": "https://files.pythonhosted.org/packages/dd/dd/991e3d780a2b30edf16ae213c2e5bcaa07dd8d7cba123064ce76ab7898c9/game-bot-helper-0.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-03 11:25:49",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "game-bot-helper"
}
        
Elapsed time: 0.19273s