Leaf's Grand Blue Autofish

1. L'inizio

   Una macro che funzionava, e poco altro

   Gioco a Grand Blue, e la sua pesca è un grind lungo. Ho trovato la macro di pesca open source di 1vtt, e funzionava, ma era essenziale: una finestra di console, un file JSON da modificare a mano e una calibrazione difficile da fare bene. Nessuna comodità. Il mio primo pensiero è stato che potevo farla meglio da solo.

2. L'obiettivo

   Migliore per chi non ha mai aperto un terminale

   Volevo metterci il mio lavoro di UI e UX e la mia esperienza di computer vision. Una vera interfaccia al posto della console, una calibrazione che ti guida passo per passo, numeri dal vivo invece di testo che scorre, un rilevamento che non perde un abboccamento per un solo frame sbagliato, e un exe pronto, così nessuno deve installare Python. 1vtt ha accettato che partissi dalla sua macro, ed è diventata un'app a sé.

3. L'avventura

   Guardare lo schermo come un giocatore

   L'app guarda solo lo schermo e usa solo mouse e tastiera, come un giocatore molto attento. Non legge né modifica mai i file o la memoria del gioco. Lancia, clicca il pulsante SHAKE finché un pesce abbocca, legge il badge di rarità, tiene la barra di recupero sul pesce, poi legge il messaggio di cattura per registrare il pesce, le sue mutazioni e quanto vale.

   YouTubeLeaf's Grand Blue Autofish in 22 secondiLoads the YouTube player

   Intorno al motore ho progettato l'interfaccia, tutta in HTML e CSS dentro pywebview: una dashboard con una scena oceanica, un Inventario delle sessioni passate con grafici ed export CSV, una calibrazione guidata con un'immagine per ogni passo e impostazioni per temi, colori d'accento e un font adatto alla dislessia.

   Ogni parte reagisce quando la usi, e ha i suoi effetti sonori, che ho creato io: il passaggio del mouse, i clic, il cambio di pagina e gli interruttori, l'avvio e lo stop, e un suono di cattura diverso per ogni fascia di rarità. Il suono conta molto in come si percepisce un'interfaccia, e volevo che questa fosse accogliente e un po' cool. Puoi sentirli nella demo qui sopra.

4. Le difficoltà

   Cose che lo sfondo può imitare

   Grand Blue disegna la sua interfaccia sopra acqua, sabbia e scene notturne, e quasi tutta è trasparente. Il pulsante SHAKE è un disco traslucido, quindi il suo colore è in realtà quello della scena. Il badge di rarità fluttua sopra il personaggio e si sposta con la telecamera. Durante il recupero, un pesce uscito dal bordo del riquadro sembrava una cattura conclusa. E il messaggio di cattura entra ed esce con un'animazione, accanto ad altro testo. Ognuno di questi ha richiesto un rilevatore basato su qualcosa che lo sfondo non può imitare, misurato su sessioni registrate invece che regolato a occhio. La scheda Tecnica li affronta uno per uno.

5. La fine

   Gratuita, pubblica e ancora in crescita

   La versione 0.1.0 è diventata pubblica su GitHub il 2 ottobre 2026, con un server Discord per l'assistenza, e la 0.1.2 è arrivata tre giorni dopo: testo letto sulla scheda video, cattura dello schermo più veloce e ripresa automatica quando la pesca si blocca. Si scarica gratis, e il suo codice sorgente non è pubblicato.

   La prossima versione aggiunge le abilità automatiche: l'app spende i punti abilità nell'ordine che scegli e fa rebirth da sola. Per ora ce l'hanno solo i sostenitori. Con una build di prova sono arrivato al quinto posto della classifica dei rebirth di Grand Blue in pochi giorni.

   

Prossimi passi

• Esca e cibo

  Leggere l'esca e il cibo che hai dalle schermate del gioco, poi usarli da sola seguendo un ordine di priorità che scegli tu.

• Indice dei pesci

  Ogni specie con la sua rarità e il suo valore, più un tuo prezzo per ciascuna, per quando la scambi a un valore diverso.

• Notifiche

  Una notifica di Windows o un messaggio su Discord per le catture rare, la fine di una sessione, gli errori e le pause.

• Controlli di sicurezza

  Accorgersi del messaggio AFK, di un riavvio del server o di un ritorno al menu, poi fermarsi e avvisarti.

• Pesca per te

  Lancia, aspetta che un pesce abbocchi, clicca il pulsante SHAKE, gioca il minigioco di recupero e rilancia, finché non la fermi.

• Legge ogni cattura

  Il nome del pesce, le sue mutazioni, la rarità e quanto vale, dal messaggio che il gioco mostra a schermo.

• Conserva le sessioni

  Una dashboard dal vivo mentre peschi e un Inventario delle sessioni passate con grafici, un registro con ricerca ed export CSV.

• Lascia andare alcuni pesci

  Scegli le rarità che non ti interessano e l'app le lascia andare invece di tirarle su.

• Abilità automatiche

  Spende i punti abilità nell'ordine che scegli e può fare rebirth da sola al livello di Pesca che indichi.

• Si calibra con te

  Una guida passo per passo le insegna dove sono le cose sul tuo schermo, con un'immagine per ogni passo. Fino a cinque profili.

• Non ti intralcia

  Si mette in pausa da sola quando Roblox non è la finestra in primo piano, e le azioni principali hanno tasti rapidi che funzionano nel gioco.

• Come piace a te

  Tema scuro, chiaro o quello di Windows, un colore d'accento, un font adatto alla dislessia, ed effetti sonori che ho creato per ogni parte dell'interfaccia.

La dashboard

La pagina Pesca mostra la sessione mentre succede: tempo, lanci, catture, lanci senza abboccamento e oro guadagnato, poi ogni cattura con la rarità, quanto è durato il recupero, quanto la barra è rimasta vicina al pesce e il valore.

Inventario

Ogni sessione viene salvata. L'Inventario mostra l'oro guadagnato e l'oro all'ora, la cattura del giorno, il mix di rarità e il registro completo delle catture, che puoi cercare, filtrare, copiare come riepilogo o esportare in CSV.

Abilità automatiche

Arrivano con la prossima versione, e per ora solo per i sostenitori. Scegli l'ordine delle abilità su una mappa dell'intero albero, e quando un livello porta abbastanza punti l'app apre l'albero tra due lanci, sblocca la prossima, chiude il menu e torna a pescare. Può anche fare rebirth da sola al livello di Pesca che scegli, poi ricominciare l'ordine dall'inizio. Si possono salvare fino a tre ordini e condividerli con un codice.

Calibrazione e impostazioni

La calibrazione è una guida passo per passo: indichi le cose su un fermo immagine del gioco, l'app le controlla una per una, e nulla cambia finché ogni passo non è superato. Le correzioni rapide rifanno un singolo pezzo dall'interno del gioco. Le impostazioni coprono tasti rapidi, rarità da saltare, abilità automatiche, tempi, motore di rilevamento, aspetto e suono.

Il ciclo di pesca

Il motore è una macchina a stati che lavora solo su catture dello schermo. Ogni decisione nasce dai pixel: non c'è nessuna API e nessun accesso alla memoria del client di Roblox.

1. Lancio

   Si sposta sul punto d'acqua calibrato, tiene premuto il mouse per il lancio e rilascia.

2. Attesa e SHAKE

   Osserva l'area del minigioco, trova e clicca ogni pulsante SHAKE che compare e chiude i popup di troppo. Rilancia dopo un timeout.

3. Abboccata

   Legge il badge di rarità sopra il personaggio. Una rarità che hai scelto di saltare viene lasciata andare riponendo la canna e riprendendola.

4. Recupero

   Segue la barra e il pesce a ogni frame e decide quando tenere premuto e quando rilasciare con un controllore predittivo che mira poco più avanti del pesce.

5. Lettura

   Legge il messaggio di cattura con l'OCR: specie, mutazioni e lunghezza, poi calcola il valore. Le mutazioni si moltiplicano tra loro.

Architettura

• Motore

  OpenCV, NumPy

  La macchina a stati e i suoi rilevatori: analisi HSV e di forma su piccole aree dello schermo, template matching con maschera e componenti connesse. Nessuna rete neurale, a parte l'OCR.

• Sessione

  Python

  Tutto ciò che sta intorno al motore: impostazioni, profili di calibrazione, tasti rapidi, avvio, stop e pausa, e il salvataggio di ogni sessione man mano.

• Interfaccia

  pywebview

  Ogni finestra è HTML, CSS e JavaScript semplice in Edge WebView2, del tutto offline, su un unico design system con tema scuro e chiaro.

• Cattura e input

  mss, DirectX, SendInput

  La cattura dello schermo della finestra del gioco, e input di mouse e tastiera inviati solo quando Roblox è la finestra in primo piano.

• Lettura del testo

  RapidOCR, ONNX Runtime

  I modelli sono inclusi nel pacchetto, quindi leggere il testo non va mai online. Usa la scheda video quando può.

• Rilascio

  Nuitka

  Compilata in un exe per Windows con tutto ciò che le serve, così i giocatori non installano Python.

Misurato, non regolato a occhio

Quando un recupero o un clic su SHAKE va storto, l'app salva ciò che ha visto: gli ultimi 90 frame della barra di recupero con la lettura di ciascuno, oppure uno screenshot del pulsante SHAKE mancato con i suoi punteggi. Ogni correzione qui sotto è partita da quelle registrazioni, e ogni rilevatore ha un benchmark costruito su screenshot reali del gioco.

Due lunghe prove

Due sessioni che ho lasciato andare da sole, lette dai file di sessione che l'app salva. Il 2 ottobre, uno stress test con la fortuna al massimo e le condizioni migliori che potessi creare. Il 12 ottobre, una prova delle abilità automatiche: l'app è salita di livello, ha speso i punti e ha fatto sei rebirth senza di me. Le catture superano i lanci per via dei pesci bonus, come Double Catch, che portano più di un pesce per lancio.

Sfide

1. 5 ott 2026

   0.1.2: più veloce e più affidabile

   Il testo si legge sulla scheda video e lo schermo si cattura più in fretta, con una nuova scheda Settings > Engine e la velocità SHAKE Instant. Un passo di calibrazione per la zona in cui si leggono i nomi dei pesci. Quando non si pesca nulla per diversi lanci, l'app ripone la canna e la riprende da sola. Meno catture false nelle scene scure, catture velocissime contate, e i pesci bonus come Second Splash registrati come catture a sé. Il registro delle attività si salva man mano.

2. 2 ott 2026

   0.1.1: si apre dopo un download dal browser

   Risolto il problema dell'app che su alcuni PC non si apriva dopo un download dal browser, perché Windows marca i file scaricati. I messaggi di errore ora indicano prima il server Discord.

3. 2 ott 2026

   0.1.0: prima versione pubblica

   Pesca da sola, legge ogni cattura, tiene una dashboard dal vivo e un Inventario delle sessioni passate, salta le rarità che scegli e si calibra con un'immagine per ogni passo, con fino a cinque profili. Tema chiaro e scuro, un colore d'accento, un font adatto alla dislessia ed effetti sonori.