JoyPro2 Discord GitHub
Игры

Nuclear Option

Показать:

Nuclear Option — боевой авиасимулятор с реактивными самолётами, VTOL и вертолётами и одним набором привязок для всех ЛА. Он хранит управление не в файле, а в реестре Windows: одна карта джойстика Rewired на устройство, которую записывает Control Mapper игры. JoyPro читает эти карты в ваш профиль и записывает ваши привязки Flight Controls обратно в них; привязки камеры, игрового процесса и чата остаются как есть.

Nuclear Option напрямую (собственные файлы привязок)
Поддержка
напрямую (собственные файлы привязок)
Команда движка
engine nuclearoption
Файл привязок
реестр HKCU\Software\Shockfront\NuclearOption (XML Rewired в значениях REG_BINARY)
Список команд из
resources.assets игры
Внутриигровой тест
5/5 шагов пройдено (2026-10-10)
  • ✓ Импорт
  • ✓ Экспорт
  • ✗ Привязки клавиатуры
  • ✗ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✗ Кривые осей и мёртвые зоныNuclear Option: калибровочная мёртвая зона игры не записывается.
  • ✗ Настройки управления игры
  • ✗ Настройки Force Feedback в игре
  • ✗ Force Feedback из телеметрии
  • ✗ Запись телеметрии
  • ✓ Виртуальный джойстик (vJoy)
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ✓ Мастер настройки / Автоназначение
  • ✓ Кабины
  • ✓ Шпаргалки
  • ✓ Внутриигровой тест

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

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

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

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

До: запустите Nuclear Option один раз, затем закройте её.

Затем: ваши привязки находятся в Settings > Controls > Open Control Bindings Menu, на вкладке вашего устройства.

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

#Что JoyPro делает для Nuclear Option

  • Импорт: карты джойстиков ваших подключённых устройств попадают в ваш профиль: оси с инверсией, кнопки и кнопки на оси (например, «Increase Throttle»).
  • Связки: одна связка — это одна функция; в Nuclear Option нет списков ЛА, поэтому связка действует для всех ЛА.
  • Экспорт: JoyPro редактирует карту каждого устройства на месте, записывая только действия Flight Controls. Устройство, для которого в игре нет сохранённой карты, получает новую карту с вашими привязками.

#Импорт ваших привязок

  1. Запустите Nuclear Option один раз (чтобы появился её раздел реестра) и закройте её.
  2. Откройте Старт, нажмите Импорт на карточке Nuclear Option, затем Импортировать.

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

Создавайте связки, как для любой игры (работа со связками); мастер настройки и Автоназначение знают функции игры. Затем запустите Проверку на странице «Экспорт».

#Экспорт в Nuclear Option

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

Откройте Settings > Controls > Open Control Bindings Menu. В Control Mapper по одной вкладке на устройство: щёлкните своё устройство вверху, чтобы увидеть там ваши привязки Flight Controls (под названиями игры, например Pitch, Roll, Yaw, Throttle). Привязки камеры, игрового процесса и чата не меняются.

#Что вы делаете сами в Nuclear Option

  • Запустите игру один раз перед первым импортом или экспортом, чтобы она создала свой раздел реестра.
  • Use Throttle Axis Negative Region в настройках управления игры: оставьте включённым для полной оси РУД. JoyPro предупреждает, если параметр выключен, а ваш профиль привязывает ось РУД.
  • Хатки: пока привязывайте направления хатки в игре; JoyPro их ещё не записывает.

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

  • «Nuclear Option работает»: закройте игру и снова выполните экспорт.
  • Устройство пропущено: два подключённых устройства одной модели (или клавиатуру, которая также видна как игровой контроллер) нельзя различить в картах игры; JoyPro пропускает их с предупреждением.
  • Устройство сохраняет привязки игры по умолчанию: подключённое устройство без сохранённой карты использует карту игры по умолчанию, которую JoyPro не может прочитать; Очистить и другие мои устройства его не трогает. Привяжите на нём что-нибудь в JoyPro или один раз очистите его вкладку в Control Mapper.
  • РУД застревает в середине: проверьте Use Throttle Axis Negative Region (см. выше).
Расширенные

#Что JoyPro читает и записывает

Где Что это
HKCU\Software\Shockfront\NuclearOption Настройки игры Unity в реестре; значения Rewired двоичные (текст UTF-8 плюс один нулевой байт), имена заканчиваются на _h<hash>
по одному значению на устройство с dataType=ControllerMap и hardwareIdentifier устройства в имени карта джойстика одного устройства (Rewired XML) для игрока Player0
то же имя с dataType=ControllerMap_KnownActionIds id действий, известные карте; JoyPro записывает их вместе с новой картой
<install>\NuclearOption_Data\resources.assets список действий Rewired игры: только чтение, для списка команд
%LOCALAPPDATA%\JoyPro2\GameMetadata\HKCU_Software_Shockfront_NuclearOption.joypro-meta.json Имена, группы и настройка осей экспортированных привязок от JoyPro — для следующего импорта

Перед первой записью JoyPro делает снимок значений карт контроллеров Player0 в хранилище резервных копий; Отменить последний экспорт записывает их обратно и удаляет значения карт, добавленные JoyPro. Некоторые имена значений длиннее 255 символов, поэтому JoyPro использует API реестра (Regedit и reg export показывают не все).

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

Режим Что происходит в картах ваших устройств
Только добавить В игре ничего не меняется; привязка, чья кнопка или ось уже управляет другим действием (или другим полюсом оси), пропускается и попадает в список.
Обновить, привязки игры сохранить Действие Flight Controls на входе, который вы отдаёте другому действию, теряет этот вход; остальные входы действия остаются.
Обновить, мой профиль важнее Как выше, и каждое действие (или полюс), которое вы привязываете, теряет свои другие входы на всех подключённых устройствах, которые JoyPro может прочитать.
Заменить на моих устройствах Все остальные действия Flight Controls записанных устройств освобождаются.
+ Очистить и другие мои устройства Действия Flight Controls в остальных сохранённых картах подключённых устройств освобождаются. Устройства без сохранённой карты сохраняют карту игры по умолчанию.

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

  • Каждое действие вне Flight Controls: привязки камеры, игрового процесса, чата, отладки и редактора миссий.
  • Карты клавиатуры и мыши, карты калибровки, поведение входов, назначения контроллеров и все настройки игры (графика, ThrottleUseNegative и другие параметры управления).
  • Неподключённые устройства, два и более устройства одной модели, устройства, игнорируемые при импорте, и устройство vJoy, через которое JoyPro передаёт входы.
  • Всё в изменённой карте вне карт элементов, которые меняет JoyPro, в том числе привязки действий модов.

#Детализация, кривые, остальное

  • Детализация: глобальная, один набор привязок для всех ЛА (действие Throttle — это также шаг-газ вертолёта).
  • Кривые осей: не записываются. Мёртвая зона калибровки игры остаётся как есть.
  • Клавиатура и модификаторы: не записываются; у привязок джойстика в игре нет модификаторов.
  • Хатки: пока не читаются и не записываются. Ползунки записываются с предупреждением.
  • Force Feedback, телеметрия: нет.
  • Отслеживание: уведомление об изменении реестра для ключа игры; отпечаток охватывает только карты контроллеров Player0 (отслеживание).
  • HUD: HUD находит игру по её процессу (NuclearOption).
Технические подробности

#Внутри интеграции Nuclear Option

flowchart LR
  A["resources.assets<br/>(список действий игры,<br/>читается refresh-db)"] --> E["engine nuclearoption export<br/>(сначала снимок<br/>значений карт контроллеров)"]
  P["Ваш профиль"] --> E
  E --> R["HKCU / Software / Shockfront /<br/>NuclearOption<br/>(карта джойстика для каждого устройства)"]
  R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Игра хранит управление в реестре Windows. Перед записью JoyPro сохраняет снимок.

Код: engine\Games\NuclearOptionIntegration.cs (хранилище в реестре, особенности игры, структура каталога) поверх engine\Games\RewiredMapIntegration.cs (чтение и запись карт джойстика Rewired, общий с Tiny Combat Arena).

  • Имена значений: Unity добавляет _h<hash> к каждому ключу (djb2 с XOR по ключу в UTF-8, десятичное число).
  • Устройства: ни одно из обычных HOTAS-устройств не известно Rewired в игре, поэтому их карты имеют нулевой hardwareGuid, а hardwareIdentifier = WindowsRawInput + строка продукта HID без пробелов + PID + VID (по четыре hex-цифры, заглавными). duplicate считает устройства одной модели; JoyPro обрабатывает только одно на модель.
  • Элементы: оси X, Y, Z, Rx, Ry, Rz = от 0 до 5, ползунки 6 и 7, кнопка n = 31 + n. Кнопка на действии оси — это <Action>.Positive / .Negative (axisContribution 0 / 1). Карта игры по умолчанию привязывает Pitch, Roll, Yaw, Throttle и Brake к осям от 0 до 4 и одиннадцать кнопок.
  • Запись: меняются только затронутые блоки ActionElementMap (кнопки в <buttonMaps>, оси в <axisMaps>); у новой карты sourceMapId равен -1 и есть список известных id действий, поэтому игра не добавляет в неё привязки по умолчанию.
  • Список команд: engine nuclearoption refresh-db находит Rewired InputManager в resources.assets по его первому действию ("Pitch") и записывает DB\NuclearOption\actions.tsv (имя действия, заголовок, категория, id Rewired; действия осей получают также строки полюсов).
  • Команды: engine nuclearoption paths, engine nuclearoption catalog, engine nuclearoption scan, engine nuclearoption import, engine nuclearoption export; отмена через engine backups restore.

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

  • Устройства, которые Rewired в игре распознаёт (ненулевой hardwareGuid, например T.16000M), не обрабатываются.
  • Id элементов хаток не встречались в сохранённой карте, поэтому хатки пропускаются; id ползунков следуют общему определению Rewired.
  • Привязки проверены в меню игры, но ещё не в полёте; знак оси, который игра ожидает для Pitch, пока не подтверждён.
  • Тесты: engine\tests\smoke\nuclearoption.ps1 (настоящая карта vJoy плюс привязки камеры и игрового процесса); в игре tools\e2e\games\NuclearOptionSettings.ps1 (Pitch, Roll и Yaw на случайных осях vJoy видны на вкладке vJoy в Control Mapper, а импорт после нового сохранения игры читает их обратно).

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