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 из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ✓ Мастер настройки / Автоназначение
- ✓ Кабины
- ✓ Шпаргалки
- ✓ Внутриигровой тест
Из матрицы поддержки, созданной по коду движка: все игры.
#Запуск за 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 включает его каждый раз, когда записывает привязки. Чтобы управлять им самостоятельно, задайте его в Настройки > Настройки FFB игр (игра WARDOGS): то, что вы там сохраните, записывается при каждом экспорте.
- «Garage / Vendor» и «Free Look Reset» пока нет в списке JoyPro. Один раз привяжите их в игре, затем нажмите Обновление на карточке WARDOGS: JoyPro добавит действия, которые найдёт в вашем файле.
#Частые ошибки
- «WARDOGS работает»: закройте игру и выполните экспорт снова.
- В игре устройство показано как NOT CONNECTED: игра называет устройство по VID:PID и его имени DirectInput. Выполните экспорт снова с подключённым устройством: JoyPro исправит имя, которое отличается от подключённого устройства с тем же VID:PID.
- Два одинаковых устройства: WARDOGS не может их различить (они получают одно и то же имя). Используйте виртуальный джойстик или оставьте в привязках 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 записывает только сохранённые вами общие настройки игры.
#Что никогда не затрагивается
- Привязки клавиатуры и мыши, файл сохранения клавиатуры и все разделы вне раздела джойстика (кроме двух общих переключателей игры).
- Действия, которых нет в каталоге JoyPro: их строки остаются как есть.
- Неподключённые устройства, игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
- Неизвестные поля строки привязки: они сохраняются как есть.
#Оси, чувствительность, мёртвая зона
- Глобально: в WARDOGS нет профилей ЛА или техники; привязки действуют для всех вертолётов.
- Для каждой оси: инверсия, Чувствительность (от 0.1 до 2.0, 1 = без изменений) и Мёртвая зона (от 0 до 0.5), в собственных единицах страницы HOTAS, с округлением до двух знаков после запятой. Импорт сохраняет их как настройку связки для WARDOGS, поэтому ваши другие игры сохраняют свои кривые.
- Без значений WARDOGS JoyPro подбирает их по вашей базовой кривой: мёртвая зона переносится, чувствительность следует наклону до насыщения. Мёртвая зона ползунка не переносится, потому что WARDOGS считает шаг-газ центрированной осью. Изгиб и пользовательские кривые выразить нельзя; экспорт предупреждает об этом.
- Игра не показывает предпросмотр, и её формула неизвестна. Предпросмотр JoyPro предполагает инверсию, масштабированную мёртвую зону, затем умножение на чувствительность с ограничением на полном отклонении (пока не подтверждено).
- Настройки игры: Enable HOTAS и Self-Centering Collective (для схем с двумя ручками: шаг-газ возвращается в режим висения, когда вы его отпускаете; для рычагов РУД оставьте выключенным), в Настройки > Настройки FFB игр. Они записываются, только если в файле уже есть этот ключ. В 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.