okya for MapleStory
Nederlands
English한국어日本語简体中文繁體中文EspañolPortuguêsไทยTiếng ViệtDeutschFrançaisItalianoNederlandsעבריתSvenskaРусский
Inhoud van de handleiding⌄
Startpagina›Producthandleiding

01 · Productoverzicht

Lokale desktopautomatisering

MapleStory Classic World-bot

Een instelbare bot voor Global MapleStory Classic World op Windows 10/11 en Macs met Apple silicon of Intel. Lokale schermherkenning en je eigen toetsinstellingen verzorgen farming, potions en buffs. Kies stationair aanvallen, patrouilleren tussen twee punten of een eigen route. Maak de sjablonen voor je personage en monsters in de spelomgeving die je daadwerkelijk gebruikt.

Platforms
Windows 10/11 · Mac met Apple silicon / Intel
Verwerking
Lokale schermherkenning

Zo werkt okya met Classic World#

De desktopclient herkent je personage, geselecteerde monsters, minimappositie en HP/MP in het zichtbare spelvenster. Daarna verstuurt hij lokale toetsaanslagen volgens je opgeslagen strategie, zonder je MapleStory-wachtwoord nodig te hebben. De browsereditor maakt routebestanden; de bot zelf draait op je computer, niet in de browser. Laat vóór aankoop je server, spelversie en besturingssysteem door ondersteuning controleren: updates en visuele wijzigingen kunnen de compatibiliteit beïnvloeden.

Wat de desktopclient automatiseert#

Begin eenvoudig, controleer herkenning in de logs en schakel extra functies één voor één in.

Personage en monsters herkennen

Maak sjablonen voor links en rechts om zichtbare doelen te herkennen.

Farmingroutes

Val aan vanaf één plek, patrouilleer tussen twee punten of bouw een route voor maps met meerdere verdiepingen.

Automatische potions en buffs

Stel HP-/MP-drempels, toetsen, cooldowns en maximaal vijf periodieke buffs in.

Gevechten en oppakken

Stel aanvallen, springen, oppakken, richting en timing in één paneel in.

Logs en opstartcontroles

Controleer venster, minimap, personage, monsters en HP/MP voordat je begint.

Lokale profielen en routes

Bewaar, test en pas instellingen, sjablonen en routes lokaal aan.

Voordat je begint#

  • 64-bits Windows 10/11 of Mac met Apple silicon (M-serie, macOS 11+) of Intel-processor (macOS 12+)
  • MapleStory met zichtbare minimap
  • Op macOS: Toegankelijkheid en Scherm- en systeemaudio-opname toestaan
  • Geldige licentie en internet voor de eerste activering
  • Sjablonen gemaakt op het systeem en spel dat je gebruikt

Vragen over de Classic World-bot#

Werkt hij op Windows en macOS?+

Ja, op 64-bits Windows 10/11 en Macs met Apple silicon (macOS 11+) of Intel (macOS 12+), met een apart Mac-pakket per chip.

Welke Classic World-versie moet ik vóór aankoop laten controleren?+

Deze handleiding gaat over Global MapleStory Classic World. De compatibiliteit hangt af van server, spelversie, besturingssysteem en huidige spelinterface. Stuur deze gegevens vóór aankoop naar hi@okya.app. De naam Classic betekent niet dat dezelfde instellingen op elke server of na elke update werken.

Is dit een online bot of draait hij op mijn computer?+

De bot is een betaalde desktopclient die lokaal op Windows of een Mac draait. De route-editor is gratis en werkt in de browser: importeer een mapafbeelding, maak knooppunten en bewegingen, exporteer JSON en laad dat in de client. De editor zelf voert het spel of de bot niet uit.

Waar krijg ik mijn licentie en download?+

Maandelijks $19 / 30 dagen, per kwartaal $39 / 90 dagen, jaarlijks $99 / 365 dagen. Alle functies inbegrepen. Levenslange licenties worden niet meer verkocht. Na bevestiging van de betaling toont je bestelpagina de licentiesleutel en aparte downloadknoppen voor Windows en Macs met Apple silicon. Download de client via je officiële bestelling en volg daarna de installatie- en eerste configuratiestappen hieronder.

02

Handleiding

Spelbeelden#

Installatie, rechten en activering#

Installeer het juiste pakket en controleer de rechten voordat je een strategie instelt.

Installeren op Windows

Pak het volledige 64-bits ZIP-bestand uit in een vaste map. Start niet vanuit het ZIP-voorbeeld. Voer uit als administrator.

Installeren op Mac

Zet de app in Programma’s. Sta bij Privacy en beveiliging Toegankelijkheid en Scherm- en systeemaudio-opname toe. Sluit de app volledig en open opnieuw. Voor Intel-Macs is er een apart pakket.

macOS-rechten controleren

Toegankelijkheid staat bewegings-, gevechts- en hersteltoetsen toe; schermopname leest venster, personage, minimap en HP/MP. Voeg de geïnstalleerde app aan beide lijsten toe, niet Terminal, Python, oude versies of mappen. Zet beide schakelaars aan, sluit met Command-Q en open opnieuw.

Licentie activeren

Vul de hele sleutel zonder spaties ervoor of erachter in en activeer online. Wacht op de bevestiging. Vraagt macOS om Sleutelhanger-toegang, gebruik dan je Mac-inlogwachtwoord, niet de licentiesleutel.

Lokale gegevens en back-ups

Windows: %LOCALAPPDATA%\Okya\; macOS: ~/Library/Application Support/Okya/. Bewaar alleen config.json, templates en maps. Kopieer license.dat nooit naar een andere computer; activeer die apart.

Betrouwbare herkenningssjablonen maken#

Leg beide kijkrichtingen vast op het systeem en spel dat je gaat gebruiken. De sjablonen bepalen wat de client zoekt.

Personagesjablonen (15 × 15 px)

Maak een profiel met naam. Leg in beide richtingen hetzelfde stabiele gebied boven op het hoofd vast. Controleer dat alleen het personage zichtbaar is, sla op en selecteer het profiel.

Monstersjablonen (10 × 10 px)

Kies een monster met weinig animatie. Leg in beide richtingen hetzelfde kenmerkende deel vast, zoals hoofd, hoorn of ogen. Begin met één monster; één tot drie sjablonen werken meestal het stabielst.

Goede en ongeschikte opnamen

Gebruik hetzelfde lichaamsdeel zonder andere inhoud. Maak opnamen opnieuw als ze grond, platformranden, achtergrond, namen, schadegetallen, chat, pets, effecten of andere monsters bevatten.

Wanneer opnieuw vastleggen?

Maak sjablonen opnieuw na wijzigingen in outfit, effecten, spelclient of besturingssysteem. Windows en macOS kunnen pixels anders weergeven.

Eerste installatie#

Deze stappen volgen de eerste ingebruikname van de desktopclient.

  1. 1

    Installeer het pakket voor 64-bits Windows, Apple silicon of Intel. Zet de Mac-app eerst in Programma’s en verleen daarna rechten.

  2. 2

    Gebruik venstermodus of randloos venster op het hoofdscherm, met minimap en HP/MP zichtbaar.

  3. 3

    Activeer je licentie en kies de juiste server voor herkenning van minimap en HP/MP.

  4. 4

    Maak bijpassende links-/rechtssjablonen voor personage en monster. Maak ze opnieuw na grote visuele of platformwijzigingen.

  5. 5

    Test eerst stationair aanvallen met één personage, één monster en de aanvals- en springtoets.

  6. 6

    Start en lees de logs. Schakel potions, buffs en oppakken pas in nadat personage en minimap goed worden herkend.

Modi, gevechten en extra acties instellen#

Wijzig één instelling tegelijk, sla op en bekijk de logs voordat je verdergaat.

Spelvenster en basisinstellingen

Gebruik een venster op het hoofdscherm. Klap de minimap volledig uit en houd standaard-HP/MP zichtbaar. Kies de echte server, je profiel en één monster; de server bepaalt kleuren en herkenningsgebieden. Houd het lie-detectoralarm aan en test het geluid.

Begin met diagnosemodi

Alleen herkenning controleert venster, personage, monsters, minimap en HP/MP zonder gevechten. Alleen beweging test patrouilles en routes. Schakel volledige uitvoering pas na beide tests in.

Gevechten en beweging

Laat aanvals- en springtoets overeenkomen met het spel. Begin met kleine detectiebereiken; te grote bereiken kunnen doelen op andere platforms activeren.

HP en MP aanvullen

Zet HP en MP apart aan. Test met 50% en ongeveer één seconde cooldown, nooit onder 0,1 seconde. Bij 0,0% in de logs: herstel uitzetten en server, vensterpositie, interface en schermrechten controleren.

Buffs en items oppakken

Maximaal vijf periodieke buffs; test er eerst één. Elk actief vak vereist een toets en positief interval. Begin met oppakken op 0,45 seconde, minimaal 0,05. Te vaak oppakken kan aanvallen onderbreken en invoer laten opstapelen.

Eerste volledige uitvoering

Ga naar de map, open de minimap, controleer HP/MP en sla server, profiel, monster, strategie en toetsen op. Start veilig, wacht op de focus naar het spel en wissel niet van app. De bot draait pas als de logs alle startcontroles bevestigen.

Controle in 30 seconden

Controleer map, veilige plek, hoofdscherm, minimap, server/profiel/monster/strategie, alle toetsen, voorraad, inventarisruimte en hoorbaar lie-detectoralarm.

Drie mapstrategieën#

Kies op basis van de map en test bewegingen eerst zonder extra acties.

Stationair aanvallen

Geschikt voor de eerste test op een vast platform. De startpositie wordt opgeslagen; de bot kan na terugslag proberen terug te keren.

Tweepuntspatrouille

Beweeg tussen A en B met instelbare pauzes en optionele aanvallen op de eindpunten.

Eigen routepatrouille

Volgt een editorroute met knooppunten, platforms en acties die bij de huidige map past.

Eigen route maken en gebruiken#

Beschrijf de beweging op een specifieke map met dezelfde map en spelweergave als in de client.

Een route in drie stappen

  1. 1
    De gebruikte map importeren

    Maak een screenshot met dezelfde map, venstermodus en minimapindeling. Kies Map importeren. Gebruik geen gidsbeelden, geschaalde beelden of andere setups: coördinaten kunnen afwijken.

  2. 2
    Minimap linksboven bijsnijden

    Kies Bijsnijden, klik beide hoeken van de minimap en sla op. Neem het hele begaanbare gebied op, zonder spelwereld, chat of quests. Controleer of de uitsnede bij de herkenning van de client past.

  3. 3
    Knooppunten plaatsen en route verbinden

    Plaats knooppunten bij bochten, landingen, touwen, ladders en portalen. Markeer platforms, verbind buren en kies lopen, springen, klimmen, vallen of teleporteren. Exporteer, importeer bij de juiste map en test beweging vóór gevechten of oppakken.

Updates, back-ups en ondersteuning#

Bewaar geteste instellingen, maar verplaats geen apparaatgebonden licentiegegevens of geheimen.

Vóór een update

Stop de strategie, sluit de app en bewaar config.json, templates en maps. Installeer de nieuwe versie apart en controleer versie, sjablonen, server, toetsen en strategie.

Naar een andere computer

Controleer en verplaats instellingen en routes, niet license.dat. Activeer het nieuwe apparaat, verleen rechten en maak sjablonen opnieuw.

Gekoppeld apparaat wijzigen

De licentie is gekoppeld aan het apparaat waarop ze voor het eerst is geactiveerd. Wissel je van computer, installeer je het systeem opnieuw of vervang je hardware, neem dan contact op met support (hi@okya.app) met je bestelnummer om de koppeling te wijzigen. Kopieer license.dat niet naar het nieuwe apparaat.

Ondersteuning inschakelen

Vermeld appversie, systeem en chip, server, venstermodus, strategie, parameters en volledig opstartlog tot de eerste fout. Verwijder sleutels, apparaat-ID’s, accountnamen en andere geheimen.

03

Probleemoplossing

Zoek het symptoom, pas de oplossing toe en stop bij de eerste stap die werkt. Rond eerst de basisinstellingen af voordat je een specifiek probleem onderzoekt.

Problemen in de juiste volgorde oplossen#

Volg de logs: los eerst de vroegste mislukte startcontrole op voordat je strategieparameters wijzigt.

Spelvenster niet gevonden

Open het spel in venstermodus op het hoofdscherm. Controleer op macOS schermopnamerechten en herstart de app na wijzigingen.

Personage, monster of minimap niet herkend

Verwijder visuele obstakels, controleer server en sjabloon, open de minimap en leg beide richtingen opnieuw vast. Test één monster.

HP en MP beide op 0,0%

Zet automatisch herstel uit. Controleer server, standaardinterface, vensterpositie en schermrechten en test opnieuw.

Monsters gemist of verkeerd herkend

Kies één monster en leg in beide richtingen een stabiel animatiebeeld vast. Gebruik een kenmerkend deel zonder achtergrond. Vervang sjablonen met achtergrond of van een ander systeem.

Wel herkenning, geen toetsen

Geef het spel focus, controleer toetsen en Toegankelijkheid op macOS. Start op Windows als administrator.

macOS blijft om rechten vragen

Verwijder oude versies, testversies, Python, Terminal of gelijknamige mappen. Voeg de huidige app uit Programma’s aan beide lijsten toe, zet aan, sluit met Command-Q en open opnieuw.

Patrouille loopt over de rand

Zet A en B verder van de rand en test alleen beweging. Detectie-intervallen en traagheid kunnen kort doorschieten veroorzaken.

Installatie en activering#

macOS meldt dat de ontwikkelaar niet kan worden geverifieerd, of dat de app beschadigd is+
Dit kun je controleren

Controleer eerst of het pakket van het officiële adres komt, volledig is gedownload en past bij je chip (Apple silicon of Intel). Een melding „beschadigd” alleen vertelt je niet de echte oorzaak.

Is de bron betrouwbaar, open dan Systeeminstellingen → Privacy en beveiliging en zoek „Toch openen”. Lukt het nog steeds niet, neem dan contact op met support met de volledige melding, de clientversie, de Mac-chip en de macOS-versie.

Na het opnieuw installeren van het systeem of het wisselen van computer meldt de licentie dat ze al gekoppeld is+
Hoe het werkt

Eén licentie is aan één apparaat gekoppeld. Hetzelfde apparaat kan wisselen tussen gameaccounts, maar dat staat niet toe om meerdere games tegelijk te draaien of één licentie op meerdere computers of virtuele machines te gebruiken.

Verschijnt er na een herinstallatie of een nieuw apparaat een koppelingsmelding, mail dan naar hi@okya.app met je bestelnummer zodat de koppeling kan worden gecontroleerd en gewijzigd.

Blijf niet de licentie van iemand anders proberen en plaats je volledige licentiesleutel nooit op forums of in openbare screenshots.

De licentiecontrole is geslaagd, waarom start het dan niet?+
Hoe het werkt

„License check passed” betekent alleen dat de licentie geldig is. Het betekent niet dat gamevenster, personage, minimap en opnamebron allemaal zijn herkend.

Lees het log verder om te zien of het mislukte bij de vensteropname, de personageherkenning of de minimapherkenning, en gebruik dan het bijpassende onderdeel hieronder.

Beveiligingssoftware blokkeert of markeert het programma+
Dit kun je controleren

Op Windows moet het programma als beheerder worden gestart. Compatibiliteit met elke antiviruscofiguratie kan niet worden gegarandeerd.

Stuur support de exacte waarschuwing en de plek waar je het pakket hebt gedownload, zodat zij het officiële bestand kunnen controleren. Beveiligingssoftware uitschakelen of uitzonderingen toevoegen hoort niet je standaardoplossing te zijn.

Start en vensteropname#

Het gamevenster wordt niet gevonden, of de resolutie klopt niet+
Dit kun je controleren

Loop deze punten in volgorde na:

  1. Controleer of het echte gamevenster 1366 × 768 is, en niet alleen dat de instelling dat op volledig scherm toont.
  2. Gebruik de venstermodus en houd het hele venster zichtbaar: niet geminimaliseerd, niet gemaximaliseerd en niet bedekt door andere vensters.
  3. Als je versie een opnamebron laat kiezen, selecteer dan het echte gamevenster.
  4. Stop na het wijzigen van de resolutie de run en start opnieuw; herstart de client indien nodig.
  5. Neem de sjablonen voor personage en monsters opnieuw op wanneer de resolutie of schermgrootte verandert.
Op Mac staan de rechten aan, maar Start doet niets+
Dit kun je controleren

Zorg dat Toegankelijkheid en Schermopname zijn ingeschakeld voor de client die echt draait, en lees het volledige startlog.

In één geval leek het recht fout, maar de echte blokkade was de herkenning van de sjablonen voor personage en monsters. Schakel rechten niet steeds om vanwege één waarschuwing; controleer ook de venstergrootte, de minimap, het personagesjabloon en de opnamebron.

Blijft het probleem, stuur dan het rechtenscherm, de clientinstellingen, een screenshot van het hele bureaublad en het startlog.

Het log toont „Game is not in the foreground”+
Hoe het werkt

Klikken op de instellingen of het logvenster van de client haalt de focus van de game, dus deze melding is dan normaal. Stop de run voordat je instellingen wijzigt, start opnieuw en klik terug in de game zodat die vooraan blijft.

Staat de game echt vooraan en blijft de melding komen, stuur dan het volledige log en je schermindeling in plaats van aan te nemen dat het jouw fout is.

Het log toont een 0 × 0-venster of „minimap not detected”+
Dit kun je controleren

Er zijn meldingen van een venstergrootte van 0 × 0, een terugval naar volledig-scherm-opname van het hoofdscherm en „minimap not detected” tegelijk. Controleer of de game niet is geminimaliseerd, de opgenomen bron het gamevenster is en de minimap is uitgeklapt zodat de spelermarkering zichtbaar is.

Houd het personage bij de start stil en buiten een gevecht. Blijft het mislukken, stuur dan het volledige log en een screenshot van het hele gamevenster.

Herkenning van personage en monsters#

Het personage raakt steeds kwijt. Hoe neem ik het sjabloon op?+
Dit kun je controleren

Neem het personage op terwijl het normaal staat, niet knipperend door een treffer. Geef de voorkeur aan het bovenlichaam, vooral een duidelijk, stabiel kenmerk bij het hoofd.

  1. Laat skilltekst, schadegetallen, achtergronddecoratie en grote effecten weg.
  2. Neem links- en rechtskijkend apart op, sla op en kies het profiel.
  3. Zorg dat effecten het personage tijdens de run niet bedekken.
  4. Neem opnieuw op na het wijzigen van de gameresolutie; blijf geen sjabloon met de oude grootte gebruiken.
Het monstersjabloon is opgeslagen, maar monsters worden nog steeds niet herkend+
Dit kun je controleren

Sluit eerst het volgende onderdeel uit (een telling van 0 omdat monsters buiten het aanvalsbereik zijn) en controleer dan het sjabloon:

  1. Kies een monster met een stabiele pose en een duidelijk kenmerk, zoals de bovenkant van het hoofd of een hoorn.
  2. Neem hetzelfde kenmerk op bij links- en rechtskijkend.
  3. Vermijd achtergrond, schadegetallen en skilleffecten.
  4. Neem opnieuw op in de resolutie die je echt gebruikt en controleer of het sjabloon is gekozen.
  5. Test met slechts één gekozen monster, zodat de oorzaak makkelijker te zien is.
Er staan monsters op het scherm, maar het log toont 0+
Hoe het werkt

Het log telt alleen monsters binnen het horizontale aanvalsbereik dat je hebt ingesteld, niet elk monster op het scherm. Een 0 voor monsters buiten dat bereik is normaal.

Kijk of de telling verandert zodra een monster het bereik in komt. Alleen als hij op 0 blijft terwijl een monster binnen het bereik is, controleer je het sjabloon en de herkenningsinstellingen. Neem sjablonen niet opnieuw op alleen omdat je een 0 zag.

Wat moet ik controleren voor minimap en personageherkenning?+
Dit kun je controleren

Controleer of de juiste server is gekozen, de minimap volledig is uitgeklapt met de spelermarkering zichtbaar en de game de juiste resolutie en venstermodus heeft. Blijf bij de start stil en buiten een gevecht.

Let in het log op CHARACTER_RECOGNITION, MINIMAP_RECOGNITION of MARKER_COLOR_ABSENT en controleer personage en minimap apart. Een geslaagd personageresultaat bewijst niet dat de minimap werkte.

Gevecht en aanvalsbereik#

Het beweegt alleen heen en weer en vecht nooit+
Dit kun je controleren

Controleer in volgorde: personage en minimap worden herkend, het monstersjabloon is gekozen, monsters staan binnen het ingestelde aanvalsbereik, de aanvalstoets komt overeen met de game en de skill is al geleerd.

Ga terug naar aanvallen op de plaats om de basisherkenning en de toetsen te controleren. Alleen van patrouillemodus wisselen bewijst niet dat het is opgelost.

Hoe stel ik het horizontale aanvalsbereik in?+
Hoe het werkt

De waarde is een afstand in pixels op het gamescherm. Baseer hem op de echte aanvalsafstand van je personage bij je huidige weergave-instellingen.

Een screenshottool dat de selectiegrootte in pixels toont, helpt bij het meten. Kopieer het getal van een andere klasse niet; er is geen waarde die altijd klopt. Voor een korte beginnersdolk heeft support 50 pixels of minder voorgesteld, wat een voorbeeld is voor korte aanvallen en geen standaard voor elke klasse.

Het blijft lege grond aanvallen en verspilt MP of verbruiksgoederen+
Dit kun je controleren

Een te groot aanvalsbereik kan de client monsters laten proberen te raken die je niet bereikt, en een instabiel sjabloon kan missers of valse treffers geven. Controleer je echte aanvalsafstand, de sjabloonkwaliteit en het huidige herkenningsresultaat.

Blijft het in het niets slaan, stop dan de run om geen middelen te verspillen en stuur support je aanvalsinstellingen, de sjablonen en een korte notitie over hoe je het reproduceert. Er is geen schakelaar die garandeert dat aanvallen stoppen als er geen monster is.

Ik heb een instelling gewijzigd, maar er lijkt niets te veranderen+
Hoe het werkt

Wijzigingen worden niet toegepast op een sessie die al draait. Doe het in volgorde: run stoppen → opslaan → opnieuw starten.

Controleer na het wijzigen van aanvalsbereik, skilltoetsen, tellingsdrempel of resolutie het echte effect opnieuw.

Patrouille en kaarteditor#

Hoe importeer ik een route? Is er een voorbeeldkaart?+
Hoe het werkt

De kaarteditor bevat een voorbeeldkaart: gebruik „Load sample map” om de structuur te zien en bouw dan je eigen route.

Kies om te importeren de patrouille met eigen route, gebruik Import naast het kaartenmenu en selecteer het geëxporteerde JSON-bestand. Namen kunnen per versie verschillen; vind je de knop niet, stuur dan een screenshot van de client in plaats van een knop te gokken die niet bestaat.

Gebruik bij het exporteren alleen Engelse letters en cijfers voor Map Name en Map ID.

Ik heb een kaart geëxporteerd, maar „Add to OKYA” verschijnt niet+
Hoe het werkt

Download het .json-bestand dat de editor exporteert en gebruik dan Import naast de kaartenlijst in de patrouille met eigen route van de desktopclient. Als het lukt, verschijnt de kaart in het menu.

Je hoeft het niet met de hand naar assets/maps te kopiëren; die map is voor ingebouwde kaarten. Lukt importeren nog steeds niet, controleer dan Map Name, Map ID en de bestandsnaam en stuur support de geëxporteerde JSON met een screenshot van de fout. Ga er niet van uit dat het bestandsformaat fout is alleen omdat het importeren mislukte.

Dit hoort in je bericht aan support#

Stuur alles in één keer mee om heen-en-weer te beperken.

  • Besturingssysteem en versie; vermeld bij een Mac of het Apple silicon of Intel is.
  • Het exacte versienummer van de client.
  • Gamenaam, server, venstermodus en resolutie.
  • Of je een extern scherm gebruikt, en de schaal van het scherm.
  • De stappen die je zette, wat je verwachtte en wat er echt gebeurde.
  • Het volledige log, niet alleen de laatste regel.
  • Een screenshot van het hele bureaublad waarop zowel de game als de clientinstellingen te zien zijn; voeg bij herkenningsproblemen de sjablonen voor links- en rechtskijkend toe.
  • Bij toetsproblemen de toetsinstellingen aan zowel de game- als de clientkant.
  • Bij prestatieproblemen hoelang het draaide en de relevante meetgegevens; een korte video helpt als je die veilig kunt opnemen.