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: каліброўкавая мёртвая зона гульні не запісваецца.
- ✗ Налады кіравання ў гульні
- ✗ Налады зваротнай сувязі па сіле ў гульні
- ✗ Зваротная сувязь па сіле з тэлеметрыі
- ✗ Запіс тэлеметрыі
- ✓ Віртуальны 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 папярэджвае, калі гэта выключана, а ваш профіль прывязвае вось РУД.
- Hat: пакуль прывязвайце кірункі Hat у гульні; 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 |
ідэнтыфікатары дзеянняў, вядомыя карце; 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 таксама з'яўляецца collective верталёта).
- Крывыя восей: не запісваюцца. Мёртвая зона каліброўкі гульні застаецца як ёсць.
- Клавіятура і мадыфікатары: не запісваюцца; прывязкі джойсціка ў гульні не маюць мадыфікатараў.
- Hat: пакуль не чытаюцца і не запісваюцца. Паўзункі запісваюцца з папярэджаннем.
- Зваротная сувязь па сіле, тэлеметрыя: няма.
- Назіральнік: апавяшчэнне пра змену рэестра на ключы гульні; адбітак ахоплівае толькі карты кантролераў 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 (па чатыры шаснаццатковыя лічбы, вялікімі літарамі).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), не апрацоўваюцца. - Ідэнтыфікатары элементаў Hat не сустракаліся ў захаванай карце, таму Hat прапускаюцца; ідэнтыфікатары паўзункоў ідуць за агульным вызначэннем Rewired.
- Прывязкі правераны ў меню гульні, але яшчэ не ў палёце; знак восі, які гульня чакае для Pitch, яшчэ не пацверджаны.
- Тэсты:
engine\tests\smoke\nuclearoption.ps1(сапраўдная карта vJoy плюс прывязкі камеры і геймплэя); у гульніtools\e2e\games\NuclearOptionSettings.ps1(Pitch, Roll і Yaw на выпадковых восях vJoy паказваюцца на ўкладцы vJoy у Control Mapper, а імпарт пасля новага захавання ў гульні счытвае іх назад).
Усе тэхнічныя нататкі пра гэту гульню (створаны з рэпазіторыя): nuclear-option.md.