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: каліброўкавая мёртвая зона гульні не запісваецца.
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✗ Запіс тэлеметрыі
  • ✓ Віртуальны 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 папярэджвае, калі гэта выключана, а ваш профіль прывязвае вось РУД.
  • 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"]
Гульня захоўвае сваё кіраванне ў рэестры 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 (па чатыры шаснаццатковыя лічбы, вялікімі літарамі). 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), не апрацоўваюцца.
  • Ідэнтыфікатары элементаў 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.