AHK-Skript-Anpassung für Spiele-Automatisierung: Hintergrund-Tastendrücke und präzise Koordinaten

Viele Spieler greifen zu AutoHotkey (AHK), um sich wiederholende Aktionen zu automatisieren. Häufige Hürden sind: Wie bringt man das Skript dazu, im Hintergrund zu laufen, während man anderen Aufgaben nachgeht? Wie ermittelt man präzise die Koordinaten innerhalb eines Spielfensters? Und wie sendet man Tasteneingaben stabil und zuverlässig?

Dieser Artikel nimmt die Anpassung eines Automatisierungsskripts für „Water Margin Online“ (Shui Hu Li Xian) als Fallbeispiel und erläutert Schritt für Schritt die Implementierung von Hintergrund-Tastendrücken, Koordinaten-Berechnung, Maus-Positionserfassung per Hotkey und dem Senden von Tastengruppen.

Warum sind Hintergrundoperationen wichtig?

Vordergrund-Skripte forcieren beim Ausführen von Mausklicks oder Tasteneingaben das Spielfenster in den Vordergrund und unterbrechen so Ihre aktuelle Arbeit. Das Ziel von Hintergrundoperationen ist es, dass das Skript läuft, während Sie andere Fenster nutzen können – das Spielfenster empfängt die Befehle im Hintergrund, ohne in den Vordergrund geholt zu werden.

Die entscheidenden Befehle in AHK für Hintergrundoperationen sind:

• ControlSend: Sendet Tastenanschläge an ein bestimmtes Fenster, ohne es zu aktivieren.
• ControlClick: Sendet Mausklicks an bestimmte Koordinaten innerhalb eines Fensters, ohne es zu aktivieren.
• In Verbindung mit

  ahk_id %TargetHwnd%

  wird das Zielfenster eindeutig identifiziert.

Wie fixiert man XY-Koordinaten innerhalb des Spielfensters?

Die XY-Koordinaten im Spiel unterscheiden sich von den absoluten Bildschirmkoordinaten. Wenn das Spielfenster verschoben oder in der Größe verändert wird, führen fest codierte absolute Bildschirmkoordinaten zu Fehlklicks.

Die korrekte Methode ist die Berechnung von relativen Koordinaten innerhalb des Fensters:

Spiel-interne X = Maus-Bildschirm-X - X der oberen linken Ecke des Spielfensters
Spiel-interne Y = Maus-Bildschirm-Y - Y der oberen linken Ecke des Spielfensters

Für höhere Präzision sollte die obere linke Ecke des Spiel-Client-Bereichs (ohne Titelleiste und Rahmen) als Bezugspunkt dienen, nicht die des gesamten Fensters.

Implementierungsbeispiel

; Koordinaten der oberen linken Ecke des Spielfensters (müssen zuvor ermittelt werden)
winX = 100
winY = 80

; Aktuelle Mausposition auf dem Bildschirm abrufen
GetCursorPos mouseX, mouseY

; Umrechnung in Koordinaten innerhalb des Spielfensters
gameX := mouseX - winX
gameY := mouseY - winY

Wichtige Hinweise:

• Nach dem Verschieben des Spielfensters müssen die Koordinaten der oberen linken Ecke neu ermittelt werden.
• Die Windows-Anzeigeskalierung sollte auf 100 % eingestellt sein.
• Die Spielauflösung und Fenstergröße sollten unverändert bleiben.
• Diese Methode liefert Bildschirmkoordinaten, nicht die internen Koordinaten der Spielfigur auf der Karte.

Drücken Sie F1, um die Mausposition zu erfassen: Hotkey zur Koordinaten-Erfassung

Während der Entwicklung ist das manuelle Eingeben von Koordinaten mühsam und fehleranfällig. Effizienter ist es, einen Hotkey zu verwenden, der die aktuelle Mausposition direkt in die entsprechenden Felder der GUI des Skripts einträgt.

Implementierungsmethode

; Hotkey F1 registrieren
Hotkey, F1, GetMousePos
return

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

So können Sie die Maus an die gewünschte Stelle bewegen, F1 drücken, und die Koordinaten werden automatisch in die Felder „Finde X“ und „Finde Y“ eingetragen. Sie können bei Bedarf verschiedene Hotkeys für unterschiedliche Koordinatenfelder verwenden.

Anpassung der Tastenlogik: Von Einzeltasten zu Tastengruppen

Das ursprüngliche Skript sah vier unabhängige Tasten vor, jede mit eigener Verzögerung. Im tatsächlichen Spiel besteht jedoch häufig die Notwendigkeit, zwei Tasten hintereinander zu senden (z. B. zuerst eine Fertigkeit, dann eine Hilfstaste), bevor eine Wartezeit eingelegt wird.

Änderungsrichtung:

1. Unabhängige Tasten werden zu „Tastengruppen“: Jede Gruppe besteht aus zwei Tasten (Taste A, Taste B) und einer gemeinsamen Verzögerungseinstellung.
2. In jedem Schleifendurchlauf werden Taste A und Taste B nacheinander gesendet.
3. Die Minuten-Timer-Funktion bleibt erhalten: Optional kann die Gruppe alle N Minuten oder in jedem Durchlauf gesendet werden.

Angepasste Hilfsfunktion

SendKeyGroup(useGroup, keyA, keyB, waitMs, minute) {
    global TimerCount, TargetHwnd
    
    if (useGroup != 1)
        return
    
    if (minute > 0 and Mod(TimerCount, minute * 60) = 0) {
        ; Sende die Tastengruppe alle N Minuten
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
    
    if (minute = 0) {
        ; Sende die Tastengruppe in jedem Schleifendurchlauf
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
}

Design der Hauptschleife: SetTimer vs. Schlaf-Schleife

Dies ist die häufigste Entscheidung bei der Entwicklung von AHK-Spielleitfäden:

SetTimer, MainLoopTick, 1000

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

Wenn Ihr Spiel Aktionen im Sekundentakt oder langsamer erfordert (z. B. wiederholtes Anwenden von Fertigkeiten, regelmäßiges Buffen), ist SetTimer die sauberere Wahl. Falls Sie eine millisekundengenaue Steuerung benötigen, verwenden Sie eine Schlaf-Schleife mit einer break-Bedingung.

Häufige Fallstricke und Hinweise

1. ControlClick wird nicht von allen Spielen unterstützt: Einige Spiele verarbeiten keine Hintergrund-Mausnachrichten. Als Alternative können Sie PostMessage verwenden oder nach anderen Fensternachrichten suchen.
2. Tastenformat für ControlSend: Spezielle Tasten müssen in geschweifte Klammern gesetzt werden, z. B. {F1}, {Enter}.
3. Ermitteln des Fenster-Handles: Der einfachste Weg ist

   MouseGetPos, , , TargetHwnd

   , aber der Mauszeiger muss sich dabei über dem Spielfenster befinden.
4. Windows-Anzeigeskalierung: Ist die Skalierung nicht auf 100 % eingestellt, können die Koordinaten bei ControlClick verschoben sein. Empfehlung: Spiel im Fenstermodus und Anzeigeskalierung auf 100 %.
5. Hotkey-Konflikte: Die im Skript verwendeten Hotkeys (z. B. F1, F7) könnten mit Tasten im Spiel kollidieren. Wählen Sie Tasten, die das Spiel nicht verwendet.

Fazit

Die Umstellung von einem einfachen Vordergrund-Skript auf ein Hintergrundsystem mit mehreren Tastengruppen erfordert im Kern drei Änderungen: die Wahl der richtigen Hintergrundbefehle (ControlSend / ControlClick), die korrekte Umrechnung von Fensterkoordinaten und die Festlegung der Hauptschleifensteuerung (Timer vs. Schlaf-Schleife). Die hier gezeigten Code-Beispiele können direkt an „Water Margin Online“ oder andere Spiele mit ähnlichen Automatisierungsanforderungen angepasst werden. Wenn Ihr Spiel spezielle Tastenkombinationen oder Koordinatenklicks erfordert, empfiehlt es sich, mit einer minimalen, funktionsfähigen Hintergrundversion zu beginnen und die Funktionen schrittweise zu erweitern.

Zusätzlicher Hinweis zur Koordinaten-Ermittlung: Die GUI des bereitgestellten Skripts enthält Schaltflächen wie „Speichern“, die die aktuelle Mausposition direkt in die entsprechenden Koordinatenfelder (X1/Y1, X2/Y2, FindX/FindY) eintragen. Dies erleichtert die Einrichtung des Skripts erheblich, da Sie die Werte nicht manuell eingeben müssen. Die gespeicherten Koordinaten werden dann bei der Ausführung des Skripts für die Hintergrundklicks verwendet.