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
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
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
Activa la licencia y selecciona el servidor real para utilizar las regiones correctas de reconocimiento del minimapa y de HP/MP.
- 4
Captura plantillas izquierda y derecha del personaje y del monstruo objetivo. Repítelo si cambias de sistema, escala, apariencia o cliente.
- 5
Para la primera prueba, elige Ataque estacionario y configura solo el personaje, un monstruo, la tecla de ataque y la de salto.
- 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
- 1Importa 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.
- 2Recorta 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.
- 3Coloca 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.