okya for MapleStory
Español
English한국어日本語简体中文繁體中文EspañolPortuguêsไทยTiếng ViệtDeutschFrançaisItalianoNederlandsעבריתSvenskaРусский
Menú de la guía⌄
Inicio›Guía del producto

01 · Presentación del producto

Automatización local de escritorio

Bot para MapleStory Classic World

Un bot configurable para Global MapleStory Classic World, compatible con Windows 10/11 y Mac con chip Apple o Intel. Usa reconocimiento de pantalla y las teclas que configures para automatizar el farmeo, las pociones y los buffs. Elige ataque fijo, patrulla entre dos puntos o una ruta propia; captura las plantillas del personaje y los monstruos en el entorno donde vayas a jugar.

Plataformas
Windows 10/11 · Mac con Apple Silicon / Intel
Procesamiento
Reconocimiento local de pantalla

Cómo funciona okya en Classic World#

El cliente de escritorio reconoce al personaje, los monstruos elegidos, la posición en el minimapa y las zonas de HP/MP en la ventana visible del juego. Después envía pulsaciones locales según tu estrategia, sin pedir la contraseña de MapleStory. El editor web crea archivos de ruta, pero el bot se ejecuta en tu ordenador, no en el navegador. Antes de comprar, consulta con soporte tu servidor, versión del juego y sistema operativo: las actualizaciones y los cambios visuales pueden afectar a la compatibilidad.

Qué puede automatizar el cliente#

Empieza con una configuración mínima, comprueba el reconocimiento en el registro y activa las funciones opcionales de una en una.

Reconocimiento de personajes y monstruos

Crea plantillas orientadas a la izquierda y a la derecha para localizar a tu personaje y a los objetivos visibles.

Rutas de combate y farmeo

Elige ataque estacionario, patrulla entre dos puntos o una ruta propia creada en el editor de mapas.

Pociones y mejoras automáticas

Configura umbrales de HP/MP, teclas, tiempos de reutilización y hasta cinco espacios de mejoras periódicas.

Recogida y controles de combate

Ajusta ataque, salto, recogida, dirección y tiempos específicos de cada estrategia desde un solo panel.

Registros y comprobaciones iniciales

Comprueba la ventana, el minimapa, el personaje, los monstruos y el estado vital antes de dejar una estrategia en marcha.

Perfiles y rutas locales

Guarda localmente la configuración, las plantillas personalizadas y las rutas para probarlas y ajustarlas.

Antes de empezar#

  • Windows 10/11 de 64 bits o Mac con Apple Silicon (serie M, macOS 11 o posterior) o Intel (macOS 12 o posterior)
  • MapleStory con el minimapa visible
  • Permisos de Accesibilidad y Grabación de pantalla y audio del sistema en macOS
  • Licencia válida y conexión de red para la primera activación
  • Plantillas capturadas en el sistema y entorno de juego que vas a utilizar

Preguntas sobre el bot para MapleStory Classic World#

¿Funciona en Windows y macOS?+

Sí. El cliente actual funciona en Windows 10/11 de 64 bits y Macs con Apple Silicon (macOS 11 o posterior) y Macs con Intel (macOS 12 o posterior), con un paquete distinto para cada chip.

¿Qué versión de Classic World debo consultar antes de comprar?+

Esta guía se centra en Global MapleStory Classic World. La compatibilidad depende del servidor, la versión del juego, el sistema operativo y la interfaz actual. Envía esos datos a hi@okya.app antes de comprar. Que un servidor sea «Classic» no significa que todos los servidores o actualizaciones funcionen con la misma configuración.

¿Es un bot online o se instala en mi ordenador?+

El bot es un cliente de escritorio de pago que se ejecuta localmente en Windows o Mac. El editor de rutas es gratuito y funciona en el navegador: importa una imagen del mapa, añade nodos y acciones de movimiento, exporta el JSON e impórtalo al cliente. El editor no ejecuta el juego ni el bot.

¿Cómo recibo la licencia y la descarga?+

Mensual $19 / 30 días, trimestral $39 / 90 días, anual $99 / 365 días. Incluyen todas las funciones. Ya no se venden licencias de por vida. Una vez confirmado el pago, la página del pedido muestra la clave y los botones de descarga para Windows y Mac con chip Apple. Descarga el cliente desde tu pedido oficial y sigue los pasos de instalación y primera configuración que encontrarás más abajo.

02

Guía de uso

Capturas del juego#

Instalación, permisos y activación#

Instala el paquete correcto y completa las comprobaciones de la plataforma antes de configurar una estrategia.

Windows

Extrae por completo el ZIP de 64 bits en una carpeta fija. No ejecutes la aplicación desde la vista previa del ZIP. Ejecuta el programa como administrador.

Instalación en Mac

Mueve la app a Aplicaciones antes de abrirla. Concede Accesibilidad y Grabación de pantalla y audio del sistema; después ciérrala por completo y vuelve a abrirla. Usa el paquete que corresponda a tu chip: Apple silicon o Intel.

Comprobar permisos de macOS

Accesibilidad permite enviar teclas; Grabación de pantalla y audio del sistema permite leer la ventana, el personaje, el minimapa y HP/MP. Añade la app instalada —no Terminal, Python, una versión antigua ni una carpeta— a ambas listas, activa los interruptores, cierra con Command-Q y vuelve a abrir.

Activación y datos locales

Introduce la licencia completa sin espacios externos y espera la confirmación en línea. En macOS, una solicitud del llavero requiere la contraseña de inicio de sesión del Mac, no la licencia. Los datos están en %LOCALAPPDATA%\Okya\ en Windows y ~/Library/Application Support/Okya/ en macOS. Copia solo config.json, templates y maps; nunca license.dat.

Crear plantillas de reconocimiento fiables#

Captura ambas orientaciones en el sistema y la configuración del juego que vayas a usar.

Personaje (15 × 15 px)

Crea y nombra el perfil. Captura una zona estable cerca de la parte superior de la cabeza mirando a la izquierda y exactamente la misma zona mirando a la derecha. Comprueba que ambas vistas contengan solo al personaje, guarda y selecciona el perfil.

Monstruos (10 × 10 px)

Elige un monstruo con pocos movimientos y fotogramas. En un fotograma estable, captura la misma zona distintiva —por ejemplo, la cabeza, un cuerno o cerca de los ojos— en ambas direcciones. Empieza con uno; normalmente de uno a tres ofrecen mayor estabilidad.

Muestras correctas e incorrectas

Una buena pareja usa la misma zona y contiene solo el objetivo. Repite cualquier captura que incluya suelo, borde de plataforma, fondo, nombres, daño, chat, mascotas, efectos u otro monstruo.

Cuándo repetir la captura

Vuelve a crear todas las plantillas si cambias el atuendo, los efectos, el cliente o el sistema operativo. Windows y macOS también pueden renderizar los píxeles de forma distinta.

Configuración inicial#

Este proceso se basa en el cliente de escritorio real y en su guía de primer uso.

  1. 1

    Instala el paquete correcto para Windows de 64 bits, Mac con Apple Silicon o Mac con Intel. En macOS, mueve la app a Aplicaciones antes de conceder permisos.

  2. 2

    Ejecuta el juego en modo ventana o ventana sin bordes. Mantén visibles el minimapa y las zonas de HP/MP en la pantalla principal.

  3. 3

    Activa la licencia y selecciona el servidor real para utilizar las regiones correctas de reconocimiento del minimapa y de HP/MP.

  4. 4

    Captura plantillas izquierda y derecha del personaje y del monstruo objetivo. Repítelo si cambias de sistema, apariencia o cliente.

  5. 5

    Para la primera prueba, elige Ataque estacionario y configura solo el personaje, un monstruo, la tecla de ataque y la de salto.

  6. 6

    Inicia la estrategia y consulta el registro. Activa pociones, mejoras y recogida solo cuando el personaje y el minimapa se reconozcan correctamente.

Modos, combate y acciones opcionales#

Cambia un ajuste cada vez, guárdalo y revisa el registro antes de activar el siguiente.

Pantalla y ajustes básicos

Usa el juego en ventana o sin bordes en la pantalla principal. Mantén el minimapa abierto y HP/MP en su posición predeterminada. Selecciona el servidor real, el personaje guardado y un monstruo; activa la alerta de detector de mentiras y prueba el sonido.

Modos de diagnóstico

Solo reconocimiento comprueba ventana, personaje, monstruos, minimapa y HP/MP sin enviar ataques. Solo movimiento valida una patrulla o ruta. Usa la ejecución completa únicamente cuando ambas pruebas funcionen.

Combate y movimiento

Haz coincidir ataque y salto con los atajos del juego. Empieza con alcances horizontales y verticales prudentes para no perseguir objetivos de otra plataforma.

Pociones, buffs y recogida

Prueba HP/MP con un umbral del 50% y aproximadamente un segundo de espera; nunca menos de 0,1 s. Prueba primero uno de los cinco espacios de buff. Para recoger, 0,45 s es un inicio estable y 0,05 s es el mínimo; demasiada frecuencia interrumpe el combate.

Primera ejecución completa

Entra en el mapa, abre el minimapa y comprueba HP/MP. Guarda servidor, personaje, monstruo, estrategia y teclas. Inicia desde un lugar seguro, espera a que la app devuelva el foco al juego y no cambies de aplicación. Solo está en marcha cuando el registro confirma todas las comprobaciones iniciales.

Comprobación de 30 segundos

Confirma mapa y posición segura, el juego en la pantalla principal, minimapa abierto, servidor/perfil/monstruo/estrategia correctos, todas las teclas, suficientes consumibles y espacio, y una alerta audible.

Tres estrategias de mapa#

Cada estrategia responde a una estructura diferente. Prueba primero el movimiento sin acciones opcionales.

Ataque estacionario

Recomendado para la primera prueba y plataformas fijas. Registra la posición inicial y puede intentar regresar tras un empujón o desplazamiento.

Patrulla entre dos puntos

Se mueve entre las coordenadas horizontales A y B del minimapa, con pausas y ataques en los extremos configurables.

Ruta predefinida

Sigue un archivo con nodos, plataformas y acciones para mapas de varios niveles. La ruta debe corresponder al mapa actual.

Crear y usar una ruta personalizada#

El editor de mapas define cómo debe moverse el bot por un mapa concreto. Crea la ruta con el mismo mapa y vista que utilizarás en el cliente de escritorio.

Crea la ruta en tres pasos

  1. 1
    Importa el mapa que utilizas realmente

    Abre el mapa en el juego con el mismo modo de ventana y distribución del minimapa que usarás con el cliente de escritorio, y captura la pantalla actual. En el editor, elige Importar mapa. Evita imágenes de guías, imágenes redimensionadas o capturas de otro equipo porque sus coordenadas pueden no coincidir.

  2. 2
    Recorta el minimapa de la esquina superior izquierda

    Elige Recortar, marca primero la esquina superior izquierda del minimapa visible y después la inferior derecha, y guarda el recorte. Incluye todas las plataformas transitables, cuerdas, escaleras y portales; excluye el mundo del juego, el chat, las misiones y el resto de la interfaz. Comprueba que el recorte coincide con el minimapa que reconocerá el cliente.

  3. 3
    Coloca puntos y construye la ruta

    Usa Nodo para marcar giros, aterrizajes, entradas de cuerdas o escaleras y portales. Dibuja plataformas cuando ayuden a describir el terreno, conecta nodos vecinos y asigna la acción correcta de caminar, saltar, trepar, bajar o teletransportarse. Exporta la ruta, impórtala para el mismo mapa y prueba primero solo el movimiento.

Actualizaciones, copias y soporte#

Conserva la configuración probada sin mover datos de licencia ni compartir secretos.

Antes de actualizar

Detén la estrategia, cierra la app y copia config.json, templates y maps. Tras instalar, revisa versión, servidor, plantillas, teclas y estrategia.

Cambiar de equipo

Puedes revisar y migrar configuración y rutas, pero no license.dat. Activa el nuevo dispositivo, concede permisos y vuelve a crear las plantillas.

Cambiar el dispositivo vinculado

La licencia queda vinculada al dispositivo donde se activó por primera vez. Si cambias de equipo, reinstalas el sistema o sustituyes hardware, escribe al soporte (hi@okya.app) con tu número de pedido para cambiar la vinculación. No copies license.dat al nuevo dispositivo.

Contactar con soporte

Incluye versión, sistema y chip, servidor, modo de ventana, estrategia, parámetros y el registro completo hasta el primer error. Elimina licencias, identificadores y nombres de cuenta.

03

Solución de problemas

Busca el síntoma, aplica la solución y detente en el primer paso que funcione. Termina la configuración básica antes de investigar un problema concreto.

Diagnóstico paso a paso#

Corrige primero la comprobación inicial más antigua que haya fallado en el registro.

No se encuentra la ventana

Usa el juego en modo ventana o sin bordes en la pantalla principal. En macOS, revisa Grabación de pantalla y reinicia la app.

Falla el reconocimiento

Retira obstrucciones, verifica servidor y plantilla, abre por completo el minimapa y vuelve a capturar ambas direcciones. Prueba con un solo monstruo.

HP y MP muestran 0.0%

Desactiva primero la recuperación automática y comprueba servidor, interfaz predeterminada, posición de la ventana y permiso de grabación.

Monstruos omitidos o confundidos

Selecciona uno, vuelve a capturar ambas direcciones en un fotograma estable y usa una zona exclusiva. Elimina plantillas con fondo o copiadas desde otro sistema operativo.

Reconoce, pero no pulsa teclas

Devuelve el foco al juego, revisa los atajos y Accesibilidad en macOS. En Windows, ejecuta el programa como administrador.

macOS sigue solicitando permisos

Elimina entradas antiguas, de prueba, Python, Terminal o carpetas. Añade la app actual desde Aplicaciones a ambos permisos, activa ambos, cierra con Command-Q y vuelve a abrir.

La patrulla rebasa el borde

Aleja A y B de los extremos y valida primero con solo movimiento. La inercia puede provocar un pequeño rebase.

Instalación y activación#

macOS dice que no se puede verificar al desarrollador o que la aplicación está dañada+
Qué revisar

Primero confirma que el paquete vino de la dirección oficial, se descargó completo y corresponde a tu chip (Apple silicon o Intel). Un mensaje de «dañado» por sí solo no indica la causa real.

Si la fuente es de confianza, abre Ajustes del Sistema → Privacidad y seguridad y busca «Abrir de todos modos». Si sigue sin abrir, contacta con soporte con el mensaje completo, la versión del cliente, el chip del Mac y la versión de macOS.

Tras reinstalar el sistema o cambiar de ordenador, la licencia indica que ya está vinculada+
Cómo funciona

Una licencia se vincula a un dispositivo. El mismo dispositivo puede cambiar de cuenta de juego, pero eso no permite ejecutar varios juegos a la vez ni usar una licencia en varios ordenadores o máquinas virtuales.

Si aparece un mensaje de vinculación tras una reinstalación o un dispositivo nuevo, escribe a hi@okya.app con tu número de pedido para que se revise y se cambie la vinculación.

No sigas probando la licencia de otra persona y nunca publiques tu clave completa en foros ni en capturas públicas.

La comprobación de licencia pasó, ¿por qué no arranca?+
Cómo funciona

«License check passed» solo significa que la licencia es válida. No significa que la ventana del juego, el personaje, el minimapa y el origen de captura se hayan reconocido.

Sigue leyendo el registro para ver si falló en la captura de ventana, el reconocimiento del personaje o el del minimapa, y usa la entrada correspondiente de abajo.

El software de seguridad bloquea o marca el programa+
Qué revisar

En Windows hay que iniciar el programa como administrador. No se puede garantizar la compatibilidad con todas las configuraciones de antivirus.

Envía a soporte la advertencia exacta y dónde descargaste el paquete para que comprueben el archivo oficial. Desactivar el software de seguridad o añadir exclusiones no debería ser tu solución por defecto.

Inicio y captura de ventana#

No se encuentra la ventana del juego o la resolución es incorrecta+
Qué revisar

Revisa estos puntos en orden:

  1. Confirma que la ventana real del juego es de 1366 × 768, no solo que el ajuste lo muestre en pantalla completa.
  2. Usa el modo ventana y mantén toda la ventana visible: sin minimizar, sin maximizar y sin que otras ventanas la tapen.
  3. Si tu versión permite elegir un origen de captura, selecciona la ventana real del juego.
  4. Tras cambiar la resolución, detén la ejecución y vuelve a iniciar; reinicia el cliente si hace falta.
  5. Vuelve a capturar las plantillas del personaje y de los monstruos cada vez que cambie la resolución o el tamaño de pantalla.
En Mac, los permisos están activados pero Iniciar no hace nada+
Qué revisar

Asegúrate de que Accesibilidad y Grabación de pantalla estén activados para el cliente que realmente se está ejecutando, y lee el registro de inicio completo.

En un caso el permiso parecía fallar, pero el verdadero bloqueo era el reconocimiento de las plantillas del personaje y los monstruos. No cambies los permisos una y otra vez por una sola advertencia; revisa también el tamaño de la ventana, el minimapa, la plantilla del personaje y el origen de captura.

Si persiste, envía la pantalla de permisos, los ajustes del cliente, una captura de todo el escritorio y el registro de inicio.

El registro muestra «Game is not in the foreground»+
Cómo funciona

Al hacer clic en los ajustes o el registro del cliente, el juego pierde el foco, así que ese mensaje es normal. Detén la ejecución antes de cambiar ajustes, vuelve a iniciar y haz clic en el juego para que quede delante.

Si el juego está realmente delante y el mensaje sigue apareciendo, envía el registro completo y la disposición de tu pantalla en lugar de suponer que es un error tuyo.

El registro muestra una ventana de 0 × 0 o «minimap not detected»+
Qué revisar

Hay informes de un tamaño de ventana 0 × 0, un cambio a captura de pantalla completa del monitor principal y «minimap not detected» a la vez. Confirma que el juego no está minimizado, que el origen capturado es la ventana del juego y que el minimapa está desplegado para que se vea el marcador del jugador.

Mantén al personaje quieto y fuera de combate al empezar. Si sigue fallando, envía el registro completo y una captura de toda la ventana del juego.

Reconocimiento de personajes y monstruos#

El personaje se pierde constantemente. ¿Cómo debo capturar la plantilla?+
Qué revisar

Captura al personaje de pie con normalidad, sin parpadear por un golpe. Prefiere la parte superior del cuerpo, sobre todo un rasgo claro y estable cerca de la cabeza.

  1. Deja fuera texto de habilidades, números de daño, decoración de fondo y efectos grandes.
  2. Captura por separado la orientación izquierda y la derecha, guarda y selecciona el perfil.
  3. Evita que los efectos tapen al personaje mientras se ejecuta.
  4. Vuelve a capturar tras cambiar la resolución del juego; no sigas usando una plantilla de otro tamaño.
La plantilla del monstruo está guardada pero no se reconocen los monstruos+
Qué revisar

Primero descarta la siguiente entrada (un recuento de 0 porque los monstruos están fuera del alcance de ataque) y luego revisa la plantilla:

  1. Elige un monstruo con una pose estable y un rasgo claro, como la parte superior de la cabeza o un cuerno.
  2. Captura el mismo rasgo mirando a la izquierda y a la derecha.
  3. Evita el fondo, los números de daño y los efectos de habilidades.
  4. Vuelve a capturar en la resolución que realmente usas y confirma que la plantilla está seleccionada.
  5. Prueba con un solo monstruo seleccionado para ver mejor la causa.
Hay monstruos en pantalla pero el registro muestra 0+
Cómo funciona

El registro solo cuenta los monstruos dentro del alcance horizontal de ataque que configuraste, no todos los de la pantalla. Un 0 para monstruos fuera de ese alcance es normal.

Observa si el recuento cambia cuando un monstruo entra en el alcance. Solo si se queda en 0 con un monstruo dentro del alcance deberías revisar la plantilla y los ajustes de reconocimiento. No vuelvas a capturar plantillas solo porque viste un 0.

¿Qué debo revisar del minimapa y del reconocimiento del personaje?+
Qué revisar

Confirma que está seleccionado el servidor correcto, que el minimapa está totalmente desplegado con el marcador del jugador visible y que el juego tiene la resolución y el modo de ventana correctos. Al empezar, quédate quieto y fuera de combate.

Mira en el registro CHARACTER_RECOGNITION, MINIMAP_RECOGNITION o MARKER_COLOR_ABSENT y revisa por separado el personaje y el minimapa. Que el personaje se reconozca no demuestra que el minimapa funcione.

Combate y alcance de ataque#

Solo se mueve de un lado a otro y nunca lucha+
Qué revisar

Revisa en orden: que el personaje y el minimapa se reconozcan, que la plantilla del monstruo esté seleccionada, que los monstruos estén dentro del alcance de ataque configurado, que la tecla de ataque coincida con el juego y que la habilidad ya esté aprendida.

Vuelve al ataque estático para verificar el reconocimiento básico y las teclas. Cambiar de modo de patrulla por sí solo no demuestra que esté arreglado.

¿Cómo configuro el alcance horizontal de ataque?+
Cómo funciona

El valor es una distancia en píxeles en la pantalla del juego. Basa el valor en la distancia real de ataque de tu personaje con tu configuración de pantalla actual.

Una herramienta de capturas que muestre el tamaño de la selección en píxeles puede ayudarte a medirla. No copies el número de otra clase; no hay un valor que sea siempre correcto. Para una daga corta de principiante, soporte ha sugerido 50 píxeles o menos, que es un ejemplo para ataques de corto alcance, no un valor por defecto para todas las clases.

Ataca al suelo vacío y malgasta MP o consumibles+
Qué revisar

Un alcance de ataque demasiado grande puede hacer que el cliente intente golpear monstruos a los que no llegas, y una plantilla inestable puede causar fallos o falsas coincidencias. Revisa tu distancia real de ataque, la calidad de la plantilla y el resultado actual del reconocimiento.

Si sigue atacando al vacío, detén la ejecución para no gastar recursos y envía a soporte tus ajustes de ataque, las plantillas y una nota breve sobre cómo reproducirlo. No hay ningún interruptor que garantice detener los ataques cuando no hay monstruos.

Cambié un ajuste pero parece que nada cambia+
Cómo funciona

Los cambios no se aplican a una sesión que ya está en marcha. Hazlo en orden: detener la ejecución → guardar → iniciar de nuevo.

Tras cambiar el alcance de ataque, las teclas de habilidad, el umbral de recuento o la resolución, comprueba de nuevo el efecto real.

Patrulla y editor de mapas#

¿Cómo importo una ruta? ¿Hay un mapa de ejemplo?+
Cómo funciona

El editor de mapas incluye un mapa de ejemplo: usa «Load sample map» para ver la estructura y luego crea tu propia ruta.

Para importar, elige la patrulla de ruta personalizada, usa Import junto al desplegable de mapas y selecciona el archivo JSON exportado. Los nombres pueden variar entre versiones; si no encuentras el control, envía una captura del cliente en vez de adivinar un botón que no existe.

Al exportar, usa solo letras inglesas y dígitos para Map Name y Map ID.

Exporté un mapa pero «Add to OKYA» no aparece+
Cómo funciona

Descarga el archivo .json que exporta el editor y usa Import junto a la lista de mapas en la patrulla de ruta personalizada del cliente de escritorio. Si funciona, el mapa aparece en el desplegable.

No hace falta copiarlo a mano en assets/maps; esa carpeta es para los mapas integrados. Si sigue sin importarse, revisa Map Name, Map ID y el nombre del archivo, y envía a soporte el JSON exportado con una captura del error. No supongas que el formato del archivo es incorrecto solo porque falló la importación.

Qué incluir al contactar con soporte#

Envíalo todo junto para reducir las idas y venidas.

  • Sistema operativo y versión; en un Mac, indica si es Apple silicon o Intel.
  • El número de versión exacto del cliente.
  • Nombre del juego, servidor, modo de ventana y resolución.
  • Si usas un monitor externo y la escala de pantalla.
  • Los pasos que seguiste, lo que esperabas y lo que ocurrió realmente.
  • El registro completo, no solo la última línea.
  • Una captura de todo el escritorio donde se vean el juego y los ajustes del cliente; en problemas de reconocimiento, añade las plantillas mirando a izquierda y derecha.
  • En problemas de teclas, la configuración de teclas tanto del juego como del cliente.
  • En problemas de rendimiento, cuánto tiempo estuvo en marcha y los datos de supervisión relevantes; un vídeo corto ayuda si puedes grabarlo con seguridad.