{"id":18431106,"url":"https://github.com/codewithma/pvpokelossbot","last_synced_at":"2025-04-07T18:32:28.464Z","repository":{"id":171004108,"uuid":"591204795","full_name":"CodeWithMa/PVPokeLossBot","owner":"CodeWithMa","description":"Farm Stardust Effortlessly with PVPokeLossBot: The Ultimate Pokemon Go PVP Automation","archived":false,"fork":false,"pushed_at":"2024-03-01T07:47:37.000Z","size":10673,"stargazers_count":12,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2024-03-01T08:44:55.429Z","etag":null,"topics":["adb","bot","lossbot","opencv","pokemongo","pokemongo-bot","python","stardust"],"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/CodeWithMa.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}},"created_at":"2023-01-20T07:03:25.000Z","updated_at":"2024-02-24T06:04:27.000Z","dependencies_parsed_at":"2024-02-26T16:27:15.635Z","dependency_job_id":"de8a6dc5-6dcd-43e9-b0c0-dfae687fa86b","html_url":"https://github.com/CodeWithMa/PVPokeLossBot","commit_stats":null,"previous_names":["codewithma/pvpokelossbot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWithMa%2FPVPokeLossBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWithMa%2FPVPokeLossBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWithMa%2FPVPokeLossBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeWithMa%2FPVPokeLossBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CodeWithMa","download_url":"https://codeload.github.com/CodeWithMa/PVPokeLossBot/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223288280,"owners_count":17120356,"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":["adb","bot","lossbot","opencv","pokemongo","pokemongo-bot","python","stardust"],"created_at":"2024-11-06T05:23:32.212Z","updated_at":"2025-04-07T18:32:28.458Z","avatar_url":"https://github.com/CodeWithMa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PVPokeLossBot\n\nThis only works on android. It uses [adb](https://developer.android.com/tools/adb) to connect to your phone.\nIt works fine on my Pixel 6a. If your phone's resolution differs too much, it might not detect the correct state.\n\n## Summary\n\nPVPokeLossBot is a bot designed for the PVP mode of the mobile game Pokemon Go.\nUsing computer vision, the bot analyzes screenshots of the game and makes decisions on which actions to perform, such as sending `adb tap` commands to the game.\nThe bot also has a built-in timer that automatically forfeits the game after a certain period of time.\n\n![pvp leagues](https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fstatic0.gamerantimages.com%2Fwordpress%2Fwp-content%2Fuploads%2F2020%2F07%2Fpokemon-go-battle-league-season-3-e1595952020123.jpg\u0026f=1\u0026nofb=1\u0026ipt=a981ff5cbef41827663812e2a15e2ece03ec8a5505f8915cdf5f5d356843d09a\u0026ipo=images)\n\n## Installation\n\nTo use PVPokeLossBot, you will first need to install the required dependencies.\n\n### Create and Activate a Virtual Environment\n\nUsing [venv](https://docs.python.org/3/library/venv.html), create a virtual environment to manage dependencies:\n\n``` bash\npython -m venv venv\nsource venv/bin/activate\n```\n\n### Install dependencies\n\n``` bash\npip install -r requirements.txt\n```\n\n## Usage\n\nMake sure you are in your venv if you used one.\n\n``` bash\nsource venv/bin/activate\n```\n\nTo run the bot, you can use the following command:\n\n``` bash\npython main.py\n```\n\nRun it with `--verbose` to get more output.\n\n``` bash\npython main.py --verbose\n```\n\nYou can also configure the bot's settings by editing the `bot.py` file.\nFor example, you can adjust the time the bot will stay in the game before forfeiting.\n\n### Example Output\n\nPVPokeLossBot will output information about its actions and the results of the image matching.\nBelow is an example of the output you may see while the bot is running:\n\n``` bash\n2023-01-20 09:45:10 Image start_button_text2.en.png matches with 99.99927282333374%\n2023-01-20 09:45:15 Image welcome_to_gbl_button_text.en.png matches with 100.0%\n2023-01-20 09:45:19 Image select_super_league.png matches with 100.0%\n2023-01-20 09:45:24 Image confirm_party_search_button.en.png matches with 99.99873638153076%\n2023-01-20 09:46:43 Image ingame_opponent_3_pokemon_left.png matches with 99.86531138420105%\n2023-01-20 09:46:48 Image ingame_opponent_2_pokemon_left.png matches with 99.82503652572632%\n2023-01-20 09:46:51 Timer has run out. Forfeit the game.\n```\n\nEach line of output shows the date and time of the action, the image file name that was matched, and the match value as a percentage.\nThe bot will also output a message when the timer runs out and it forfeits the game.\n\n## Adding New Images\n\nPVPokeLossBot uses a set of template images to compare with screenshots of the game.\nWhen a match is found, the bot will click on the middle of the found image.\n\nTo add new images to be used as templates, place them in the \"images\" directory and convert them to greyscale using the script `convert-to-greyscale.py`:\n\n``` bash\npython convert-to-greyscale.py\n```\n\nIf you are using the bot in a different language than the one provided in the template images, you can contribute by adding new images for different languages.\nYou can create a pull request with the new images and the corresponding language identifier in the file name, for example, `start_button_text2.fr.png` for French.\n\n## Known Issues\n\nThe bot may get stuck on the forfeit the game screen.\nPokemon Go has to be restarted manually.\n\n## The Secret to Farming Stardust in Pokemon Go: PVPokeLossBot's Elo Drop Strategy\n\n\"Elo\" is a ranking system used in competitive games such as Pokemon Go PVP to match players of similar skill levels against each other.\nBy using PVPokeLossBot, the bot will forfeit the game on purpose, which will cause the user's Elo to drop lower and lower.\nAs a result, the user will only play against other players who also have a low Elo, most likely because they also use loss bot, thus the user will play against players who also forfeit the game, which can make it easier to farm stardust.\n\n## Warning\n\nPlease be aware that using such a bot can be against the terms of service of the game, use it at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithma%2Fpvpokelossbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodewithma%2Fpvpokelossbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithma%2Fpvpokelossbot/lists"}