okya for MapleStory
Español
English한국어日本語简体中文繁體中文EspañolPortuguêsไทยTiếng Việt
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

okya for MapleStory utiliza reconocimiento de imágenes en pantalla y controles locales de teclado para automatizar tareas repetitivas de combate, farmeo y nivelación. Crea plantillas de tu personaje y de los monstruos y elige una estrategia adecuada para cada mapa.

Plataformas
Windows 10/11 · Mac con Apple Silicon
Vista del juego
1366 × 768
Procesamiento
Reconocimiento local de pantalla

Un bot configurable para tareas repetitivas de MapleStory#

El cliente de escritorio analiza la ventana visible del juego y no solicita la contraseña de tu cuenta. Detecta al personaje, los monstruos seleccionados, la posición en el minimapa y las zonas de HP/MP; después ejecuta la estrategia y las teclas guardadas. Las plantillas y la configuración habitual permanecen en el dispositivo.

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)
  • MapleStory a 1366 × 768 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; no está destinado a Macs Intel.

¿Por qué se exige 1366 × 768?+

Las áreas de reconocimiento de la ventana, el minimapa y HP/MP están calibradas para esa vista. Otras resoluciones pueden impedir la comprobación inicial.

¿Necesita la contraseña de mi cuenta?+

No. Funciona con la imagen visible y controles locales. No envíes tu contraseña ni el archivo license.dat al soporte.

¿Qué estrategia debo probar primero?+

Empieza con Ataque estacionario, un solo monstruo y las funciones opcionales desactivadas. Añádelas cuando el reconocimiento sea estable.

¿Puedo copiar plantillas entre Windows y Mac?+

Puedes guardar la configuración y las rutas, pero la imagen puede variar entre sistemas. Recomendamos capturar de nuevo las plantillas en el equipo de destino.

¿Puedo crear mi propia ruta para el bot?+

Sí. Marca plataformas, nodos y movimientos en el editor web, exporta la ruta JSON e impórtala en el cliente. Crea y prueba cada ruta con el mapa y la resolución correspondientes.

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.

Mac con Apple silicon

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. El paquete actual no es para Mac 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 (20 × 20 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 la resolución del juego, la escala, el atuendo, los efectos, el cliente o el sistema operativo. Las imágenes deben coincidir exactamente con la resolución utilizada; 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 o Mac con Apple Silicon. En macOS, mueve la app a Aplicaciones antes de conceder permisos.

  2. 2

    Ejecuta el juego a 1366 × 768 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, escala, 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 1366 × 768 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, resolución, 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, 1366 × 768 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 la misma resolución, 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.

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 1366 × 768 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, 1366 × 768, 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.

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.

Contactar con soporte

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