Modificación de scripts AHK en la práctica: automatización de Water Margin Online con teclas en segundo plano y captura de coordenadas

Muchos jugadores recurren a AutoHotkey (AHK) para automatizar tareas repetitivas. Sin embargo, surgen dudas comunes: ¿cómo hacer que el script funcione en segundo plano sin interferir con otras aplicaciones? ¿Cómo obtener las coordenadas exactas dentro de la ventana del juego? ¿Y cómo enviar teclas de forma estable?

Este artículo analiza el proceso de modificación de un script de automatización para Water Margin Online (水滸歷險 Online), desglosando la implementación de teclas en segundo plano, el cálculo de coordenadas, la captura de coordenadas del ratón con una tecla de acceso rápido y el envío de grupos de teclas.

¿Por qué es necesario operar en segundo plano?

Cuando un script en primer plano ejecuta un clic o envía una tecla, fuerza la ventana del juego al frente, interrumpiendo cualquier otra tarea que estés realizando. El objetivo de la operación en segundo plano es que el script se ejecute mientras tú puedes seguir usando otras ventanas; la ventana del juego recibe las instrucciones en segundo plano sin necesidad de estar activa.

En AHK, los comandos clave para la operación en segundo plano son:

• ControlSend: envía teclas a una ventana específica sin activarla.
• ControlClick: envía un clic del ratón a coordenadas específicas dentro de una ventana, sin activarla.
• Se utiliza junto con

  ahk_id %TargetHwnd%

  para apuntar a la ventana objetivo.

¿Cómo fijar las coordenadas XY dentro de la ventana del juego?

Las coordenadas XY dentro del juego no son lo mismo que las coordenadas absolutas de la pantalla. Si la ventana del juego se mueve o cambia de tamaño, los clics definidos con coordenadas absolutas de la pantalla fallarán.

La solución correcta es calcular las coordenadas relativas a la ventana:

X dentro del juego = X del ratón en pantalla - X de la esquina superior izquierda de la ventana del juego
Y dentro del juego = Y del ratón en pantalla - Y de la esquina superior izquierda de la ventana del juego

Para mayor precisión, se debe usar la esquina superior izquierda del área de contenido del juego (excluyendo la barra de título y los bordes) como punto de referencia, no la de la ventana completa.

Ejemplo de implementación

; Coordenadas de la esquina superior izquierda de la ventana del juego (deben obtenerse primero)
winX = 100
winY = 80

; Obtener las coordenadas del ratón en la pantalla
GetCursorPos mouseX, mouseY

; Convertir a coordenadas dentro de la ventana del juego
gameX := mouseX - winX
gameY := mouseY - winY

A tener en cuenta:

• Si la ventana del juego se mueve, las coordenadas de la esquina superior izquierda deben obtenerse de nuevo.
• Se recomienda fijar la escala de visualización de Windows al 100%.
• La resolución y el tamaño de la ventana del juego deben ser fijos.
• Este método obtiene las coordenadas de la imagen en pantalla, que no son equivalentes a las coordenadas XY internas del personaje en el mapa del juego.

Capturar la posición del ratón al pulsar F1: tecla de acceso rápido para coordenadas

Durante la fase de desarrollo, introducir coordenadas manualmente es tedioso. Una forma más eficiente es usar una tecla de acceso rápido que rellene automáticamente las coordenadas actuales del ratón en los campos del GUI del script.

Método de implementación

; Registrar la tecla de acceso rápido F1
Hotkey, F1, GetMousePos
return

GetMousePos:
    MouseGetPos, mx, my
    GuiControl,, FindX, %mx%
    GuiControl,, FindY, %my%
    ToolTip, Coordenadas capturadas: X%mx% Y%my%
    SetTimer, RemoveTip, -2000
return

De esta forma, solo tienes que mover el ratón a la posición deseada y pulsar F1; las coordenadas se rellenarán automáticamente en los campos "Buscar X" y "Buscar Y". Puedes asignar diferentes teclas de acceso rápido a diferentes campos de coordenadas según sea necesario.

Modificar la lógica de teclas: de teclas individuales a pares de teclas

El script original tenía cuatro teclas independientes, cada una con su propio tiempo de espera. Sin embargo, en la práctica, a menudo es necesario enviar dos teclas consecutivamente (por ejemplo, una tecla de habilidad y luego una tecla de apoyo) antes de esperar un período de tiempo.

Modificaciones realizadas:

1. Convertir las teclas independientes en "grupos de teclas": Cada grupo contiene dos teclas (Tecla A, Tecla B) y una configuración de retardo común.
2. En cada ciclo del bucle, enviar la Tecla A y la Tecla B en secuencia.
3. Mantener la función de temporizador de minutos: Se puede elegir enviar el grupo cada N minutos, o en cada ciclo.

Función auxiliar modificada

SendKeyGroup(useGroup, keyA, keyB, waitMs, minute) {
    global TimerCount, TargetHwnd

    if (useGroup != 1)
        return

    if (minute > 0 and Mod(TimerCount, minute * 60) = 0) {
        ; Enviar el grupo de teclas cada N minutos
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }

    if (minute = 0) {
        ; Enviar el grupo en cada ciclo
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
}

Diseño del bucle principal: SetTimer vs. Bucle con Sleep

Esta es una de las decisiones más comunes en los scripts de juegos con AHK:

SetTimer, MainLoopTick, 1000

while (isRunning) { ... Sleep, milisegundos }

Si tu juego requiere operaciones cada segundo o con menor frecuencia (como repetir el uso de una habilidad o aplicar mejoras temporales cada cierto tiempo), SetTimer es la opción más limpia. Si se necesita un control preciso a nivel de milisegundos, es mejor usar un bucle con Sleep y una condición de salida (break).

Errores comunes y advertencias

1. ControlClick no es compatible con todos los juegos: Algunos juegos no procesan los mensajes del ratón en segundo plano. En ese caso, se debe usar PostMessage o buscar otros mensajes de ventana.
2. Formato de teclas en ControlSend: Las teclas especiales deben ir entre llaves, por ejemplo {F1}, {Enter}.
3. Obtener el identificador de la ventana del juego (HWND): La forma más sencilla es usar

   MouseGetPos, , , TargetHwnd

   , pero esto requiere que el ratón esté sobre la ventana del juego.
4. Escala de visualización de Windows: Si la escala del sistema no es 100%, las coordenadas de ControlClick pueden desviarse. Se recomienda usar el juego en modo ventana y fijar la escala de visualización al 100%.
5. Conflictos de teclas de acceso rápido: Las teclas de acceso rápido utilizadas por el script (como F1, F7) pueden entrar en conflicto con las teclas del juego. Se recomienda elegir teclas que el juego no utilice.

Conclusión

La transformación de un script de primer plano a un sistema de múltiples grupos de teclas en segundo plano se basa en cambios fundamentales: la selección de comandos en segundo plano (ControlSend / ControlClick), el cálculo de coordenadas relativas a la ventana y la forma de impulsar el bucle principal. Los ejemplos de modificación proporcionados en este artículo se pueden aplicar directamente a Water Margin Online o a otros scripts de automatización de juegos con requisitos similares. Si tu juego tiene combinaciones de teclas especiales o necesidades de clics en coordenadas específicas, te recomendamos empezar probando una versión mínima en segundo plano y añadir funciones de forma incremental.