Nuclear Option — бойова льотна гра з реактивними літаками, VTOL і гелікоптерами та одним набором прив'язок для всіх літальних апаратів. Вона зберігає керування не у файлі, а в реєстрі Windows: одна карта joystick 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 з телеметрії
- ✗ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✓ Внутрішньоігровий тест
З матриці підтримки, створеної з коду рушія: усі ігри.
#Запуск за 3 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
Nuclear Option має бути закрита
До: один раз запустіть Nuclear Option, потім закрийте її.
Потім: ваші прив'язки є в Settings > Controls > Open Control Bindings Menu, на вкладці вашого пристрою.
Ви вже прив'язували кнопки в Nuclear Option? Тоді сторінка «Початок» запропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаться, а нові завдання отримають лише вільні кнопки. Див. Швидкий старт: як змусити ручку працювати.
#Що JoyPro робить для Nuclear Option
- Імпорт: карти joystick ваших підключених пристроїв потрапляють у ваш профіль: осі з інверсією, кнопки та кнопки на осі (наприклад, «Increase Throttle»).
- Зв'язки: один зв'язок — це одна функція; Nuclear Option не має списків літаків, тож зв'язок діє для всіх літаків.
- Експорт: JoyPro редагує карту кожного пристрою на місці, лише дії Flight Controls, які він записує. Пристрій, для якого гра не має збереженої карти, отримує нову карту з вашими прив'язками.
#Імпорт ваших прив'язок
- Один раз запустіть Nuclear Option (щоб з'явився її ключ реєстру) і закрийте її.
- Відкрийте Початок, натисніть Імпорт на картці Nuclear Option, потім Імпортувати зараз.
#Створення й перевірка зв'язків
Створюйте зв'язки, як для кожної гри (процес зв'язків); майстер налаштування й Auto Assign знають функції гри. Потім запустіть Перевірку на сторінці «Експорт».
#Експорт у 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 пристрою в імені |
карта joystick одного пристрою (Rewired XML) для гравця Player0 |
те саме ім'я з dataType=ControllerMap_KnownActionIds |
ідентифікатори дій, які знає карта; 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 — це також колективний крок гелікоптера).
- Криві осей: не записуються. Мертва зона калібрування гри залишається як є.
- Клавіатура й модифікатори: не записуються; прив'язки joystick у грі не мають модифікаторів.
- Хети: поки що не читаються й не записуються. Повзунки записуються з попередженням.
- 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/>(карта joystick на кожен пристрій)"] R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Код: engine\Games\NuclearOptionIntegration.cs (сховище в реєстрі, особливості гри, структура каталогу) поверх engine\Games\RewiredMapIntegration.cs (читання й запис карт joystick Rewired, спільне з Tiny Combat Arena).
- Імена значень: Unity додає
_h<hash>до кожного ключа (djb2 з XOR над ключем у UTF-8, десяткове). - Пристрої: жоден зі звичних пристроїв HOTAS не відомий Rewired гри, тому їхні карти мають нульовий
hardwareGuidіhardwareIdentifier=WindowsRawInput+ рядок продукту HID без пробілів + PID + VID (по чотири шістнадцяткові цифри, великими літерами).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 і список відомих ідентифікаторів дій, тож гра не додає до неї стандартних прив'язок. - Список команд:
engine nuclearoption refresh-dbзнаходить Rewired InputManager уresources.assetsза його першою дією ("Pitch") і записуєDB\NuclearOption\actions.tsv(назва дії, заголовок, категорія, ідентифікатор Rewired; дії осей також отримують рядки полюсів). - Команди:
engine nuclearoption paths,engine nuclearoption catalog,engine nuclearoption scan,engine nuclearoption import,engine nuclearoption export; скасування черезengine backups restore.
#Відомі обмеження
- Пристрої, які Rewired гри розпізнає (ненульовий
hardwareGuid, наприклад T.16000M), не обробляються. - Ідентифікатори елементів хета не траплялися в збереженій карті, тому хети пропускаються; ідентифікатори повзунків відповідають загальному визначенню Rewired.
- Прив'язки перевірено в меню гри, але ще не в польоті; знак осі, якого гра очікує для Pitch, ще не підтверджено.
- Тести:
engine\tests\smoke\nuclearoption.ps1(справжня карта vJoy плюс прив'язки камери й ігрового процесу); у гріtools\e2e\games\NuclearOptionSettings.ps1(Pitch, Roll і Yaw на випадкових осях vJoy показуються на вкладці vJoy у Control Mapper, а імпорт після повторного збереження грою читає їх назад).
Усі технічні примітки до цієї гри (створено з репозиторію): nuclear-option.md.