JoyPro2 Discord GitHub
Ігри

Nuclear Option

Показати:

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 кроки

  1. Налаштувати все за мене
    на сторінці «Початок»
  2. Використати ці кнопки
    спершу перегляньте список
  3. Записати в мою гру
    Nuclear Option має бути закрита

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

Потім: ваші прив'язки є в Settings > Controls > Open Control Bindings Menu, на вкладці вашого пристрою.

Ви вже прив'язували кнопки в Nuclear Option? Тоді сторінка «Початок» запропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаться, а нові завдання отримають лише вільні кнопки. Див. Швидкий старт: як змусити ручку працювати.

#Що JoyPro робить для Nuclear Option

  • Імпорт: карти joystick ваших підключених пристроїв потрапляють у ваш профіль: осі з інверсією, кнопки та кнопки на осі (наприклад, «Increase Throttle»).
  • Зв'язки: один зв'язок — це одна функція; Nuclear Option не має списків літаків, тож зв'язок діє для всіх літаків.
  • Експорт: JoyPro редагує карту кожного пристрою на місці, лише дії Flight Controls, які він записує. Пристрій, для якого гра не має збереженої карти, отримує нову карту з вашими прив'язками.

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

  1. Один раз запустіть Nuclear Option (щоб з'явився її ключ реєстру) і закрийте її.
  2. Відкрийте Початок, натисніть Імпорт на картці Nuclear Option, потім Імпортувати зараз.

#Створення й перевірка зв'язків

Створюйте зв'язки, як для кожної гри (процес зв'язків); майстер налаштування й Auto Assign знають функції гри. Потім запустіть Перевірку на сторінці «Експорт».

#Експорт у 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 пристрою в імені карта 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"]
Гра зберігає своє керування в реєстрі Windows. JoyPro зберігає знімок перед записом.

Код: 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 (axisContribution 0 / 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.