Praktyczny przewodnik po skryptach AHK: od automatyzacji w grze Water Margin Online, przez działanie w tle, po przechwytywanie współrzędnych

Wielu graczy, chcąc zaoszczędzić czas przy powtarzalnych czynnościach, próbuje pisać skrypty automatyzujące w AutoHotkey (AHK). Typowe problemy to: jak sprawić, by skrypt działał w tle, nie przeszkadzając w innych pracach? Jak dokładnie obliczyć współrzędne w oknie gry? I jak sprawić, by wysyłanie klawiszy było stabilne?

Ten artykuł, na przykładzie procesu modyfikacji skryptu automatyzującego dla gry Water Margin Online (水浒历险), krok po kroku wyjaśnia implementację wysyłania klawiszy w tle, obliczania współrzędnych, skrótów do przechwytywania pozycji myszy i wysyłania par klawiszy.

Dlaczego potrzebujemy działania w tle?

Skrypt działający na pierwszym planie (foreground) podczas klikania myszą lub wysyłania klawiszy wymusza wysunięcie okna gry na wierzch, przerywając inne czynności. Celem działania w tle jest: podczas działania skryptu możesz swobodnie korzystać z innych okien, a okno gry w tle i tak odbiera komendy.

W AHK kluczowymi komendami do działania w tle są:

• ControlSend: wysyła naciśnięcia klawiszy do określonego okna, nie aktywując go.
• ControlClick: wysyła kliknięcie myszą do określonych współrzędnych w oknie, nie aktywując go.
• W połączeniu z

  ahk_id %TargetHwnd%

  blokujemy docelowe okno.

Jak utrwalić współrzędne XY w oknie gry?

Współrzędne XY w grze różnią się od bezwzględnych współrzędnych ekranu. Gdy okno gry zostanie przesunięte lub zmieni rozmiar, punkty zapisane jako bezwzględne współrzędne ekranu przestają działać.

Prawidłowym rozwiązaniem jest obliczenie względnych współrzędnych w oknie:

X w grze = X myszy na ekranie - X lewego górnego rogu okna gry
Y w grze = Y myszy na ekranie - Y lewego górnego rogu okna gry

Dla większej precyzji należy użyć lewego górnego rogu obszaru treści gry (po odjęciu paska tytułu i ramek), a nie całego okna.

Przykład implementacji

; Współrzędne lewego górnego rogu okna gry (należy je wcześniej pobrać)
winX = 100
winY = 80

; Pobierz pozycję myszy na ekranie
MouseGetPos, mouseX, mouseY

; Przelicz na współrzędne wewnątrz okna gry
gameX := mouseX - winX
gameY := mouseY - winY

Uwagi:

• Po przesunięciu okna gry należy ponownie pobrać współrzędne jego lewego górnego rogu.
• Zaleca się ustawienie skalowania wyświetlania w systemie Windows na 100%.
• Rozdzielczość gry i rozmiar okna powinny być stałe.
• Ta metoda podaje współrzędne obrazu, nie wewnętrzne współrzędne XY postaci na mapie.

Przechwytywanie pozycji myszy po naciśnięciu F1: skrót do pobierania współrzędnych

Na etapie tworzenia skryptu ręczne wpisywanie współrzędnych jest uciążliwe. Znacznie wydajniejszym sposobem jest użycie skrótu klawiszowego, który automatycznie wprowadzi aktualną pozycję myszy do pól GUI skryptu.

Metoda implementacji

; Zarejestruj skrót klawiszowy F1
Hotkey, F1, GetMousePos
return

GetMousePos:
    MouseGetPos, mx, my
    GuiControl,, FindX, %mx%
    GuiControl,, FindY, %my%
    ToolTip, Przechwycono współrzędne: X%mx% Y%my%
    SetTimer, RemoveTip, -2000
return

W ten sposób wystarczy przesunąć mysz nad cel, nacisnąć F1, a współrzędne zostaną automatycznie wypełnione w polach „Szukaj X / Szukaj Y”. Możesz przypisać różne skróty do różnych pól współrzędnych.

Przebudowa logiki klawiszy: od pojedynczego klawisza do pary

Oryginalny skrypt zawierał cztery niezależne klawisze, każdy z własnym opóźnieniem. W praktyce jednak w grze często potrzebne jest wysłanie dwóch klawiszy po kolei (np. najpierw klawisz umiejętności, potem pomocniczy), a dopiero potem odczekanie chwili.

Kierunek modyfikacji:

1. Zamiana niezależnych klawiszy na „grupy klawiszy”: każda grupa zawiera dwa klawisze (Klawisz A, Klawisz B) oraz wspólne ustawienie opóźnienia.
2. W każdej pętli wysyłaj kolejno Klawisz A i Klawisz B.
3. Zachowanie funkcji timera minutowego: opcjonalnie można wysyłać co N minut lub przy każdej pętli.

Zmodyfikowana funkcja pomocnicza

SendKeyGroup(useGroup, keyA, keyB, waitMs, minute) {
    global TimerCount, TargetHwnd
    
    if (useGroup != 1)
        return
    
    if (minute > 0 and Mod(TimerCount, minute * 60) = 0) {
        ; Wyślij grupę klawiszy co N minut
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
    
    if (minute = 0) {
        ; Wyślij przy każdej pętli
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
}

Wybór projektu pętli głównej: SetTimer vs. pętla Sleep

To najczęściej spotykany dylemat w skryptach AHK do gier:

SetTimer, MainLoopTick, 1000

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

Jeśli twoja gra wymaga operacji co sekundę lub rzadziej (np. powtarzanie umiejętności, okresowe odnawianie buffów), SetTimer jest czystszym wyborem. Jeśli potrzebujesz kontroli z dokładnością do milisekund, lepiej użyć pętli Sleep z warunkiem break.

Częste pułapki i porady

1. ControlClick nie działa ze wszystkimi grami: Niektóre gry nie obsługują komunikatów myszy wysyłanych w tle. Wtedy trzeba użyć PostMessage lub znaleźć inne komunikaty okna.
2. Format klawiszy w ControlSend: Specjalne klawisze należy umieścić w nawiasach klamrowych, np. {F1}, {Enter}.
3. Pobranie uchwytu (handle) okna gry: Najprostszy sposób to

   MouseGetPos, , , TargetHwnd

   , ale wymaga to, aby kursor myszy znajdował się nad oknem gry.
4. Skalowanie wyświetlania w Windows: Jeśli skalowanie systemowe nie wynosi 100%, współrzędne w ControlClick mogą być przesunięte. Zaleca się używanie gry w trybie okna i ustawienie skalowania na 100%.
5. Konflikty skrótów klawiszowych: Skróty używane przez skrypt (np. F1, F7) mogą kolidować ze skrótami w grze. Wybieraj klawisze, które nie są używane przez grę.

Podsumowanie

Przeróbka prostego skryptu pierwszoplanowego na system tylnowidokowy z wieloma grupami klawiszy opiera się na trzech kluczowych zmianach: wybór komend tylnowidokowych (ControlSend / ControlClick), przeliczanie współrzędnych w oknie oraz sposób napędzania pętli głównej. Załączone przykłady modyfikacji można bezpośrednio zastosować w Water Margin Online lub innych skryptach automatyzujących gry o podobnych wymaganiach. Jeśli twoja gra wymaga specjalnych kombinacji klawiszy lub kliknięć w konkretne punkty, zalecamy zacząć od minimalnej działającej wersji tylnowidokowej i stopniowo dodawać funkcje.