{"id":20027888,"url":"https://github.com/weebnetsu/proag","last_synced_at":"2025-09-05T12:33:39.803Z","repository":{"id":235702391,"uuid":"616087143","full_name":"WeebNetsu/proag","owner":"WeebNetsu","description":"Auto grinder for Pokemon","archived":false,"fork":false,"pushed_at":"2023-03-23T12:29:20.000Z","size":792,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-12T17:27:18.119Z","etag":null,"topics":["autogrind","autoplaygame","grinder","pokemon","pokemonrevolutiononline"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WeebNetsu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":null,"patreon":"Stevesteacher","open_collective":null,"ko_fi":"stevesteacher","tidelift":null,"community_bridge":null,"liberapay":"stevesteacher","issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-03-19T15:20:06.000Z","updated_at":"2023-03-19T15:21:56.000Z","dependencies_parsed_at":"2024-04-24T09:45:34.758Z","dependency_job_id":"6752c75e-809c-4102-a1e4-234e39baf16c","html_url":"https://github.com/WeebNetsu/proag","commit_stats":null,"previous_names":["weebnetsu/proag"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeebNetsu%2Fproag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeebNetsu%2Fproag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeebNetsu%2Fproag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WeebNetsu%2Fproag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WeebNetsu","download_url":"https://codeload.github.com/WeebNetsu/proag/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241460042,"owners_count":19966516,"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":["autogrind","autoplaygame","grinder","pokemon","pokemonrevolutiononline"],"created_at":"2024-11-13T09:12:20.749Z","updated_at":"2025-03-02T04:43:34.358Z","avatar_url":"https://github.com/WeebNetsu.png","language":"Python","funding_links":["https://patreon.com/Stevesteacher","https://ko-fi.com/stevesteacher","https://liberapay.com/stevesteacher"],"categories":[],"sub_categories":[],"readme":"# PROAG\n\nPokemon Revolution Online Auto Grinder - This software allows you to grind your pokemon with minimum supervision.\n\nGet [the game](https://pokemonrevolution.net/home).\n\n## Topics\n\n- [How it Works](#how-it-works)\n- [Running the Code](#running-the-code)\n  - [Configuring Your Grind](#configuring-your-grind)\n- [Available Regions and Areas](#available-regions-and-areas)\n  - [Kanto Region](#kanto-region)\n    - [Rock Tunnel Area](#rock-tunnel-area)\n- [Contributing](#contributing)\n  - [Project Structure](#project-structure)\n- [Why](#why)\n- [Note](#note)\n\n## How it Works\n\n- If on Linux, please run as sudo.\n- You have 5 seconds to focus the pokemon window\n- Go to the specific route you want to grind at (**if the script has been added**)\n- Do not unfocus the window while script is running\n- Spam 'q' to stop the program execution\n\n## Running the Code\n\n1. Install the dependencies `pip3 install -r requirements.txt`\n2. Install `tkinter` (installed with Python on Windows)\n3. Open PROClient (the game)\n4. Run the script: `python3 __init__.py \u003carea\u003e \u003csub-area\u003e` or `sudo python3 __init__.py \u003carea\u003e \u003csub-area\u003e` if on Linux. Example: `python3 __init__.py kanto rock_tunnel`. If no area is provided, it will default to rock tunnel.\n5. You have 5 seconds to focus on the game for this script to work\n\n### Configuring Your Grind\n\nYou can configure various parts of the code to change how you grind. Here are a few tips:\n\n- `src/utils/globals.py` - Change things such as wait time between actions (`BANDWIDTH_WAIT`) or how many rounds your character should be fighting (`FIGHT_ROUNDS`) before moving again\n\nTake a look at [Project Structure](#project-structure) if you want to create your own grind or configure an existing one to suit your needs.\n\n## Available Regions and Areas\n\n### Kanto Region\n\n#### Rock Tunnel Area\n\n- Command: `kanto rock_tunnel`\n- Where: In the tunnel right before Lavender Town, directly in front of nurse Joy\n\n![Rock Tunnel location](assets/guide_locations/kanto/rock_tunnel.jpg)\n\n## Contributing\n\nFeel free to create a pull request with new regions and areas where we can grind!\n\n### Project Structure\n\n- `__init__.py` - Entry point of the application\n- `requirements.txt` - Project PIP requirements\n- `assets/` - Images, usually those used to display at what location a grind can be initiated\n- `src/` - Project source code\n  - `__init__.py` - Project `main()` function (first function to run), initiates everything\n  - `region/` - Region **grinding** code\n    - `\u003cregion\u003e/` - Specific region where this code is used in\n      - `\u003carea\u003e.py` - Grinding code used in that area of the game. Primary function should be called `run()`, for the sake of consistency.\n  - `run/` - This folder contains the code to run any of the of the region code.\n    - `\u003carea\u003e.py` - Filters the area in the region and run its code (which can be found in `src/region/\u003cregion\u003e/\u003carea\u003e.py`)\n  - `utils/` - All auxiliary functions\n    - `__init__.py` - General utility functions that can be used in the whole project\n    - `actions.py` - Common actions the player can take that does not change anywhere\n    - `globals.py` - Global variables\n    - `move.py` - Functions to move the player around\n    - `parser.py` - Parse inputs\n\n## Why\n\nPersonal project, I just hate grinding lol\n\n## NOTE\n\nPlease read the license before using the software.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweebnetsu%2Fproag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweebnetsu%2Fproag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweebnetsu%2Fproag/lists"}