Script AHK: automazione in background e acquisizione coordinate per "Water Margin"

Molti giocatori, per risparmiare tempo su operazioni ripetitive, provano a scrivere script di automazione con AutoHotkey (AHK). Le difficoltà più comuni sono: come fare in modo che lo script funzioni in background senza interferire con altre attività? Come ottenere con precisione le coordinate all'interno della finestra di gioco? E come rendere l'invio dei tasti più stabile?

Questo articolo prende come caso pratico la modifica di uno script per l'automazione di Water Margin Online, analizzando passo dopo passo l'implementazione di tasti in background, il calcolo delle coordinate, l'hotkey per l'acquisizione del mouse e l'invio di gruppi di tasti multipli.

Perché è necessario operare in background?

Quando uno script frontale esegue un clic o invia un tasto, forza la finestra di gioco in primo piano, interrompendo qualsiasi altra cosa tu stia facendo. L'obiettivo delle operazioni in background è: mentre lo script è in esecuzione, tu puoi continuare a usare altre finestre, e la finestra di gioco riceve i comandi in background.

In AHK, i comandi chiave per le operazioni in background sono:

• ControlSend: invia tasti a una finestra specifica senza attivarla.
• ControlClick: invia un clic del mouse a coordinate specifiche all'interno di una finestra, senza attivarla.
• Da abbinare con

  ahk_id %TargetHwnd%

  per bloccare la finestra di destinazione.

Come fissare le coordinate XY all'interno della finestra di gioco?

Le coordinate XY all'interno del gioco sono diverse dalle coordinate assolute dello schermo. Quando la finestra di gioco viene spostata o ridimensionata, i clic fissati con coordinate assolute dello schermo non funzioneranno più.

La soluzione corretta è calcolare le "coordinate relative alla finestra":

X nel gioco = X schermo del mouse - X angolo superiore sinistro della finestra di gioco
Y nel gioco = Y schermo del mouse - Y angolo superiore sinistro della finestra di gioco

Per maggiore precisione, utilizza come riferimento l'angolo superiore sinistro dell'area di contenuto del gioco (escludendo la barra del titolo e i bordi), non quello dell'intera finestra.

Esempio pratico

; Coordinate dell'angolo superiore sinistro della finestra di gioco (da ottenere prima)
winX = 100
winY = 80

; Ottieni le coordinate dello schermo del mouse
GetCursorPos mouseX, mouseY

; Converti in coordinate relative alla finestra di gioco
gameX := mouseX - winX
gameY := mouseY - winY

Attenzione:

• Dopo aver spostato la finestra di gioco, le coordinate dell'angolo superiore sinistro devono essere riacquisite.
• Si consiglia di impostare il fattore di scala di Windows al 100%.
• La risoluzione del gioco e la dimensione della finestra dovrebbero rimanere fisse.
• Questo metodo ottiene le coordinate dello schermo, non le coordinate XY interne del personaggio sulla mappa di gioco.

Premi F1 per catturare la posizione del mouse: l'hotkey per l'acquisizione delle coordinate

Durante la fase di sviluppo, inserire manualmente le coordinate è scomodo. Un modo più efficiente è: premere un hotkey e far sì che le coordinate della posizione corrente del mouse vengano inserite automaticamente nei campi della GUI dello script.

Metodo di implementazione

; Registra l'hotkey F1
Hotkey, F1, GetMousePos
return

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

Così, basta posizionare il mouse sul punto desiderato e premere F1: le coordinate verranno automaticamente inserite nei campi "Trova X" e "Trova Y". Puoi assegnare hotkey diversi a campi di coordinate diversi, a seconda delle necessità.

Rielaborare la logica dei tasti: da singolo tasto a coppie

Lo script originale aveva quattro tasti indipendenti, ciascuno con il proprio ritardo. Ma nei giochi reali, spesso è necessario inviare due tasti in sequenza (ad esempio, prima il tasto di una abilità e poi quello di un supporto), e solo dopo attendere un determinato intervallo di tempo.

Modifiche da apportare:

1. Trasformare i tasti indipendenti in "gruppi di tasti": ogni gruppo contiene due tasti (Tasto A, Tasto B) e un'impostazione di ritardo comune.
2. In ogni ciclo, inviare in sequenza il Tasto A e il Tasto B.
3. Mantenere la funzione di temporizzazione al minuto: si può scegliere di inviare ogni N minuti o a ogni ciclo.

Funzione ausiliaria modificata

SendKeyGroup(useGroup, keyA, keyB, waitMs, minute) {
    global TimerCount, TargetHwnd
    
    if (useGroup != 1)
        return
    
    if (minute > 0 and Mod(TimerCount, minute * 60) = 0) {
        ; Invia il gruppo di tasti ogni N minuti
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
    
    if (minute = 0) {
        ; Invia il gruppo a ogni ciclo
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
}

La scelta progettuale del ciclo principale: SetTimer contro Sleep loop

Questo è il dilemma più comune negli script AHK per i giochi:

SetTimer, MainLoopTick, 1000

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

Se il tuo gioco richiede operazioni con una frequenza di 1 secondo o inferiore (ad esempio, usare ripetutamente abilità, applicare buff a intervalli regolari), SetTimer è la scelta più pulita. Se hai bisogno di un controllo preciso al millisecondo, allora dovresti usare un loop con Sleep e una condizione di break.

Errori comuni e consigli

1. ControlClick non è supportato da tutti i giochi: alcuni giochi non gestiscono i messaggi del mouse in background. In tal caso, è necessario utilizzare PostMessage o cercare altri messaggi della finestra.
2. Formato dei tasti per ControlSend: i tasti speciali devono essere racchiusi tra parentesi graffe, ad esempio {F1}, {Enter}.
3. Ottenere l'handle della finestra di gioco: il modo più semplice è usare

   MouseGetPos, , , TargetHwnd

   , ma a condizione che il mouse si trovi sulla finestra di gioco.
4. Fattore di scala di Windows: se lo scaling del sistema non è al 100%, le coordinate di ControlClick potrebbero essere spostate. Si consiglia di usare il gioco in modalità finestra e impostare lo scaling del display al 100%.
5. Conflitti di hotkey: gli hotkey usati dallo script (come F1, F7) potrebbero entrare in conflitto con i tasti del gioco. Si consiglia di scegliere tasti che il gioco non utilizza.

Conclusione

La trasformazione da uno script frontale a un sistema di tasti multipli in background si basa su tre modifiche fondamentali: la scelta dei comandi in background (ControlSend / ControlClick), il calcolo delle coordinate relative alla finestra e la modalità di esecuzione del ciclo principale. Gli esempi di modifica forniti in questo articolo possono essere applicati direttamente a script di automazione per Water Margin Online o per altri giochi con esigenze simili. Se il tuo gioco richiede combinazioni di tasti o clic su coordinate particolari, ti consigliamo di iniziare testando una versione minima in background e di aggiungere funzionalità gradualmente.