JoyPro2 Discord GitHub
Игры

Arma Reforger

Показать:

Arma Reforger принимает джойстики через файл пресета джойстика, который вы выбираете в настройках игры. JoyPro записывает свой пресет JoyPro.conf с вашими привязками вертолёта на ваших джойстиках, а вы один раз выбираете его. Собственный файл переназначений игры никогда не трогается. Reforger использует не более четырёх джойстиков, поэтому JoyPro также записывает правила порядка устройств игры, которые говорят, какое устройство — джойстик 0, 1, 2 или 3.

Arma Reforger напрямую (собственные файлы привязок)
Поддержка
напрямую (собственные файлы привязок)
Команда движка
engine reforger
Файл привязок
Собственный пресет JoyPro ...\customInputConfigs\JoyPro.conf (текст Enfusion) + порядок устройств в ReforgerEngineSettings.conf
Список команд из
файлы .pak игры и её локализация
  • ✓ Импорт
  • ✓ Экспорт
  • ✗ Привязки клавиатуры
  • ✗ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ◐ Кривые осей и мёртвые зоныArma Reforger: только множитель и инверсия; без мёртвой зоны и кривой (формат неизвестен).
  • ✓ Настройки управления игры
  • ✓ Настройки Force Feedback в игре
  • ✗ Force Feedback из телеметрии
  • ✗ Запись телеметрии
  • — Виртуальный джойстик (vJoy)Arma Reforger не видит устройства vJoy (четыре запуска): экспорт пропускает привязки vJoy с предупреждением.
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ✓ Мастер настройки / Автоназначение
  • ✓ Кабины
  • ✓ Шпаргалки
  • ◐ Внутриигровой тестArma Reforger: меню настроек изучены в игре; оценённого прогона нет, экспорт в игре ещё не проверен.

Из матрицы поддержки, созданной по коду движка: все игры.

Для начинающих

#Запуск за 3 шага

  1. Настроить всё за меня
    на странице «Старт»
  2. Использовать эти кнопки
    сначала посмотрите список
  3. Записать в мою игру
    Arma Reforger должна быть закрыта

До: запустите Arma Reforger один раз и откройте Settings > Controllers. Затем закройте игру.

Затем, один раз: в игре откройте Settings > Controllers. В Joystick preset выберите JoyPro. Перезапустите игру. После последующих экспортов достаточно перезапуска.

Вы уже назначали кнопки в Arma Reforger? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить ручку работать.

#Что JoyPro делает для Arma Reforger

  • Импорт: привязки вертолёта из пресета джойстика попадают в ваш профиль вместе с множителем и инверсией.
  • Связки: одна связка — это одна функция во всех играх. «Collective» может быть одним и тем же рычагом в Reforger, Arma 3 и DCS.
  • Экспорт: JoyPro записывает JoyPro.conf только с действиями полёта вертолёта и вашими джойстиками и распределяет ваши устройства по четырём слотам джойстиков игры. Управление пехотой и техникой, клавиатура, мышь и геймпад остаются такими, как в игре.

#Импорт привязок Reforger

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

Привязки клавиатуры и модификаторы в Reforger не импортируются и не экспортируются: JoyPro управляет только вашими джойстиками.

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

Объедините одинаковую функцию ваших игр с помощью работы со связками, затем нажмите Проверить на странице «Экспорт». В обычной игре есть только вертолёты (UH-1H, Mi-8); действия самолётов появляются только с модами.

#Экспорт в Arma Reforger

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

Запустите игру и откройте Settings > Controllers. В Joystick preset выберите JoyPro (один раз), затем перезапустите игру. Список Устройства показывает ваши джойстики в слотах, которые выбрал JoyPro. Привязки пресета не отображаются в Settings > Controls: эта страница показывает только столбцы клавиатуры и геймпада.

#Что вы делаете сами в Arma Reforger

  • Выберите пресет один раз: Settings > Controllers > Joystick preset > JoyPro, затем перезапустите игру. После последующих экспортов достаточно перезапуска. Если выбрать там Controller preset для геймпада, он заменит пресет джойстика: активным может быть только один из них.
  • Запустите игру один раз и откройте Settings > Controllers перед первым экспортом. JoyPro записывает порядок устройств только в файл настроек, который игра уже сохранила; без него он нумерует ваши устройства так, как это сделала бы игра, и предупреждает.
  • Не больше четырёх джойстиков. Игра берёт первые четыре, которые после её запуска отправляют ввод; любое следующее устройство заменяет четвёртое. Если устройств больше, отключите или скройте остальные (например, с помощью HidHide), пока играете в Reforger. Режим Виртуальный джойстик может объединить ваши устройства в одно, но устройство vJoy не появилось в игре за четыре запуска.

#Частые ошибки

  • В полёте ничего не происходит: пресет JoyPro не выбран или игра не была перезапущена после экспорта.
  • Не хватает ручки: ввод отправляют больше четырёх джойстиков, или устройство ни разу не отправило ввод, пока окно игры было в фокусе. Подвигайте одну из его осей или нажмите кнопку, когда окно игры на переднем плане.
  • Два одинаковых устройства: игра различает устройства по имени, поэтому две одинаковые модели получают одно правило слота; второе не получает слота.
  • Стабильная и экспериментальная версии: у этих двух сборок разные папки настроек. JoyPro записывает порядок устройств в каждую найденную папку настроек.
Расширенные

#Файлы, которые JoyPro читает и записывает

Файл Что это
%USERPROFILE%\Documents\My Games\ArmaReforger\profile\.save\settings\customInputConfigs\JoyPro.conf Собственный пресет джойстика JoyPro (текст Enfusion): по одному блоку Action на действие вертолёта с его источниками и фильтрами джойстика
...\profile\.save\app<id>_user<steam id>\settings\ReforgerEngineSettings.conf настройки движка игры; JoyPro правит только записи JoystickOrderRule в DeviceOrderRules
...\app<id>_user<steam id>\settings\ReforgerGameSettings.conf настройки игры; JoyPro правит только режим шаг-газа для HOTAS и силу Force Feedback, если вы их задаёте
JoyPro.conf.joypro-meta.json Имена, группы и настройка осей записанных привязок от JoyPro, которые считывает следующий импорт
*.jpbak копии, сделанные до первой записи, плюс хранилище резервных копий JoyPro с версиями

Собственный файл переназначений игры InputUserSettings.conf никогда не затрагивается, как и ваши другие пресеты в customInputConfigs. В старых сборках два файла настроек называются EngineUserSettings.conf и GameUserSettings.conf (то же содержимое).

#Правила порядка устройств

Игра показывает не более четырёх джойстиков (от joystick0 до joystick3) и даёт устройству слот, когда имя правила входит в имя устройства. При экспорте JoyPro:

  1. даёт выбранным вами устройствам этот слот (настройка joystickSlot, от 0 до 3; -1 = автоматически);
  2. сохраняет слот, который устройству даёт уже существующее правило (также собственные правила игры с длинным именем);
  3. даёт остальным устройствам наименьший слот, не занятый ни одним правилом.

Каждое правило использует HID-имя продукта устройства (имя в игре его содержит). JoyPro меняет слот на месте или добавляет правило и записывает только слоты от 0 до 3. Он предупреждает, когда используется больше четырёх устройств, когда свободных слотов не осталось или когда два выбранных слота совпадают. Импорт сопоставляет joystickN обратно по тем же правилам.

#Режимы экспорта в Arma Reforger

Меняются только лётные блоки Action пресета. Источники клавиатуры, мыши и геймпада, а также неподключённые джойстики всегда остаются.

Режим Что происходит в JoyPro.conf
Только добавить Все источники остаются. Привязка, чей вход джойстика использует другое лётное действие, не записывается и получает пометку «Не записано в игру».
Обновить, привязки игры сохранить Ваши источники добавляются; источник другого лётного действия на том же входе удаляется. Старые источники действия остаются.
Обновить, мой профиль важнее Как выше, и привязанное вами действие теряет свои другие источники джойстика на подключённых устройствах.
Заменить на моих устройствах Лётные источники устройств, которые вы записываете, удаляются и заменяются вашими.
+ Очистить и другие мои устройства То же для подключённых устройств без привязок в вашем профиле.

Блок, оставшийся без источников, удаляется.

#Что никогда не затрагивается

  • InputUserSettings.conf, ваши другие пресеты и все действия пехоты, техники и меню.
  • Источники клавиатуры, мыши и геймпада; неподключённые джойстики; игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
  • Каждая строка двух файлов настроек, кроме правил порядка и двух настроек, которыми распоряжается JoyPro. Отсутствующий блок настроек не создаётся (JoyPro предупреждает: измените настройку в игре один раз).
  • Моды из Workshop не читаются.

#Вертолёты, кривые, настройки

  • Детализация: один набор привязок для всех вертолётов (контекст Helicopter игры).
  • Настройки осей: для каждой привязки множитель и инверсия, записанные как фильтр значений игры на обеих половинах оси. Мёртвые зоны и кривые Reforger для каждой оси устройства не записываются (их формат пока неизвестен).
  • Кнопки ведут себя как клавиши игры: кнопка получает тот же пресет и фильтр, что и собственный источник этого действия в игре по умолчанию (нажатие, удержание, повтор), поэтому «Engine start» удерживается, а «Sight range down» повторяется.
  • Настройки игры: режим шаг-газа для HOTAS (Default, Manual, Sticky, Direct; по умолчанию для HOTAS в игре — Direct) и сила Force Feedback (от 0 до 3); для каждого устройства — joystickSlot. Задайте их в Настройки > Настройки FFB игр (выберите Arma Reforger) или с помощью engine ffb set. Экспорт без привязок Reforger всё равно их записывает.
  • Отслеживание: изменение в пресете или в настройках игры замечается после закрытия игры; JoyPro спрашивает, перенести ли его.
  • HUD: HUD находит игру по её процессу и показывает ваши привязки Reforger.
Технические подробности

#Внутри интеграции Reforger

flowchart LR
  P["Ваш профиль<br/>(связки вертолёта)"] --> E["engine reforger export"]
  E --> J["customInputConfigs /<br/>JoyPro.conf<br/>(собственный пресет JoyPro)"]
  E --> R["ReforgerEngineSettings.conf<br/>порядок устройств: слоты от 0 до 3"]
  J --> U["Вы, один раз: Settings > Controllers<br/>> Joystick preset = JoyPro;<br/>затем перезапустите игру"]
  R --> U
Что записывает экспорт. Вы один раз выбираете пресет JoyPro в игре; после каждого экспорта достаточно перезапуска.

Код: engine\Games\ArmaReforgerIntegration.cs, engine\Games\ReforgerCatalogSource.cs, engine\Games\EnfusionPak.cs, модель осей engine\AxisModels\ArmaReforger.cs и модель настроек engine\FfbModels\ArmaReforger.cs.

  • Формат: текст Enfusion, отступ в один пробел, Key Value, объекты Class "{16 hex digits}" {; каждый новый объект получает уникальный случайный id. Входы: joystick0:button4 (с отсчётом от 0), joystick0:axis6, половины осей joystickN:axisA+ / axisA-, хатки joystickN:pov_up|pov_down|pov_left|pov_right; оси от 0 до 7 = X, Y, Z, Rx, Ry, Rz, Slider 0, Slider 1. Действие на всю ось записывается как joystickN:axisA (инвертируется отрицательным Multiplier).
  • Устройства: игра распознаёт джойстик по raw input (usage page 1, usage 4), когда он впервые отправляет отчёт, пока окно игры в фокусе; геймпады и многоосевые контроллеры здесь никогда не считаются джойстиками. Её таблица вмещает четыре записи; пятое новое устройство перезаписывает четвёртое.
  • Список команд: engine reforger refresh-db читает Configs/System/chimeraInputCommon.conf, заголовки меню из keyBindingMenu.conf и localization.en_us.conf из архивов .pak игры (только чтение), а также действия ваших пресетов; учитываются только контексты Helicopter / Airplane. engine reforger catalog выводит их список, engine reforger paths показывает найденные файлы.
  • Импорт / экспорт: engine reforger import, engine reforger scan; engine reforger export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --ignore-device <d> --dry-run.
  • Настройки: engine ffb set --device * --game ArmaReforger --param hotasCollective=<0..3> (также forceFeedbackIntensity); --device "<device>" --param joystickSlot=<0..3>; слот больше 3 отклоняется.

#Известные ограничения

  • Экспорт в запущенной игре пока не проверен; меню настроек — проверены.
  • Только множитель и инверсия; без мёртвой зоны и кривой.
  • Не более четырёх джойстиков; устройство vJoy не появилось в игре за четыре запуска, поэтому виртуальный джойстик предлагается только при более чем четырёх устройствах.
  • Заменяет ли пресет источники клавиатуры игры по умолчанию или добавляется к ним, пока не подтверждено.
  • Тесты: engine\tests\smoke\arma.ps1 (фильтр, правила порядка, настройки игры, отказы).

Все технические заметки по этой игре (созданы из репозитория): arma-reforger.md.