FishPilot — fishing autopilot for GPO

English · Русский

An app for Grand Piece Online (Roblox) on Windows and macOS. It casts the rod, plays the fishing mini-game, keeps a catch log and rings your phone when something goes wrong.

FishPilot is free (MIT license) and not affiliated with Roblox or Grand Piece Online. Automating the game may break its rules and can get you banned — use it at your own risk. The software is provided "as is". Fish icons and names belong to their respective owners.

Support the author: donationalerts.com/r/etnealy — or the ♥ Support the author button in the app and in the Telegram mini app.

Install

Windows

1. Download FishPilot-win64.zip from the latest release.
2. Unpack it to any folder (don't run it from inside the archive) and start FishPilot\FishPilot.exe. No Python needed.
3. Windows SmartScreen may say "Windows protected your PC" — the app has no paid code signature. Click More info → Run anyway.

macOS (Apple Silicon, macOS 12+)

1. Download FishPilot-macos.zip from the latest release, unpack it and move FishPilot.app to Applications.
2. The app has no paid Apple signature, so the first launch is blocked. Open System Settings → Privacy & Security, scroll down and click Open Anyway next to FishPilot. Alternatively run once in Terminal: xattr -dr com.apple.quarantine /Applications/FishPilot.app
3. On the first Start macOS asks for two permissions in System Settings → Privacy & Security — turn FishPilot on in both, then restart the app:
   • Accessibility — so clicks and keys reach Roblox;
   • Screen Recording — so the macro can see the mini-game and the catch notification.
4. F1–F5 on a laptop keyboard may need fn.

Not available on macOS: the HUD over the game and the black screen (macOS can't hide a window from screen capture or make it click-through). After each update macOS may ask for the permissions again — just re-enable them. Settings live in ~/Library/Application Support/FishPilot; tokens there are readable only by your user account (not encrypted as on Windows).

Updates

The app updates itself: when a new version is out, an ⬆ Update to … button appears in the bottom left. It downloads the zip, checks its SHA-256, replaces the files after the app closes and starts again. Your settings are kept.

Languages: English, Русский, Español, Português (BR). Pick one on the first page of the guide or in App → Language.

First setup

A step-by-step guide opens on the first launch (reopen it with ? Setup guide in the bottom left). Home always shows what is still missing.

1. Stand at the water with the rod. Put the rod in a hotbar slot: Setup → Item slots.
2. Catch one fish by hand and press F2 during the mini-game: draw a box around both bars.
3. Setup → Casting → Set water spot: click the water.
4. F1 — start/stop, F3 — exit, F5 — HUD over the game. Keys can be changed in App.

Phone alarms

Section Phone. The app alerts you when there are no bites, no fish, the Roblox window is gone, the anti-cheat black screen doesn't go away or the macro crashed.

Channel	What you need
Telegram	Create your own bot with @BotFather, open it, press Start, then Get chat id and Test Telegram
ntfy (free)	The ntfy app; subscribe to a long unique topic and enter the same name in the app
Pushover	User key and API token; emergency priority rings every 30 s until acknowledged

With Telegram set up you also get control buttons (/menu), the catch list with icons (/catches) and a live mini app panel with stats, start/stop and screenshots.

Data and privacy

Everything is stored in %APPDATA%\FishPilot: config.json (settings), secrets.bin (tokens, encrypted with Windows DPAPI for your user account), fish_learned (fish catalog) and logs. App → Help has settings export/import (without tokens) and Copy diagnostics for bug reports.

FishPilot collects nothing and sends nothing to the author. Only what you configure goes online: messages and screenshots (Roblox window only) to your Telegram bot, alarms to ntfy/Pushover, the mini app status through public MQTT brokers (hashed topic, HMAC-signed), and the update check to GitHub.

Build from source

Python 3.10+: run.bat (Windows) or python gpo_macro.py starts the app, build.bat builds dist\FishPilot and dist\FishPilot-win64.zip. Tests: python -m pytest tests.

To release, bump __version__ in macro/__init__.py, then push a vX.Y.Z tag or run the Build FishPilot workflow manually with publish checked. CI tests, builds, self-checks the exe and publishes release vX.Y.Z; installed copies pick it up from the latest release.

Telegram mini app

The live panel opened from the bot is index.html in this repository, served by GitHub Pages at https://santw3.github.io/FishPilot/ (Settings → Pages → Deploy from a branch → main, / (root)). It has no server of its own: it talks to the PC through public MQTT brokers (vendor/mqtt.min.js) with ntfy as a fallback. Topic names are a hash of a secret, and every status message and command is signed with HMAC-SHA256 and carries a time and a nonce, so without the link nobody can control the macro or replay a command. The secret travels in the link fragment (#…), which is never sent to GitHub.

Detailed documentation (mini-game tuning, automation, HUD, catch log) is in README.ru.md.

License

MIT. Third-party libraries and their licenses are listed in THIRD_PARTY_LICENSES.txt inside the archive. pynput (LGPL-3.0) is used unmodified and can be replaced in the _internal folder. The mini app includes MQTT.js (MIT).