okya for MapleStory
Italiano
English한국어日本語简体中文繁體中文EspañolPortuguêsไทยTiếng ViệtDeutschFrançaisItalianoNederlandsעבריתSvenskaРусский
Indice della guida⌄
Home›Guida al prodotto

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. 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. 2

    Usa la modalità finestra o senza bordi sullo schermo principale, con minimappa e HP/MP visibili.

  3. 3

    Attiva la licenza e seleziona il server corretto per riconoscere minimappa e HP/MP.

  4. 4

    Cattura modelli coerenti sinistra/destra per personaggio e mostro. Rifalli dopo cambiamenti visivi o di piattaforma.

  5. 5

    Per la prima prova scegli l’attacco da fermo con un personaggio, un mostro e i tasti attacco e salto.

  6. 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

  1. 1
    Importa 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.

  2. 2
    Ritaglia 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.

  3. 3
    Inserisci 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+
Cosa controllare

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+
Come funziona

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?+
Come funziona

«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+
Cosa controllare

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+
Cosa controllare

Procedi in quest’ordine:

  1. Verifica che la finestra reale del gioco sia 1366 × 768, e non solo che l’impostazione lo mostri a schermo intero.
  2. Usa la modalità finestra e tieni visibile tutta la finestra: non ridotta a icona, non ingrandita, non coperta da altre finestre.
  3. Se la tua versione consente di scegliere una sorgente di acquisizione, seleziona la finestra reale del gioco.
  4. Dopo aver cambiato la risoluzione, ferma l’esecuzione e riavvia; riavvia il client se necessario.
  5. 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+
Cosa controllare

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»+
Come funziona

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»+
Cosa controllare

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?+
Cosa controllare

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.

  1. Escludi testo delle abilità, numeri dei danni, decorazioni dello sfondo ed effetti grandi.
  2. Acquisisci separatamente la direzione sinistra e destra, salva e seleziona il profilo.
  3. Evita che gli effetti coprano il personaggio durante l’esecuzione.
  4. 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+
Cosa controllare

Escludi prima la voce successiva (un conteggio di 0 perché i mostri sono fuori dalla portata d’attacco) e poi controlla il modello:

  1. Scegli un mostro con posa stabile e un tratto chiaro, come la parte alta della testa o un corno.
  2. Acquisisci lo stesso tratto sia rivolto a sinistra sia a destra.
  3. Evita sfondo, numeri dei danni ed effetti delle abilità.
  4. Rifai l’acquisizione alla risoluzione che usi davvero e verifica che il modello sia selezionato.
  5. Prova con un solo mostro selezionato, così la causa è più facile da vedere.
Ci sono mostri sullo schermo ma il log mostra 0+
Come funziona

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?+
Cosa controllare

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+
Cosa controllare

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?+
Come funziona

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+
Cosa controllare

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+
Come funziona

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?+
Come funziona

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+
Come funziona

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.