AHK-скриптинг: від автоматизації Water Margin Online до фонового введення та захоплення координат

Багато гравців намагаються використовувати AutoHotkey (AHK) для написання скриптів автоматизації, щоб заощадити час на повторюваних діях. Однак поширеними проблемами є: як змусити скрипт працювати у фоновому режимі, не впливаючи на інші завдання? Як точно отримати координати всередині ігрового вікна? І як зробити надсилання клавіш більш стабільним?

Ця стаття використовує процес модифікації скрипта автоматизації для Water Margin Online як практичний кейс, покроково роз'яснюючи методи реалізації фонового введення, обчислення координат, гарячих клавіш для захоплення миші та надсилання груп клавіш.

Навіщо потрібне фонове введення?

Передпланові скрипти під час виконання кліків миші або надсилання клавіш примусово переміщують ігрове вікно на передній план, перериваючи вашу роботу в інших вікнах. Мета фонового введення – скрипт працює, а ви можете продовжувати користуватися іншими вікнами; ігрове вікно отримує команди у фоновому режимі.

В AHK ключовими командами для фонового введення є:

• ControlSend – надсилає натискання клавіш до вказаного вікна, не активуючи його.
• ControlClick – надсилає клік миші до певних координат у вказаному вікні, не активуючи його.
• У поєднанні з

  ahk_id %TargetHwnd%

  для фіксації цільового вікна.

Як зафіксувати координати XY всередині ігрового вікна?

Координати XY всередині гри відрізняються від абсолютних координат екрана. Коли ігрове вікно переміщується або змінює розмір, «зашиті» в скрипт координати перестають працювати.

Правильний підхід – обчислювати «відносні координати всередині вікна»:

Внутрішній X = Екранний X миші - X верхнього лівого кута вікна
Внутрішній Y = Екранний Y миші - Y верхнього лівого кута вікна

Для більшої точності слід використовувати верхній лівий кут ігрової області (без урахування заголовка та рамок), а не всього вікна.

Приклад реалізації

; Координати верхнього лівого кута ігрового вікна (потрібно отримати заздалегідь)
winX = 100
winY = 80

; Отримуємо екранні координати миші
GetCursorPos mouseX, mouseY

; Перераховуємо у внутрішні координати вікна
gameX := mouseX - winX
gameY := mouseY - winY

Примітки:

• Після переміщення ігрового вікна координати його верхнього лівого кута потрібно отримувати заново.
• Рекомендується зафіксувати масштабування відображення Windows на 100%.
• Роздільна здатність гри та розмір вікна мають бути незмінними.
• Цей метод отримує координати на екрані, які не дорівнюють внутрішнім координатам персонажа на карті.

Натискання F1 для захоплення позиції миші: гаряча клавіша для зчитування координат

На етапі розробки вручну вводити координати постійно – це нудно. Набагато ефективніше налаштувати гарячу клавішу, яка одразу вставляє поточні координати миші у відповідні поля GUI скрипта.

Метод реалізації

; Реєструємо гарячу клавішу F1
Hotkey, F1, GetMousePos
return

GetMousePos:
    MouseGetPos, mx, my
    GuiControl,, FindX, %mx%
    GuiControl,, FindY, %my%
    ToolTip, Координати захоплено: X%mx% Y%my%
    SetTimer, RemoveTip, -2000
return

Таким чином, перемістіть мишу в потрібне місце, натисніть F1 – і координати автоматично потраплять у поля «Пошук X / Пошук Y». За потреби ви можете прив'язати різні гарячі клавіші до різних полів координат.

Зміна логіки клавіш: від поодиноких до парних

Оригінальний скрипт було розроблено з чотирма незалежними клавішами, кожна з яких мала власну затримку. Однак у реальній грі часто потрібно надсилати дві клавіші поспіль (наприклад, спочатку клавішу навички, потім допоміжну), а вже потім чекати певний час.

Напрямки модифікації:

1. Замінити окремі клавіші на «групи клавіш»: кожна група містить дві клавіші (Клавіша A, Клавіша B) та спільне налаштування затримки.
2. У кожному циклі надсилати Клавішу A, а потім Клавішу B.
3. Зберегти функцію таймера хвилин: можна вибрати надсилання групи кожні N хвилин або з кожним циклом.

Модифікована допоміжна функція

SendKeyGroup(useGroup, keyA, keyB, waitMs, minute) {
    global TimerCount, TargetHwnd
    
    if (useGroup != 1)
        return
    
    if (minute > 0 and Mod(TimerCount, minute * 60) = 0) {
        ; Надсилаємо групу кожні N хвилин
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
    
    if (minute = 0) {
        ; Надсилаємо з кожним циклом
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
}

Вибір дизайну головного циклу: SetTimer vs. Sleep-цикл

Це найпоширеніша дилема під час написання ігрових скриптів AHK:

SetTimer, MainLoopTick, 1000

while (isRunning) { ... Sleep, мілісекунди }

Якщо вашій грі потрібні операції з частотою раз на секунду або рідше (наприклад, повторне використання навичок, періодичне накладання бафів), SetTimer – чистіший вибір. Якщо потрібен контроль на рівні мілісекунд, слід використовувати Sleep-цикл з умовою break.

Поширені помилки та застереження

1. ControlClick працює не з усіма іграми: деякі ігри не обробляють фонові повідомлення миші. У таких випадках потрібно використовувати PostMessage або шукати інші способи.
2. Формат клавіш для ControlSend: спеціальні клавіші потрібно обгортати у фігурні дужки, наприклад {F1}, {Enter}.
3. Отримання дескриптора ігрового вікна: найпростіший спосіб –

   MouseGetPos, , , TargetHwnd

   , але для цього миша має бути над ігровим вікном.
4. Масштабування відображення Windows: якщо масштаб не 100%, координати ControlClick можуть зміщуватися. Рекомендується використовувати віконний режим для гри та встановити масштаб 100%.
5. Конфлікт гарячих клавіш: використовувані в скрипті гарячі клавіші (наприклад, F1, F7) можуть конфліктувати з ігровими. Вибирайте клавіші, які не використовуються в грі.

Висновок

Перетворення звичайного передпланового скрипта на фонову багатоклавішну систему зводиться до кількох ключових змін: вибір фонових команд (ControlSend/ControlClick), перерахунок координат всередині вікна та спосіб керування головним циклом. Наведені в статті приклади модифікації можна безпосередньо застосувати до Water Margin Online або інших ігор зі схожими вимогами до автоматизації. Якщо ваша гра вимагає особливих комбінацій клавіш або кліків по координатах, почніть із найпростішої фонової версії та поступово додавайте функціонал.