WARDOGS — бойова гра на гелікоптерах на Unreal Engine 5. Її власний плагін джойстика зчитує кожен пристрій DirectInput і зберігає прив'язки в одному файлі налаштувань: шість льотних осей і льотні дії, кожна з пристроєм, якому вона належить. JoyPro зчитує цей розділ у ваш профіль і записує його назад разом із чутливістю, мертвою зоною сторінки HOTAS і перемикачем Enable HOTAS. Клавіатура, миша й усі інші частини файлу залишаються без змін.
WARDOGS напряму (власні файли прив'язок)
- Підтримка
- напряму (власні файли прив'язок)
- Команда рушія
engine wardogs- Файл прив'язок
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini(Unreal ini, хешовані назви полів)- Список команд з
- ваш
GameUserSettings.ini+ осі JoyPro - Внутрішньоігровий тест
- 36/36 кроків пройдено (2026-10-11)
- ✓ Імпорт
- ✓ Експорт
- ✗ Прив'язки клавіатури
- ✗ Модифікатори
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✓ Криві осей і мертві зони
- ✓ Налаштування керування гри
- ✗ Налаштування Force Feedback у грі
- ✗ Force Feedback з телеметрії
- ✗ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✓ Внутрішньоігровий тест
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 3 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
тримайте WARDOGS закритою
До: один раз відкрийте в грі Settings > GAMEPAD > HOTAS. Потім закрийте її.
Потім: Enable HOTAS увімкнено, а ваші прив'язки — на сторінці HOTAS.
Ви вже прив'язували кнопки у WARDOGS раніше? Тоді сторінка «Початок» пропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаються, а нові завдання отримують лише вільні кнопки. Див. Швидкий старт: як змусити мою ручку керування працювати.
#Що JoyPro робить для WARDOGS
- Імпорт: прив'язки сторінки HOTAS потрапляють у ваш профіль: Pitch, Roll, Yaw, загальний крок (Throttle), дві осі огляду й льотні дії (Fire, Flares, Reload, Horn, Ping ...), кожна на своєму пристрої, з інверсією, чутливістю й мертвою зоною.
- Зв'язки: один зв'язок може водночас обслуговувати WARDOGS та інші ваші ігри: наприклад, «Collective» на важелі газу у WARDOGS і в гелікоптерах DCS.
- Експорт: JoyPro записує прив'язки гелікоптера у файл налаштувань гри й вмикає Enable HOTAS, щоб гра їх використовувала.
#Імпорт ваших прив'язок WARDOGS
- Відкрийте Початок. Якщо картка WARDOGS просить список команд, натисніть Створити список: JoyPro створює його з вашого власного файлу налаштувань і своєї таблиці осей.
- Натисніть Імпорт на картці WARDOGS. Залиште Додати до мого профілю (рекомендовано).
- Натисніть Імпортувати зараз. Показати мої зв'язки відкриває те, що надійшло.


#Створення й перевірка зв'язків
На сторінці Зв'язки об'єднайте дії WARDOGS з тією самою функцією ваших інших ігор, див. процес роботи зі зв'язками. Потім запустіть Перевірити на сторінці «Експорт»: перевірка знаходить кнопку, яка у WARDOGS робить дві речі, раніше, ніж це зробить гра.
#Експорт у WARDOGS
- Закрийте WARDOGS. Під час виходу гра перезаписує весь свій файл налаштувань, тому JoyPro відмовляється записувати, поки вона працює.
- Відкрийте Експорт і позначте картку WARDOGS.
- Залиште Замінити на моїх пристроях разом з Очистити й інші мої пристрої, якщо ви налаштовуєте свої ручки в JoyPro. Натисніть Експортувати зараз на картці.


Запустіть WARDOGS і відкрийте Settings > GAMEPAD > HOTAS. Enable HOTAS увімкнено, кожен рядок осі показує ваш пристрій і вісь із прапорцем інверсії, повзунками Sensitivity і Мертва зона, а дії показують ваші кнопки. Меню рахує кнопки дій від 0, а кнопки половин осей — від 1, тож та сама кнопка може показуватися під двома різними номерами.
#Що ви робите самі у WARDOGS
- Один раз відкрийте сторінку HOTAS перед першим експортом. JoyPro записує лише в розділ джойстика гри; якщо у файлі його ще немає, експорт зупиняється й просить вас відкрити цю сторінку в грі.
- Поки Enable HOTAS увімкнено, політ із мишею й клавіатурою вимкнено. JoyPro вмикає його щоразу, коли записує прив'язки. Щоб керувати ним самостійно, задайте його в Налаштування > Налаштування force feedback ігор (гра WARDOGS): те, що ви там збережете, записується під час кожного експорту.
- «Garage / Vendor» і «Free Look Reset» ще немає у списку JoyPro. Один раз прив'яжіть їх у грі, потім натисніть Оновлення на картці WARDOGS: JoyPro додасть дії, які знайде у вашому файлі.
#Типові помилки
- «WARDOGS працює»: закрийте гру й експортуйте знову.
- Пристрій показується в грі як NOT CONNECTED: гра називає пристрій за VID:PID і його назвою DirectInput. Експортуйте знову з підключеним пристроєм: JoyPro виправляє назву, що відрізняється від підключеного пристрою з тим самим VID:PID.
- Два однакові пристрої: WARDOGS не може їх розрізнити (вони отримують однакову назву). Використовуйте Віртуальний joystick або залиште в прив'язках WARDOGS лише один із них.
- Прив'язки нічого не роблять у польоті: перевірте Enable HOTAS на сторінці HOTAS; коли його вимкнено, гра ігнорує всі прив'язки джойстика.
#Файли, які JoyPro читає й записує
| Файл | Що це |
|---|---|
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini |
прив'язки в розділі [/Script/WDJoystick.WDJoystickSettings]; перемикачі для всієї гри Enable HOTAS (bUseHOTASHelicopters) і Self-Centering Collective (bCollectiveSelfCentering) у [/Script/WDGame.WDUserSettings] |
...\GameUserSettings.ini.joypro-meta.json |
дані JoyPro про експортовані прив'язки (назви зв'язків, групи, налаштування осей), які читає наступний імпорт |
...\GameUserSettings.ini.jpbak |
резервна копія перед першим записом (також зберігається у сховищі резервних копій JoyPro) |
Прив'язки клавіатури з того самого файлу й з Saved\SaveGames\EnhancedInputUserSettings.sav не читаються й не записуються. JoyPro нічого не читає з інсталяції: джерело списку команд — ваш файл налаштувань.
#Режими експорту у WARDOGS
Гра використовує одну прив'язку на дію. Кожен режим працює лише з діями гелікоптера з каталогу JoyPro; інші рядки й розділи файлу ніколи не змінюються.
| Режим | Що відбувається |
|---|---|
| Лише додати | Прив'язка додається лише там, де слот дії вільний і жодна інша дія з каталогу не використовує цю кнопку чи вісь; інакше вона пропускається й позначається «Не записано в гру». Зайнятий слот ніколи не замінюється. |
| Оновити, зберегти прив'язки гри | Ваша прив'язка займає слот дії (замінює вхід, що там був). Інша дія з каталогу на тому самому вході втрачає його. Другий рядок дії залишається. |
| Оновити, мій профіль головніший | Як вище, і зайві рядки дії видаляються, тож перенесена дія переноситься повністю. |
| Замінити на моїх пристроях | Пристрої, які ви записуєте, зберігають лише ваші прив'язки дій з каталогу. |
| + Очистити й інші мої пристрої | Підключені пристрої без прив'язок у вашому профілі втрачають свої прив'язки з каталогу. |
Експорт профілю без прив'язок WARDOGS записує лише збережені вами налаштування для всієї гри.
#Що ніколи не змінюється
- Прив'язки клавіатури й миші, файл збереження клавіатури та кожен розділ поза розділом joystick (крім двох перемикачів для всієї гри).
- Дії, яких немає в каталозі JoyPro: їхні рядки залишаються як є.
- Пристрої, які не підключено, пристрої, ігноровані під час імпорту, і пристрій vJoy, у який передає JoyPro.
- Невідомі поля рядка прив'язки: вони зберігаються як є.
#Осі, чутливість, мертва зона
- Глобально: WARDOGS не має профілів літаків чи техніки; прив'язки діють для кожного гелікоптера.
- Для кожної осі: інверсія, Sensitivity (від 0.1 до 2.0, 1 = без змін) і Мертва зона (від 0 до 0.5), у власних одиницях сторінки HOTAS, округлені до її двох знаків після коми. Імпорт зберігає їх як налаштування WARDOGS зв'язку, тож ваші інші ігри зберігають свої власні криві.
- Без значень WARDOGS JoyPro підбирає їх з вашої базової кривої: мертва зона переноситься, чутливість іде за нахилом до насичення. Мертва зона повзунка не переноситься, бо WARDOGS вважає колективний крок центрованою віссю. Вигин і користувацькі криві виразити не можна; експорт попереджає.
- Гра не показує попереднього перегляду, а її формула невідома. Попередній перегляд JoyPro припускає інверсію, перемасштабовану мертву зону, потім множення на чутливість, з обрізанням на повному відхиленні (ще не підтверджено).
- Налаштування гри: Enable HOTAS і Self-Centering Collective (для схем із двома ручками: колективний крок повертається до зависання, коли ви його відпускаєте; для важелів газу залиште вимкненим), у Налаштування > Налаштування force feedback ігор. Вони записуються лише тоді, коли файл уже має цей ключ. WARDOGS не має Force Feedback.
- Спостерігач: прив'язку, яку ви змінили на сторінці HOTAS, помічено після закриття гри; JoyPro питає, чи перенести її (спостерігач).
- HUD: поки працює WARDOGS, HUD називає дію кожної натиснутої кнопки.
#Усередині інтеграції WARDOGS
flowchart LR P["Ваш профіль"] --> E["engine wardogs export"] E --> S["GameUserSettings.ini"] E --> H["Enable HOTAS увімкнено"] E --> M[".joypro-meta.json"] S --> G["Settings > GAMEPAD<br/>> HOTAS"] H --> G
Код: engine\Games\WardogsIntegration.cs, engine\AxisModels\Wardogs.cs (модель осей wardogs), engine\FfbModels\Wardogs.cs (два перемикачі для всієї гри).
- Файл: ASCII, CRLF, без BOM, перший рядок
;METADATA=(Diff=true, UseCommands=true). Рядки осей — завжди всі шість, у порядку Pitch, Throttle, Roll, Yaw, LookPitch, LookYaw;ActionBindings=(Action=<action>,Binding=(...))по одному на кожну прив'язану дію, нові рядки після останнього. Вісь відв'язується черезDeviceIdentifier=""; дія — видаленням її рядка. Дробові числа з шістьма знаками після коми. Назви залишаються в ASCII (назва не в ASCII змусила б рушій зберегти UTF-16). - Назви полів: більшість полів — хешовані токени (
_aaaa...). JoyPro ніколи не прописує їх жорстко: він знаходить кожне поле за його місцем біля читабельних опорних полів (DeviceIdentifier,bInvert,Positive,Sensitivity,DeadZone) і зупиняється, коли форма змінюється. - Пристрої:
DeviceIdentifier="VID:PID:<DirectInput instance name>", VID і PID з GUID продукту DirectInput, назва точно така, як її повідомляє DirectInput, разом із пробілами на кінцях (ніколи не обрізаються). Номери осей — це слоти DIJOYSTATE2 (0 X, 1 Y, 2 Z, 3 Rx, 4 Ry, 5 Rz, 6/7 повзунки); кнопки рахуються від 0. - Список команд:
engine wardogs refresh-dbбудує його з вашого файлу налаштувань плюс осей JoyPro;engine wardogs catalogперелічує його,engine wardogs pathsпоказує, де шукає JoyPro. - Імпорт / експорт:
engine wardogs scan,engine wardogs import,engine wardogs export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --ignore-device <d> --dry-run. - Налаштування гри:
engine ffb set--device * --game Wardogs --param enableHotas=true(абоselfCenteringCollective).
#Відомі обмеження
- Повний список дій невідомий; JoyPro перелічує дії, які траплялися в справжніх файлах.
- Напрямки хета як дії: кодування ще не підтверджено.
- Формула відгуку Sensitivity і Deadzone невідома.
- Однакові пристрої отримують той самий ідентифікатор і конфліктують.
- Тести:
engine\tests\smoke\wardogs.ps1; у гріtools\e2e\games\Wardogs.ps1(прив'язки),WardogsSettings.ps1(значення сторінки HOTAS) іWatchdog.ps1(спостерігач).
Усі технічні примітки до цієї гри (створено з репозиторію): wardogs.md.