{"id":19624813,"url":"https://github.com/coko7/mc-fish-pye","last_synced_at":"2026-06-18T14:32:09.279Z","repository":{"id":242255988,"uuid":"809092934","full_name":"coko7/mc-fish-pye","owner":"coko7","description":"🎣 AFK auto-fishing script for Minecraft using Python and OpenCV.","archived":false,"fork":false,"pushed_at":"2026-04-14T11:08:36.000Z","size":214,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-14T12:24:51.135Z","etag":null,"topics":["fishing-bot","minecraft","minecraft-26-1","opencv2","poetry","poetry-python","pyautogui","python","script"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coko7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"publiccode":null,"codemeta":null}},"created_at":"2024-06-01T17:00:43.000Z","updated_at":"2026-04-14T11:08:40.000Z","dependencies_parsed_at":"2024-06-17T14:01:56.300Z","dependency_job_id":null,"html_url":"https://github.com/coko7/mc-fish-pye","commit_stats":null,"previous_names":["coko7/mc-fishpy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/coko7/mc-fish-pye","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coko7%2Fmc-fish-pye","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coko7%2Fmc-fish-pye/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coko7%2Fmc-fish-pye/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coko7%2Fmc-fish-pye/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coko7","download_url":"https://codeload.github.com/coko7/mc-fish-pye/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coko7%2Fmc-fish-pye/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34495377,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["fishing-bot","minecraft","minecraft-26-1","opencv2","poetry","poetry-python","pyautogui","python","script"],"created_at":"2024-11-11T11:39:06.202Z","updated_at":"2026-06-18T14:32:09.270Z","avatar_url":"https://github.com/coko7.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎣 mc-fish-pye\n\nAFK auto-fishing script for Minecraft using Python and OpenCV.\n\nSo that you can bake many [fish p*y*es](https://en.wikipedia.org/wiki/Fish_pie) with all the fish you get :)\n\n## ⚙️ Setup\n\n### 1. Install [Poetry](https://python-poetry.org/docs/#installation) (recommended)\n\nOn Arch Linux:\n\n```bash\nsudo pacman -S poetry\n# Or follow Poetry's installation instructions for other platforms\n```\n\n### 2. Set up the development environment and dependencies\n\nFrom the project root:\n\n```bash\npoetry install\n```\n\nThis will set up a virtual environment and install all required dependencies.\n\n### 3. (Optional) Activate the virtual environment\n\n```bash\npoetry env activate\n```\n\nOr you can prefix commands with `poetry run ...` to use the venv without activating.\n\n### 4. Configure the Minecraft ROI (Region of Interest)\n\nRun the ROI setup script from the root directory:\n\n```bash\npoetry run python scripts/setup_roi.py\n```\n\n- Follow the instructions: click twice on your screen (top-left, bottom-right of the subtitle region).\n- The region will be automatically written to `config.json`.\n\nYour `config.json` will look like:\n\n```json\n{\n  \"startTimer\": 5,\n  \"detection\": {\n    \"roi\": {\n      \"x1\": 1000,\n      \"x2\": 2000,\n      \"y1\": 1000,\n      \"y2\": 2000\n    },\n    \"threshold\": 10,\n    \"cooldown\": 2.5\n  },\n  \"actions\": {\n    \"clickPos\": {\n      \"x\": 0,\n      \"y\": 0\n    },\n    \"clickDelay\": 0.5\n  }\n}\n```\n\n### 5. Download/import the [resource pack](./resource-pack/) into Minecraft and set the language\n\n- Download the [resource pack](./resource-pack/) and import it (Feel free to zip it if you want)\n- In game, select the resource pack and then change your in-game language to \"Bionic Fisher Lang\"\n- Make sure you have the [subtitles](https://minecraft.wiki/w/Subtitles) enabled in **Accessibility Settings**\n- In **Accessibility Settings**, disable the transparency of the subtitle background (it should be full black)\n- Make sure you do not have **Friendly Creatures** sounds muted in your **Sound Settings**\n\n## 📖 Usage\n\n- Launch Minecraft and make sure you have set your language properly\n- Join a world and stand in front of your fishing spot\n- Run the `main.py` script with root/admin privileges (required for some keyboard events):\n\n  ```bash\n  poetry run python -m mc_fish_pye.main\n  # or, if you activated the poetry shell:\n  # python -m mc_fish_pye.main\n  ```\n\n- Quickly switch window focus to Minecraft and let it do the work\n- Enjoy an infinite supply of fish and treasure!\n- You can stop the script at any moment by holding the `p` key (or as documented in config/usage)\n\n## ❓ How it works\n\nThis script relies on Minecraft subtitles and a custom language to detect when the fishing bobber sinks.\n\nThe custom language sets all subtitles to be empty, apart from `subtitles.entity.fishing_bobber.splash`, which is set to \"AAAAAAA\".\n\nThe long string will cause the black background behind the subtitle text to stretch farther than other subtitles.\n\nThese additional black pixels are what the script is looking for to detect if your fishing bobber has caught onto something.\n\nOnce a catch is detected, the script sends one right click to retrieve the catch, followed immediately by another one to cast the rod again.\n\nAfter the rod has been cast again, the pixel detection will be deactivated for a few seconds to allow the subtitle to have time to fade away.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoko7%2Fmc-fish-pye","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoko7%2Fmc-fish-pye","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoko7%2Fmc-fish-pye/lists"}