JoyPro2 Discord GitHub
Игры

WARDOGS

Показать:

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 шага

  1. Настроить всё за меня
    на странице «Старт»
  2. Использовать эти кнопки
    сначала посмотрите список
  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

  1. Откройте Старт. Если карточка WARDOGS просит список команд, нажмите Создать список: JoyPro создаст его из вашего собственного файла настроек и своей таблицы осей.
  2. Нажмите Импорт на карточке WARDOGS. Оставьте Добавить в мой профиль (рекомендуется).
  3. Нажмите Импортировать. Мои связки открывает то, что пришло.
Страница «Старт» с вашими играмиСтраница «Старт» с вашими играми
Страница «Старт» с вашими играми (На изображениях приложение на английском.)

#Создание и проверка связок

На странице Связки объедините действия WARDOGS с той же функцией ваших других игр, см. порядок работы со связками. Затем запустите Проверить на странице «Экспорт»: проверка найдёт кнопку, которая делает в WARDOGS две вещи, раньше, чем это заметит игра.

#Экспорт в WARDOGS

  1. Закройте WARDOGS. При выходе игра перезаписывает весь свой файл настроек, поэтому JoyPro отказывается записывать, пока она работает.
  2. Откройте Экспорт и отметьте карточку WARDOGS.
  3. Оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете устройства в JoyPro. Нажмите Экспортировать на карточке.
Страница «Экспорт»Страница «Экспорт»
Страница «Экспорт»
В игре: Что вы увидите в WARDOGS

Запустите 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
JoyPro записывает раздел джойстика в GameUserSettings.ini (6 осей и действия полёта), включает Enable HOTAS, когда записываются привязки, и хранит имена и группы в .joypro-meta.json.

Код: 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.