01 · Panoramica
Automazione locale sul desktop
Bot MapleStory Classic World
Un bot configurabile per Global MapleStory Classic World, da eseguire su Windows 10/11 o Mac con chip Apple o Intel. Il riconoscimento dello schermo e i tasti che imposti gestiscono farming, pozioni e buff. Scegli attacco da fermo, pattuglia tra due punti o un percorso personalizzato, acquisendo i modelli del personaggio e dei mostri nell’ambiente di gioco che userai.
- Piattaforme
- Windows 10/11 · Mac con chip Apple / Intel
- Elaborazione
- Riconoscimento locale dello schermo
Come funziona okya con Classic World#
Il client desktop riconosce personaggio, mostri selezionati, posizione sulla minimappa e aree HP/MP nella finestra di gioco visibile. Poi invia i tasti locali in base alla strategia salvata, senza richiedere la password di MapleStory. L’editor nel browser crea i file dei percorsi; il bot viene eseguito sul computer, non nella pagina web. Prima di acquistare, verifica con l’assistenza server, versione del gioco e sistema operativo: aggiornamenti e cambiamenti grafici possono influire sulla compatibilità.
Cosa può automatizzare il client#
Parti da una configurazione minima, verifica il riconoscimento nei log e attiva le opzioni una alla volta.
Riconoscimento di personaggio e mostri
Crea modelli rivolti a sinistra e a destra per individuare i bersagli visibili.
Percorsi di farming
Attacca da fermo, pattuglia tra due punti o crea percorsi per mappe a più livelli.
Pozioni e buff automatici
Imposta soglie HP/MP, tasti, tempi di recupero e fino a cinque buff periodici.
Combattimento e raccolta
Configura attacco, salto, raccolta, direzione e tempi da un unico pannello.
Log e controlli iniziali
Verifica finestra, minimappa, personaggio, mostri e HP/MP prima dell’esecuzione.
Profili e percorsi locali
Salva, prova e modifica localmente configurazioni, modelli e percorsi.
Prima di iniziare#
- Windows 10/11 a 64 bit o Mac con chip Apple serie M (macOS 11+) o processore Intel (macOS 12+)
- MapleStory con minimappa visibile
- Su macOS: autorizza Accessibilità e Registrazione schermo e audio di sistema
- Licenza valida e connessione per la prima attivazione
- Modelli acquisiti sul sistema e gioco effettivamente usati
Domande sul bot Classic World#
Funziona su Windows e macOS?+
Sì, su Windows 10/11 a 64 bit e Mac con chip Apple (macOS 11+) o Intel (macOS 12+), con un pacchetto Mac per ciascun chip.
Quale versione di Classic World devo verificare prima dell’acquisto?+
Questa guida riguarda Global MapleStory Classic World. La compatibilità dipende da server, versione del gioco, sistema operativo e interfaccia attuale. Invia questi dati a hi@okya.app prima di acquistare. Il nome Classic non significa che ogni server o aggiornamento funzioni con la stessa configurazione.
È un bot online o un programma da installare sul computer?+
Il bot è un client desktop a pagamento che viene eseguito localmente su Windows o Mac. L’editor dei percorsi è gratuito e funziona nel browser: importa un’immagine della mappa, crea nodi e movimenti, esporta il JSON e caricalo nel client. L’editor non esegue né il gioco né il bot.
Come ricevo la licenza e scarico il client?+
Mensile $19 / 30 giorni, trimestrale $39 / 90 giorni, annuale $99 / 365 giorni. Tutte le funzioni incluse. Le licenze a vita non sono più in vendita. Dopo la conferma del pagamento, la pagina dell’ordine mostra la chiave e i pulsanti di download separati per Windows e Mac con chip Apple. Scarica il client dall’ordine ufficiale e segui le istruzioni di installazione e prima configurazione qui sotto.
02
Guida all’uso
Schermate di gioco#
Installazione, permessi e attivazione#
Installa il pacchetto corretto e verifica i permessi prima di configurare una strategia.
Installazione su Windows
Estrai l’intero ZIP a 64 bit in una cartella permanente. Non avviare dall’anteprima ZIP. Esegui come amministratore.
Installazione su Mac
Sposta l’app in Applicazioni. In Privacy e sicurezza autorizza Accessibilità e Registrazione schermo e audio di sistema, quindi chiudi e riapri l’app. Per i Mac Intel c’è un pacchetto separato.
Verifica i permessi macOS
Accessibilità consente i tasti di movimento, combattimento e recupero; la registrazione permette di leggere finestra, personaggio, minimappa e HP/MP. Aggiungi l’app installata a entrambi gli elenchi, non Terminale, Python, vecchie versioni o cartelle. Abilita entrambe le opzioni, chiudi con Command-Q e riapri.
Attiva la licenza
Inserisci la chiave completa senza spazi iniziali o finali e attivala online. Attendi la conferma. Se macOS chiede il Portachiavi, usa la password di accesso del Mac, non la licenza.
Dati locali e backup
Windows: %LOCALAPPDATA%\Okya\; macOS: ~/Library/Application Support/Okya/. Salva solo config.json, templates e maps. Non copiare license.dat: attiva separatamente il nuovo dispositivo.
Crea modelli di riconoscimento affidabili#
Acquisisci entrambe le direzioni sul sistema e gioco che userai. I modelli indicano al client cosa cercare.
Modelli del personaggio (15 × 15 px)
Crea un profilo con nome. Cattura la stessa zona stabile sulla testa in entrambe le direzioni. Verifica che le anteprime contengano solo il personaggio, salva e seleziona il profilo.
Modelli dei mostri (10 × 10 px)
Scegli un mostro con poca animazione. Cattura la stessa zona distintiva nei due versi, come testa, corno o occhi. Inizia con un mostro; da uno a tre modelli sono in genere più stabili.
Campioni validi e da rifare
Inquadra la stessa parte senza elementi estranei. Rifai le immagini con terreno, bordi, sfondo, nomi, danni, chat, pet, effetti o altri mostri.
Quando rifare le acquisizioni
Ricrea i modelli dopo cambi a vestiti, effetti, client o sistema: Windows e macOS possono rendere i pixel in modo diverso.
Prima configurazione#
Questi passaggi seguono la procedura del client desktop.
- 1
Installa il pacchetto Windows a 64 bit, Mac con chip Apple o Mac Intel. Su macOS sposta prima l’app in Applicazioni, poi concedi i permessi.
- 2
Usa la modalità finestra o senza bordi sullo schermo principale, con minimappa e HP/MP visibili.
- 3
Attiva la licenza e seleziona il server corretto per riconoscere minimappa e HP/MP.
- 4
Cattura modelli coerenti sinistra/destra per personaggio e mostro. Rifalli dopo cambiamenti visivi o di piattaforma.
- 5
Per la prima prova scegli l’attacco da fermo con un personaggio, un mostro e i tasti attacco e salto.
- 6
Avvia e leggi i log. Attiva pozioni, buff e raccolta solo dopo il riconoscimento di personaggio e minimappa.
Configura modalità, combattimento e opzioni#
Cambia un’impostazione alla volta, salva e controlla il log prima di attivare altro.
Finestra del gioco e impostazioni di base
Usa una finestra sullo schermo principale. Espandi la minimappa e lascia visibili gli HP/MP predefiniti. Scegli il server reale, il profilo e un mostro: il server determina colori e aree. Lascia attivo l’avviso del rilevatore di bugie e prova l’audio.
Inizia dalle modalità diagnostiche
Solo riconoscimento verifica finestra, personaggio, mostri, minimappa e HP/MP senza combattere. Solo movimento prova pattuglia o percorso. Attiva l’esecuzione completa dopo entrambi i test.
Combattimento e movimento
Abbina attacco e salto ai tasti del gioco. Parti da distanze di rilevamento ridotte: valori troppo alti possono attivare bersagli su altre piattaforme.
Recupero HP e MP
Attiva HP e MP separatamente. Prova il 50% con circa un secondo di recupero, mai sotto 0,1 secondi. Se il log mostra 0,0%, disattiva le pozioni e verifica server, finestra, interfaccia e permessi schermo.
Buff e raccolta oggetti
Fino a cinque buff programmati; provane prima uno. Ogni slot attivo richiede un tasto e un intervallo positivo. Per la raccolta parti da 0,45 secondi, minimo 0,05. Una frequenza eccessiva può interrompere gli attacchi e accodare input.
Prima esecuzione completa
Entra nella mappa, apri la minimappa, verifica HP/MP e salva server, profilo, mostro, strategia e tasti. Avvia da un punto sicuro, attendi il focus sul gioco e non cambiare app. L’esecuzione inizia solo dopo le conferme nei log.
Controllo in 30 secondi
Verifica mappa, punto sicuro, schermo principale, minimappa, server/profilo/mostro/strategia, tutti i tasti, scorte, inventario e allarme udibile del rilevatore.
Tre strategie per le mappe#
Scegli in base alla mappa e prova prima i movimenti senza azioni aggiuntive.
Attacco da fermo
Ideale per la prima prova su una piattaforma fissa. La posizione iniziale viene salvata; il bot può tentare di tornarvi dopo un contraccolpo.
Pattuglia tra due punti
Muoviti tra A e B con pause regolabili e attacchi opzionali alle estremità.
Pattuglia su percorso personalizzato
Segue un percorso dell’editor con nodi, piattaforme e azioni, compatibile con la mappa attuale.
Crea e usa un percorso personalizzato#
Definisci i movimenti su una mappa specifica usando la stessa mappa e vista del client.
Un percorso in tre passaggi
- 1Importa la mappa che userai
Cattura il gioco con la stessa mappa, modalità finestra e minimappa. Scegli Importa mappa. Evita immagini da guide, ridimensionate o di altre configurazioni: le coordinate possono differire.
- 2Ritaglia la minimappa in alto a sinistra
Scegli Ritaglia, indica gli angoli della minimappa e salva. Includi tutta l’area percorribile, escludendo mondo di gioco, chat e missioni. Verifica che corrisponda alla minimappa rilevata dal client.
- 3Inserisci nodi e collega il percorso
Inserisci nodi a svolte, atterraggi, corde, scale e portali. Segna le piattaforme, collega i vicini e assegna cammino, salto, arrampicata, discesa o teletrasporto. Esporta, importa per la mappa corretta e prova il movimento prima di combattere o raccogliere.
Aggiornamenti, backup e assistenza#
Conserva la configurazione collaudata, senza trasferire licenze legate al dispositivo o dati riservati.
Prima di aggiornare
Ferma la strategia, chiudi e salva config.json, templates e maps. Installa separatamente la nuova versione e verifica versione, modelli, server, tasti e strategia.
Passare a un altro computer
Trasferisci impostazioni e percorsi dopo averli controllati, non license.dat. Attiva il nuovo dispositivo, concedi i permessi e ricattura i modelli.
Cambiare il dispositivo associato
La licenza è associata al dispositivo su cui è stata attivata per la prima volta. Se cambi computer, reinstalli il sistema o sostituisci l’hardware, contatta l’assistenza (hi@okya.app) indicando il numero d’ordine per modificare l’associazione. Non copiare license.dat sul nuovo dispositivo.
Prima di contattare l’assistenza
Includi versione dell’app, sistema e chip, server, modalità finestra, strategia, parametri e log completo fino al primo errore. Rimuovi chiavi, ID dispositivo, nomi account e dati riservati.
03
Risoluzione dei problemi
Trova il sintomo, applica la soluzione e fermati al primo passaggio che funziona. Completa la configurazione di base prima di indagare su un problema specifico.
Risolvi i problemi nell’ordine giusto#
Segui il log: risolvi il primo controllo fallito prima di cambiare la strategia.
Finestra del gioco non trovata
Apri il gioco in finestra sullo schermo principale. Su macOS verifica il permesso di registrazione e riavvia l’app dopo le modifiche.
Personaggio, mostro o minimappa non riconosciuti
Rimuovi ostacoli visivi, verifica server e modello, apri la minimappa e ricattura entrambe le direzioni nell’ambiente attuale. Prova un solo mostro.
HP e MP entrambi a 0,0%
Disattiva le pozioni. Verifica server, interfaccia predefinita, posizione e permessi schermo, poi riprova.
Mostri non rilevati o confusi
Seleziona un mostro e cattura un fotogramma stabile nei due versi. Usa una zona distintiva senza sfondo. Rifai i modelli con sfondo o copiati da un altro sistema.
Riconoscimento corretto, ma nessun comando
Riporta il focus al gioco, verifica i tasti e Accessibilità su macOS. Su Windows avvia come amministratore.
macOS continua a chiedere i permessi
Rimuovi vecchie voci, versioni di test, Python, Terminale o cartelle omonime. Aggiungi l’app attuale da Applicazioni a entrambi gli elenchi, attiva, chiudi con Command-Q e riapri.
La pattuglia supera il bordo
Sposta A e B verso l’interno della piattaforma e prova solo il movimento. Intervalli di rilevamento e inerzia possono causare un breve superamento.
Installazione e attivazione#
macOS dice che lo sviluppatore non può essere verificato o che l’app è danneggiata+
Controlla prima che il pacchetto provenga dall’indirizzo ufficiale, sia stato scaricato per intero e corrisponda al tuo chip (Apple silicon o Intel). Il solo messaggio «danneggiato» non indica la causa reale.
Se la fonte è affidabile, apri Impostazioni di Sistema → Privacy e sicurezza e cerca «Apri comunque». Se continua a non aprirsi, contatta l’assistenza con il messaggio completo, la versione del client, il chip del Mac e la versione di macOS.
Dopo aver reinstallato il sistema o cambiato computer, la licenza risulta già associata+
Una licenza è associata a un dispositivo. Lo stesso dispositivo può cambiare account di gioco, ma questo non consente di eseguire più giochi insieme né di usare una licenza su più computer o macchine virtuali.
Se compare un messaggio di associazione dopo una reinstallazione o con un nuovo dispositivo, scrivi a hi@okya.app con il numero d’ordine perché l’associazione venga verificata e cambiata.
Non continuare a provare la licenza di un’altra persona e non pubblicare mai la chiave completa su forum o in screenshot pubblici.
Il controllo della licenza è riuscito, perché non si avvia?+
«License check passed» significa solo che la licenza è valida. Non significa che finestra di gioco, personaggio, minimappa e sorgente di acquisizione siano stati riconosciuti.
Continua a leggere il log per vedere se l’errore è nell’acquisizione della finestra, nel riconoscimento del personaggio o in quello della minimappa, poi usa la voce corrispondente qui sotto.
Il software di sicurezza blocca o segnala il programma+
Su Windows il programma deve essere avviato come amministratore. Non si può garantire la compatibilità con ogni configurazione di antivirus.
Invia all’assistenza l’avviso esatto e il luogo da cui hai scaricato il pacchetto, così potrà controllare il file ufficiale. Disattivare il software di sicurezza o aggiungere esclusioni non dovrebbe essere la soluzione predefinita.
Avvio e acquisizione della finestra#
La finestra del gioco non viene trovata o la risoluzione è sbagliata+
Procedi in quest’ordine:
- Verifica che la finestra reale del gioco sia 1366 × 768, e non solo che l’impostazione lo mostri a schermo intero.
- Usa la modalità finestra e tieni visibile tutta la finestra: non ridotta a icona, non ingrandita, non coperta da altre finestre.
- Se la tua versione consente di scegliere una sorgente di acquisizione, seleziona la finestra reale del gioco.
- Dopo aver cambiato la risoluzione, ferma l’esecuzione e riavvia; riavvia il client se necessario.
- Rifai i modelli del personaggio e dei mostri ogni volta che cambiano risoluzione o dimensione dello schermo.
Su Mac i permessi sono attivi ma Avvia non fa nulla+
Assicurati che Accessibilità e Registrazione schermo siano attivi per il client effettivamente in esecuzione e leggi il log di avvio completo.
In un caso il permesso sembrava sbagliato, ma il vero ostacolo era il riconoscimento dei modelli del personaggio e dei mostri. Non attivare e disattivare i permessi di continuo per un solo avviso; controlla anche dimensione della finestra, minimappa, modello del personaggio e sorgente di acquisizione.
Se persiste, invia la schermata dei permessi, le impostazioni del client, uno screenshot dell’intero desktop e il log di avvio.
Il log mostra «Game is not in the foreground»+
Cliccare sulle impostazioni o sulla finestra del log del client toglie il focus al gioco, quindi in quel caso il messaggio è normale. Ferma l’esecuzione prima di cambiare le impostazioni, poi riavvia e clicca di nuovo sul gioco perché resti davanti.
Se il gioco è davvero davanti e il messaggio continua, invia il log completo e la disposizione dello schermo invece di pensare che sia un tuo errore.
Il log mostra una finestra 0 × 0 o «minimap not detected»+
Ci sono segnalazioni di una finestra di 0 × 0, di un ripiego sull’acquisizione a schermo intero del monitor principale e di «minimap not detected» insieme. Verifica che il gioco non sia ridotto a icona, che la sorgente acquisita sia la finestra del gioco e che la minimappa sia espansa in modo che il marcatore del giocatore sia visibile.
All’avvio tieni il personaggio fermo e fuori dal combattimento. Se continua a fallire, invia il log completo e uno screenshot dell’intera finestra di gioco.
Riconoscimento di personaggio e mostri#
Il personaggio si perde di continuo. Come devo acquisire il modello?+
Acquisisci il personaggio in piedi in modo normale, non lampeggiante per un colpo. Preferisci la parte superiore del corpo, soprattutto un tratto chiaro e stabile vicino alla testa.
- Escludi testo delle abilità, numeri dei danni, decorazioni dello sfondo ed effetti grandi.
- Acquisisci separatamente la direzione sinistra e destra, salva e seleziona il profilo.
- Evita che gli effetti coprano il personaggio durante l’esecuzione.
- Rifai l’acquisizione dopo aver cambiato la risoluzione del gioco; non continuare a usare un modello di dimensioni vecchie.
Il modello del mostro è salvato ma i mostri non vengono ancora riconosciuti+
Escludi prima la voce successiva (un conteggio di 0 perché i mostri sono fuori dalla portata d’attacco) e poi controlla il modello:
- Scegli un mostro con posa stabile e un tratto chiaro, come la parte alta della testa o un corno.
- Acquisisci lo stesso tratto sia rivolto a sinistra sia a destra.
- Evita sfondo, numeri dei danni ed effetti delle abilità.
- Rifai l’acquisizione alla risoluzione che usi davvero e verifica che il modello sia selezionato.
- Prova con un solo mostro selezionato, così la causa è più facile da vedere.
Ci sono mostri sullo schermo ma il log mostra 0+
Il log conta solo i mostri dentro la portata d’attacco orizzontale che hai configurato, non tutti quelli sullo schermo. Uno 0 per i mostri fuori da quella portata è normale.
Osserva se il conteggio cambia quando un mostro entra nella portata. Solo se resta a 0 mentre un mostro è dentro la portata devi controllare il modello e le impostazioni di riconoscimento. Non rifare i modelli solo perché hai visto uno 0.
Cosa devo controllare per minimappa e riconoscimento del personaggio?+
Verifica che sia selezionato il server giusto, che la minimappa sia completamente espansa con il marcatore del giocatore visibile e che il gioco abbia la risoluzione e la modalità finestra corrette. All’avvio resta fermo e fuori dal combattimento.
Cerca nel log CHARACTER_RECOGNITION, MINIMAP_RECOGNITION o MARKER_COLOR_ABSENT e controlla separatamente personaggio e minimappa. Un personaggio riconosciuto non dimostra che la minimappa abbia funzionato.
Combattimento e portata d’attacco#
Si muove solo avanti e indietro e non combatte mai+
Controlla in ordine: personaggio e minimappa sono riconosciuti, il modello del mostro è selezionato, i mostri sono nella portata d’attacco configurata, il tasto d’attacco corrisponde al gioco e l’abilità è già stata appresa.
Torna all’attacco sul posto per verificare riconoscimento di base e tasti. Cambiare modalità di pattuglia non dimostra da solo che sia risolto.
Come imposto la portata d’attacco orizzontale?+
Il valore è una distanza in pixel sullo schermo di gioco. Basalo sulla distanza d’attacco reale del tuo personaggio con le impostazioni di visualizzazione attuali.
Uno strumento di screenshot che mostri la dimensione della selezione in pixel può aiutare a misurare. Non copiare il numero di un’altra classe; non esiste un valore sempre giusto. Per un pugnale corto da principiante l’assistenza ha suggerito 50 pixel o meno, ed è un esempio per gli attacchi a corto raggio, non un valore predefinito per ogni classe.
Attacca di continuo il terreno vuoto e spreca MP o consumabili+
Una portata d’attacco troppo grande può spingere il client a colpire mostri irraggiungibili, e un modello instabile può causare mancati riconoscimenti o falsi riscontri. Controlla la distanza d’attacco reale, la qualità del modello e il risultato attuale del riconoscimento.
Se continua a colpire il vuoto, ferma l’esecuzione per non sprecare risorse e invia all’assistenza le impostazioni d’attacco, i modelli e una breve nota su come riprodurlo. Non esiste un interruttore che garantisca di fermare gli attacchi quando non ci sono mostri.
Ho cambiato un’impostazione ma non sembra cambiare nulla+
Le modifiche non vengono applicate a una sessione già in esecuzione. Procedi in quest’ordine: ferma l’esecuzione → salva → riavvia.
Dopo aver cambiato portata d’attacco, tasti delle abilità, soglia di conteggio o risoluzione, verifica di nuovo l’effetto reale.
Pattuglia ed editor di mappe#
Come importo un percorso? Esiste una mappa di esempio?+
L’editor di mappe include una mappa di esempio: usa «Load sample map» per vedere la struttura, poi crea il tuo percorso.
Per importare, scegli la pattuglia con percorso personalizzato, usa Import accanto al menu delle mappe e seleziona il file JSON esportato. I nomi possono variare tra le versioni; se non trovi il controllo, invia uno screenshot del client invece di indovinare un pulsante che non esiste.
Quando esporti, usa solo lettere inglesi e cifre per Map Name e Map ID.
Ho esportato una mappa ma «Add to OKYA» non compare+
Scarica il file .json esportato dall’editor, poi usa Import accanto all’elenco delle mappe nella pattuglia con percorso personalizzato del client desktop. Se funziona, la mappa compare nel menu.
Non serve copiarla a mano in assets/maps; quella cartella è per le mappe integrate. Se continua a non importarsi, controlla Map Name, Map ID e il nome del file, e invia all’assistenza il JSON esportato con uno screenshot dell’errore. Non dare per scontato che il formato del file sia sbagliato solo perché l’importazione è fallita.
Cosa includere quando contatti l’assistenza#
Invia tutto insieme per ridurre i botta e risposta.
- Sistema operativo e versione; per un Mac, indica Apple silicon o Intel.
- Il numero di versione esatto del client.
- Nome del gioco, server, modalità finestra e risoluzione.
- Se usi un monitor esterno e la scala dello schermo.
- I passaggi eseguiti, ciò che ti aspettavi e ciò che è successo davvero.
- Il log completo, non solo l’ultima riga.
- Uno screenshot dell’intero desktop che mostri sia il gioco sia le impostazioni del client; per i problemi di riconoscimento, aggiungi i modelli rivolti a sinistra e a destra.
- Per i problemi dei tasti, le impostazioni dei tasti sia nel gioco sia nel client.
- Per i problemi di prestazioni, per quanto tempo è rimasto in esecuzione e i dati di monitoraggio utili; un breve video aiuta se puoi registrarlo in sicurezza.