01 · Présentation
Automatisation locale sur ordinateur
Bot MapleStory Classic World
Un bot configurable pour Global MapleStory Classic World, exécuté localement sous Windows 10/11 et sur Mac avec puce Apple ou Intel. La reconnaissance d’écran et vos raccourcis prennent en charge le farming, les potions et les buffs. Choisissez l’attaque fixe, la patrouille entre deux points ou un trajet personnalisé, avec des modèles du personnage et des monstres capturés dans votre environnement de jeu.
- Plateformes
- Windows 10/11 · Mac avec puce Apple / Intel
- Traitement
- Reconnaissance d’écran en local
Comment okya fonctionne avec Classic World#
Le client de bureau repère le personnage, les monstres sélectionnés, la position sur la mini-carte et les zones de PV/PM dans la fenêtre visible du jeu. Il envoie ensuite les touches locales selon votre stratégie, sans demander votre mot de passe MapleStory. L’éditeur web crée les fichiers de trajet ; le bot s’exécute sur votre ordinateur, pas dans le navigateur. Avant l’achat, faites confirmer votre serveur, la version du jeu et votre système par l’assistance : une mise à jour ou un changement visuel peut modifier la compatibilité.
Ce que le client peut automatiser#
Commencez simplement, vérifiez la détection dans les journaux et activez les options une par une.
Détection du personnage et des monstres
Créez des modèles orientés à gauche et à droite pour repérer les cibles visibles.
Trajets de farming
Attaquez sur place, patrouillez entre deux points ou créez un trajet pour une carte à plusieurs niveaux.
Potions et buffs automatiques
Réglez les seuils de PV/PM, les touches, les délais et jusqu’à cinq buffs périodiques.
Combat et ramassage
Configurez attaque, saut, ramassage, direction et temporisations au même endroit.
Journaux et contrôles au démarrage
Vérifiez la détection de la fenêtre, de la mini-carte, du personnage, des monstres et des PV/PM avant l’exécution.
Profils et trajets locaux
Sauvegardez et testez localement vos réglages, modèles et trajets.
Avant de commencer#
- Windows 10/11 64 bits ou Mac avec puce Apple série M (macOS 11+) ou processeur Intel (macOS 12+)
- MapleStory avec mini-carte visible
- Sur macOS : autoriser Accessibilité et Enregistrement de l’écran et de l’audio système
- Licence valide et connexion pour la première activation
- Modèles capturés sur le système et le jeu utilisés
Questions sur le bot Classic World#
Fonctionne-t-il sous Windows et macOS ?+
Oui, sous Windows 10/11 64 bits et sur Mac avec puce Apple (macOS 11+) ou Intel (macOS 12+), avec un paquet Mac distinct par puce.
Quelle version de Classic World faut-il vérifier avant l’achat ?+
Ce guide porte sur Global MapleStory Classic World. La compatibilité dépend du serveur, de la version du jeu, du système et de l’interface actuelle. Envoyez ces informations à hi@okya.app avant d’acheter. Le nom Classic ne signifie pas que tous les serveurs ou toutes les mises à jour acceptent la même configuration.
Le bot fonctionne-t-il en ligne ou sur mon ordinateur ?+
Le bot est un client de bureau payant, exécuté localement sous Windows ou sur Mac. L’éditeur de trajets est gratuit et fonctionne dans le navigateur : importez une image, ajoutez les nœuds et les déplacements, exportez le JSON, puis chargez-le dans le client. L’éditeur ne fait tourner ni le jeu ni le bot.
Comment récupérer la licence et télécharger le client ?+
Mensuel $19 / 30 jours, trimestriel $39 / 90 jours, annuel $99 / 365 jours. Toutes les fonctions incluses. Les licences à vie ne sont plus vendues. Une fois le paiement confirmé, la commande affiche la clé et des boutons de téléchargement distincts pour Windows et Mac avec puce Apple. Téléchargez le client depuis votre commande officielle, puis suivez les étapes d’installation et de première configuration ci-dessous.
02
Guide d’utilisation
Captures en jeu#
Installation, autorisations et activation#
Installez le paquet adapté, puis vérifiez les autorisations avant de configurer une stratégie.
Installation sous Windows
Extrayez tout le ZIP 64 bits dans un dossier permanent. Ne lancez pas l’app depuis l’aperçu du ZIP. Exécutez-la en tant qu’administrateur.
Installation sur Mac
Placez l’app dans Applications. Dans Confidentialité et sécurité, autorisez Accessibilité et Enregistrement de l’écran et de l’audio système, puis quittez et relancez l’app. Un paquet distinct existe pour les Mac Intel.
Vérifier les autorisations macOS
Accessibilité autorise les touches de déplacement, combat et soins ; l’enregistrement d’écran permet de lire fenêtre, personnage, mini-carte et PV/PM. Ajoutez l’app installée aux deux listes, pas Terminal, Python, une ancienne version ou un dossier. Activez les deux options, quittez avec Command-Q et relancez.
Activer la licence
Saisissez la clé complète sans espaces au début ni à la fin et activez-la en ligne. Attendez la confirmation. Pour le Trousseau macOS, utilisez le mot de passe de session du Mac, pas la clé de licence.
Données locales et sauvegardes
Windows : %LOCALAPPDATA%\Okya\ ; macOS : ~/Library/Application Support/Okya/. Sauvegardez seulement config.json, templates et maps. Ne transférez jamais license.dat : activez séparément le nouvel appareil.
Créer des modèles de détection fiables#
Capturez les deux orientations sur le système et le jeu réellement utilisés. Ces modèles indiquent au client quoi chercher.
Modèles du personnage (15 × 15 px)
Créez un profil nommé. Capturez la même zone stable au sommet de la tête dans les deux sens. Vérifiez que les aperçus ne contiennent que le personnage, puis enregistrez et sélectionnez le profil.
Modèles de monstres (10 × 10 px)
Choisissez un monstre peu animé. Capturez la même zone distinctive dans les deux sens : tête, corne ou contour des yeux. Commencez avec un monstre ; un à trois modèles restent généralement les plus stables.
Bons et mauvais échantillons
Cadrez la même partie du corps sans éléments parasites. Refaites les captures contenant sol, plateforme, décor, noms, dégâts, chat, familiers, effets ou autres monstres.
Quand refaire les captures ?
Refaites les modèles après un changement de tenue, d’effets, de client ou de système : Windows et macOS peuvent produire des pixels différents.
Première configuration#
Ces étapes suivent le parcours de première utilisation du client.
- 1
Installez le paquet Windows 64 bits, Mac avec puce Apple ou Mac Intel. Sur macOS, déplacez l’app dans Applications avant d’accorder les autorisations.
- 2
Jouez en mode fenêtré ou sans bordure sur l’écran principal, avec mini-carte et PV/PM visibles.
- 3
Activez la licence et sélectionnez le bon serveur pour la détection de la mini-carte et des PV/PM.
- 4
Capturez les modèles gauche/droite du personnage et du monstre. Recommencez après un changement visuel important ou de plateforme.
- 5
Pour le premier essai, choisissez l’attaque fixe avec un personnage, un monstre et les touches d’attaque et de saut.
- 6
Lancez et consultez les journaux. Activez potions, buffs et ramassage après validation du personnage et de la mini-carte.
Régler les modes, le combat et les options#
Modifiez un réglage à la fois, enregistrez et consultez le journal avant d’activer la suite.
Fenêtre du jeu et réglages de base
Utilisez une fenêtre sur l’écran principal. Déployez la mini-carte et gardez les PV/PM par défaut visibles. Choisissez le vrai serveur, le profil et un seul monstre : le serveur détermine les couleurs et zones détectées. Gardez l’alerte de détecteur de mensonges active et testez son son.
Commencer par le diagnostic
Le mode détection vérifie fenêtre, personnage, monstres, mini-carte et PV/PM sans combattre. Le mode déplacement teste la patrouille ou le trajet. Activez l’exécution complète après validation des deux.
Combat et déplacement
Faites correspondre attaque et saut aux raccourcis du jeu. Commencez avec des portées modestes : trop grandes, elles peuvent viser une autre plateforme.
Récupération des PV et PM
Activez PV et PM séparément. Testez à 50 % avec environ une seconde de délai, jamais moins de 0,1 seconde. Si le journal indique 0,0 %, désactivez les potions et vérifiez serveur, position, interface et autorisation d’écran.
Buffs et ramassage d’objets
Jusqu’à cinq buffs programmés ; testez-en un d’abord. Chaque emplacement actif nécessite une touche et un intervalle positif. Pour le ramassage, essayez 0,45 seconde, minimum 0,05. Un rythme excessif peut interrompre le combat et accumuler les entrées.
Première exécution complète
Entrez sur la carte, ouvrez la mini-carte, vérifiez PV/PM et enregistrez serveur, profil, monstre, stratégie et touches. Démarrez en lieu sûr, attendez le retour du focus au jeu et ne changez pas d’app. L’exécution commence après confirmation des contrôles dans le journal.
Vérification en 30 secondes
Vérifiez carte, position sûre, écran principal, mini-carte, serveur/profil/monstre/stratégie, toutes les touches, réserves, inventaire et alerte sonore du détecteur.
Trois stratégies de carte#
Choisissez selon la forme de la carte et testez d’abord les déplacements sans options.
Attaque fixe
Idéal pour débuter sur une plateforme fixe. La position initiale est mémorisée ; le bot peut tenter d’y revenir après un recul.
Patrouille entre deux points
Déplacez-vous entre A et B avec pauses réglables et attaques facultatives aux extrémités.
Patrouille sur trajet personnalisé
Suit un trajet de l’éditeur avec nœuds, plateformes et actions, adapté à la carte actuelle.
Créer et utiliser un trajet personnalisé#
Décrivez les déplacements sur une carte précise, avec la même carte et la même vue que dans le client.
Un trajet en trois étapes
- 1Importer la carte réellement utilisée
Capturez le jeu avec la même carte, le même mode de fenêtre et la même mini-carte. Choisissez Importer une carte. Évitez images de guides, images redimensionnées ou autres configurations : leurs coordonnées peuvent différer.
- 2Recadrer la mini-carte en haut à gauche
Choisissez Recadrer, indiquez les coins de la mini-carte et enregistrez. Gardez toute la zone praticable, sans monde du jeu, chat ni quêtes. Vérifiez la correspondance avec la mini-carte détectée par le client.
- 3Placer les nœuds et relier le trajet
Placez les nœuds aux virages, réceptions, cordes, échelles et portails. Marquez les plateformes, reliez les voisins et assignez marche, saut, escalade, descente ou téléportation. Exportez, importez pour la bonne carte et testez le mouvement avant combat et ramassage.
Mises à jour, sauvegardes et assistance#
Conservez les réglages testés, sans transférer les données de licence liées à l’appareil ni les secrets.
Avant une mise à jour
Arrêtez la stratégie, quittez et sauvegardez config.json, templates et maps. Installez séparément la nouvelle version puis vérifiez version, modèles, serveur, touches et stratégie.
Changer d’ordinateur
Transférez réglages et trajets après vérification, pas license.dat. Activez le nouvel appareil, accordez les droits et recapturez les modèles sur place.
Changer l’appareil lié
La licence est liée à l’appareil où elle a été activée en premier. Si vous changez d’ordinateur, réinstallez le système ou remplacez du matériel, contactez l’assistance (hi@okya.app) avec votre numéro de commande pour modifier la liaison. Ne copiez pas license.dat sur le nouvel appareil.
Contacter l’assistance
Joignez version de l’app, système et puce, serveur, mode de fenêtre, stratégie, paramètres et journal complet jusqu’au premier échec. Masquez clés, identifiants d’appareil, noms de compte et secrets.
03
Dépannage
Repérez le symptôme, appliquez la solution et arrêtez-vous à la première étape qui fonctionne. Terminez la configuration de base avant d’examiner un problème précis.
Dépanner dans le bon ordre#
Fiez-vous au journal : corrigez le premier contrôle échoué avant de modifier la stratégie.
Fenêtre du jeu introuvable
Ouvrez le jeu en fenêtre sur l’écran principal. Sur macOS, vérifiez l’autorisation d’enregistrement et relancez l’app après modification.
Personnage, monstre ou mini-carte non détecté
Dégagez l’affichage, vérifiez serveur et modèle, ouvrez la mini-carte et refaites les deux orientations dans l’environnement actuel. Testez un seul monstre.
PV et PM affichés à 0,0 %
Désactivez les potions. Vérifiez serveur, interface par défaut, position de fenêtre et autorisation d’écran, puis réessayez.
Monstres manqués ou mal identifiés
Sélectionnez un monstre et capturez une phase stable dans les deux sens. Cadrez une zone distinctive sans décor. Remplacez les modèles contenant du fond ou venant d’un autre système.
Détection correcte, mais aucune touche envoyée
Redonnez le focus au jeu, vérifiez les touches et Accessibilité sur macOS. Sous Windows, lancez en administrateur.
macOS redemande les autorisations
Supprimez les anciennes entrées, versions de test, Python, Terminal ou dossiers homonymes. Ajoutez l’app actuelle d’Applications aux deux listes, activez, quittez avec Command-Q et relancez.
La patrouille dépasse le bord
Rapprochez A et B du centre de la plateforme et testez en déplacement seul. L’intervalle de détection et l’inertie peuvent provoquer un dépassement.
Installation et activation#
macOS indique que le développeur ne peut pas être vérifié, ou que l’app est endommagée+
Vérifiez d’abord que le paquet vient de l’adresse officielle, qu’il est entièrement téléchargé et qu’il correspond à votre puce (Apple silicon ou Intel). Un message « endommagé » seul n’indique pas la vraie cause.
Si la source est fiable, ouvrez Réglages Système → Confidentialité et sécurité et cherchez « Ouvrir quand même ». Si elle ne s’ouvre toujours pas, contactez l’assistance avec le message complet, la version du client, la puce du Mac et la version de macOS.
Après une réinstallation ou un changement d’ordinateur, la licence indique qu’elle est déjà liée+
Une licence est liée à un appareil. Le même appareil peut changer de compte de jeu, mais cela n’autorise ni plusieurs jeux en même temps ni l’usage d’une licence sur plusieurs ordinateurs ou machines virtuelles.
Si un message de liaison apparaît après une réinstallation ou avec un nouvel appareil, écrivez à hi@okya.app avec votre numéro de commande pour que la liaison soit vérifiée et modifiée.
N’essayez pas sans cesse la licence de quelqu’un d’autre et ne publiez jamais votre clé complète sur des forums ou des captures publiques.
La vérification de licence est réussie, alors pourquoi ne démarre-t-il pas ?+
« License check passed » signifie seulement que la licence est valide. Cela ne veut pas dire que la fenêtre du jeu, le personnage, la minicarte et la source de capture ont tous été reconnus.
Continuez à lire le journal pour voir si l’échec vient de la capture de fenêtre, de la reconnaissance du personnage ou de celle de la minicarte, puis suivez l’entrée correspondante ci-dessous.
Un logiciel de sécurité bloque ou signale le programme+
Sous Windows, le programme doit être lancé en tant qu’administrateur. La compatibilité avec toutes les configurations d’antivirus ne peut pas être garantie.
Envoyez à l’assistance l’avertissement exact et l’endroit où vous avez téléchargé le paquet pour qu’elle vérifie le fichier officiel. Désactiver le logiciel de sécurité ou ajouter des exclusions ne doit pas être votre solution par défaut.
Lancement et capture de fenêtre#
La fenêtre du jeu est introuvable, ou la résolution est incorrecte+
Passez en revue ces points dans l’ordre :
- Vérifiez que la vraie fenêtre du jeu fait 1366 × 768, et pas seulement que le réglage l’indique en plein écran.
- Utilisez le mode fenêtré et gardez toute la fenêtre visible : ni réduite, ni agrandie, ni couverte par d’autres fenêtres.
- Si votre version permet de choisir une source de capture, sélectionnez la vraie fenêtre du jeu.
- Après avoir changé la résolution, arrêtez l’exécution et relancez ; redémarrez le client si nécessaire.
- Refaites les modèles du personnage et des monstres chaque fois que la résolution ou la taille d’affichage change.
Sur Mac, les autorisations sont activées mais Démarrer ne fait rien+
Assurez-vous qu’Accessibilité et Enregistrement de l’écran sont activés pour le client réellement en cours d’exécution, et lisez le journal de démarrage complet.
Dans un cas, l’autorisation semblait en cause, mais le vrai blocage venait de la reconnaissance des modèles du personnage et des monstres. Ne basculez pas les autorisations à répétition à cause d’un seul avertissement ; vérifiez aussi la taille de la fenêtre, la minicarte, le modèle du personnage et la source de capture.
Si le problème persiste, envoyez l’écran des autorisations, les réglages du client, une capture de tout le bureau et le journal de démarrage.
Le journal affiche « Game is not in the foreground »+
Cliquer sur les réglages ou sur la fenêtre du journal du client retire le focus au jeu, donc ce message est normal à ce moment-là. Arrêtez l’exécution avant de modifier les réglages, puis relancez et recliquez sur le jeu pour qu’il reste au premier plan.
Si le jeu est bien au premier plan et que le message continue, envoyez le journal complet et la disposition de votre écran au lieu de penser que l’erreur vient de vous.
Le journal affiche une fenêtre 0 × 0 ou « minimap not detected »+
Des rapports font état d’une taille de fenêtre 0 × 0, d’un repli sur la capture plein écran de l’écran principal et de « minimap not detected » en même temps. Vérifiez que le jeu n’est pas réduit, que la source capturée est la fenêtre du jeu et que la minicarte est développée pour que le repère du joueur soit visible.
Gardez le personnage immobile et hors combat au démarrage. Si cela échoue encore, envoyez le journal complet et une capture de toute la fenêtre du jeu.
Reconnaissance du personnage et des monstres#
Le personnage est sans cesse perdu. Comment capturer le modèle ?+
Capturez le personnage debout normalement, sans clignotement dû à un coup. Privilégiez le haut du corps, surtout un trait net et stable près de la tête.
- Laissez de côté le texte des compétences, les chiffres de dégâts, les décors d’arrière-plan et les grands effets.
- Capturez séparément l’orientation gauche et droite, enregistrez, puis sélectionnez le profil.
- Évitez que des effets recouvrent le personnage pendant l’exécution.
- Refaites la capture après un changement de résolution du jeu ; n’utilisez plus un modèle d’une ancienne taille.
Le modèle du monstre est enregistré mais les monstres ne sont toujours pas reconnus+
Écartez d’abord l’entrée suivante (un compte de 0 parce que les monstres sont hors de la portée d’attaque), puis vérifiez le modèle :
- Choisissez un monstre à la pose stable avec un trait net, comme le haut de la tête ou une corne.
- Capturez le même trait tourné à gauche et à droite.
- Évitez l’arrière-plan, les chiffres de dégâts et les effets de compétences.
- Refaites la capture à la résolution que vous utilisez vraiment, puis vérifiez que le modèle est sélectionné.
- Testez avec un seul monstre sélectionné pour mieux voir la cause.
Il y a des monstres à l’écran mais le journal affiche 0+
Le journal ne compte que les monstres dans la portée d’attaque horizontale que vous avez configurée, pas tous ceux de l’écran. Un 0 pour des monstres hors de cette portée est normal.
Regardez si le compte change quand un monstre entre dans la portée. Ce n’est que s’il reste à 0 alors qu’un monstre est dans la portée qu’il faut vérifier le modèle et les réglages de reconnaissance. Ne refaites pas les modèles juste parce que vous avez vu un 0.
Que vérifier pour la minicarte et la reconnaissance du personnage ?+
Vérifiez que le bon serveur est sélectionné, que la minicarte est entièrement développée avec le repère du joueur visible, et que le jeu a la bonne résolution et le bon mode de fenêtre. Restez immobile et hors combat au démarrage.
Repérez dans le journal CHARACTER_RECOGNITION, MINIMAP_RECOGNITION ou MARKER_COLOR_ABSENT et vérifiez séparément le personnage et la minicarte. Un personnage reconnu ne prouve pas que la minicarte a fonctionné.
Combat et portée d’attaque#
Il ne fait que des allers-retours et ne se bat jamais+
Vérifiez dans l’ordre : le personnage et la minicarte sont reconnus, le modèle du monstre est sélectionné, les monstres sont dans la portée d’attaque configurée, la touche d’attaque correspond au jeu et la compétence est déjà apprise.
Revenez à l’attaque sur place pour vérifier la reconnaissance de base et les touches. Changer de mode de patrouille ne prouve pas à lui seul que c’est réglé.
Comment régler la portée d’attaque horizontale ?+
La valeur est une distance en pixels sur l’écran du jeu. Basez-la sur la distance d’attaque réelle de votre personnage avec vos réglages d’affichage actuels.
Un outil de capture qui affiche la taille de la sélection en pixels peut aider à mesurer. Ne copiez pas le chiffre d’une autre classe ; il n’existe pas de valeur toujours juste. Pour une dague courte de débutant, l’assistance a suggéré 50 pixels ou moins, ce qui est un exemple pour les attaques à courte portée, pas une valeur par défaut pour toutes les classes.
Il attaque sans cesse le sol vide et gaspille des PM ou des consommables+
Une portée d’attaque trop grande peut pousser le client à viser des monstres hors d’atteinte, et un modèle instable peut causer des ratés ou de fausses correspondances. Vérifiez votre distance d’attaque réelle, la qualité du modèle et le résultat actuel de la reconnaissance.
S’il continue à frapper dans le vide, arrêtez l’exécution pour ne pas gaspiller de ressources et envoyez à l’assistance vos réglages d’attaque, les modèles et une courte note pour reproduire. Aucun interrupteur ne garantit l’arrêt des attaques quand il n’y a pas de monstre.
J’ai changé un réglage mais rien ne semble différent+
Les changements ne s’appliquent pas à une session déjà en cours. Procédez dans l’ordre : arrêter l’exécution → enregistrer → relancer.
Après avoir modifié la portée d’attaque, les touches de compétence, le seuil de comptage ou la résolution, vérifiez de nouveau l’effet réel.
Patrouille et éditeur de cartes#
Comment importer un trajet ? Existe-t-il une carte d’exemple ?+
L’éditeur de cartes inclut une carte d’exemple : utilisez « Load sample map » pour voir la structure, puis créez votre propre trajet.
Pour importer, choisissez la patrouille à trajet personnalisé, utilisez Import à côté du menu des cartes et sélectionnez le fichier JSON exporté. Les noms peuvent varier selon les versions ; si vous ne trouvez pas la commande, envoyez une capture du client plutôt que de deviner un bouton qui n’existe pas.
À l’export, utilisez uniquement des lettres anglaises et des chiffres pour Map Name et Map ID.
J’ai exporté une carte mais « Add to OKYA » n’apparaît pas+
Téléchargez le fichier .json exporté par l’éditeur, puis utilisez Import à côté de la liste des cartes dans la patrouille à trajet personnalisé du client de bureau. Si cela fonctionne, la carte apparaît dans le menu.
Inutile de la copier à la main dans assets/maps ; ce dossier est réservé aux cartes intégrées. Si l’import échoue toujours, vérifiez Map Name, Map ID et le nom du fichier, puis envoyez à l’assistance le JSON exporté avec une capture de l’erreur. Ne présumez pas que le format du fichier est mauvais simplement parce que l’import a échoué.
À inclure quand vous contactez l’assistance#
Envoyez le tout en une fois pour limiter les allers-retours.
- Système d’exploitation et version ; pour un Mac, précisez Apple silicon ou Intel.
- Le numéro de version exact du client.
- Nom du jeu, serveur, mode de fenêtre et résolution.
- Si vous utilisez un écran externe, et la mise à l’échelle de l’affichage.
- Les étapes effectuées, ce que vous attendiez et ce qui s’est réellement passé.
- Le journal complet, pas seulement la dernière ligne.
- Une capture de tout le bureau montrant à la fois le jeu et les réglages du client ; pour les problèmes de reconnaissance, ajoutez les modèles tournés à gauche et à droite.
- Pour les problèmes de touches, les réglages de touches côté jeu et côté client.
- Pour les problèmes de performance, la durée d’exécution et les données de surveillance utiles ; une courte vidéo aide si vous pouvez la filmer sans risque.