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 шага
- Настроить всё за меня
на странице «Старт» - Использовать эти кнопки
сначала посмотрите список - Записать в мою игру
Nuclear Option должна быть закрыта
До: запустите Nuclear Option один раз, затем закройте её.
Затем: ваши привязки находятся в Settings > Controls > Open Control Bindings Menu, на вкладке вашего устройства.
Вы уже назначали кнопки в Nuclear Option? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить ручку работать.
#Что JoyPro делает для Nuclear Option
- Импорт: карты джойстиков ваших подключённых устройств попадают в ваш профиль: оси с инверсией, кнопки и кнопки на оси (например, «Increase Throttle»).
- Связки: одна связка — это одна функция; в Nuclear Option нет списков ЛА, поэтому связка действует для всех ЛА.
- Экспорт: JoyPro редактирует карту каждого устройства на месте, записывая только действия Flight Controls. Устройство, для которого в игре нет сохранённой карты, получает новую карту с вашими привязками.
#Импорт ваших привязок
- Запустите Nuclear Option один раз (чтобы появился её раздел реестра) и закройте её.
- Откройте Старт, нажмите Импорт на карточке Nuclear Option, затем Импортировать.
#Создание и проверка связок
Создавайте связки, как для любой игры (работа со связками); мастер настройки и Автоназначение знают функции игры. Затем запустите Проверку на странице «Экспорт».
#Экспорт в Nuclear Option
- Закройте Nuclear Option. JoyPro отказывается записывать, пока она работает: игра записывает свои карты при закрытии меню привязок и при отключении устройства.
- Откройте Экспорт, оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства и нажмите Экспортировать на карточке 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"]
Код: 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(axisContribution0 / 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.