Nuclear Option to gra o walce powietrznej z odrzutowcami, maszynami VTOL i śmigłowcami oraz jednym zestawem przypisań dla każdej maszyny. Trzyma sterowanie nie w pliku, lecz w rejestrze Windows: jedna mapa joysticka Rewired na urządzenie, zapisywana przez Control Mapper gry. JoyPro wczytuje te mapy do Twojego profilu i zapisuje w nich z powrotem Twoje przypisania Flight Controls; przypisania kamery, rozgrywki i czatu zostają bez zmian.
Nuclear Option natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine nuclearoption- Plik przypisań
- rejestr
HKCU\Software\Shockfront\NuclearOption(XML Rewired w wartościach REG_BINARY) - Lista poleceń z
resources.assetsgry- Test w grze
- 5/5 kroków zaliczonych (2026-10-10)
- ✓ Importuj
- ✓ Eksportuj
- ✗ Przypisania klawiatury
- ✗ Modyfikatory
- ✓ Lista poleceń budowana na Twoim PC
- ✓ Obserwator gier
- ✗ Krzywe osi i martwe strefyNuclear Option: martwa strefa kalibracji gry nie jest zapisywana.
- ✗ Ustawienia sterowania w grze
- ✗ Ustawienia force feedback w grze
- ✗ Force feedback z telemetrii
- ✗ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ✓ Kreator konfiguracji / Autoprzypisanie
- ✓ Kokpity
- ✓ Ściągi
- ✓ Test w grze
Z macierzy obsługi, wygenerowanej z kodu silnika: wszystkie gry.
#Uruchom to w 3 krokach
- Ustaw wszystko za mnie
na stronie Start - Użyj tych przycisków
najpierw obejrzyj listę - Zapisz w mojej grze
Nuclear Option musi być zamknięte
Przed: uruchom Nuclear Option raz, potem go zamknij.
Potem: Twoje przypisania są w Settings > Controls > Open Control Bindings Menu, na karcie Twojego urządzenia.
Przypisywałeś już przyciski w Nuclear Option? Wtedy strona Start zaproponuje Importuj, potem wypełnij luki. Twoje przypisania zostają, a nowe zadania dostają tylko wolne przyciski. Zobacz Szybki start: niech mój drążek działa.
#Co JoyPro robi dla Nuclear Option
- Importuj: mapy joysticka Twoich podłączonych urządzeń trafiają do Twojego profilu: osie z odwróceniem, przyciski i przyciski na osi (na przykład „Increase Throttle”).
- Relacje: jedna relacja to jedna funkcja; Nuclear Option nie ma list maszyn, więc relacja obowiązuje dla każdej maszyny.
- Eksportuj: JoyPro edytuje mapę każdego urządzenia w miejscu, tylko akcje Flight Controls, które zapisuje. Urządzenie, dla którego gra nie ma zapisanej mapy, dostaje nową mapę z Twoimi przypisaniami.
#Zaimportuj swoje przypisania
- Uruchom Nuclear Option raz (żeby istniał jego klucz rejestru) i go zamknij.
- Otwórz Start, naciśnij Importuj na karcie Nuclear Option, potem Importuj teraz.
#Buduj i sprawdzaj relacje
Buduj relacje jak w każdej grze (przebieg relacji); kreator konfiguracji i Autoprzypisanie znają funkcje tej gry. Potem uruchom sprawdzanie na stronie Eksport.
#Eksport do Nuclear Option
- Zamknij Nuclear Option. JoyPro odmawia zapisu, dopóki gra działa: gra zapisuje swoje mapy, gdy zamyka się menu przypisań i gdy odłączysz urządzenie.
- Otwórz Eksportuj, zostaw Zastąp na moich urządzeniach razem z Wyczyść też moje inne urządzenia i naciśnij Eksportuj teraz na karcie Nuclear Option.


Otwórz Settings > Controls > Open Control Bindings Menu. Control Mapper ma jedną kartę na urządzenie: kliknij u góry swoje urządzenie, żeby zobaczyć tam swoje przypisania Flight Controls (pod nazwami z gry, na przykład Pitch, Roll, Yaw, Throttle). Przypisania kamery, rozgrywki i czatu są bez zmian.
#Co robisz sam w Nuclear Option
- Uruchom grę raz przed pierwszym importem lub eksportem, żeby utworzyła swój klucz rejestru.
- Use Throttle Axis Negative Region w ustawieniach sterowania gry: zostaw to włączone dla pełnej osi przepustnicy. JoyPro ostrzega, gdy jest wyłączone, a Twój profil przypisuje oś przepustnicy.
- Haty: na razie przypisuj kierunki hatów w grze; JoyPro jeszcze ich nie zapisuje.
#Częste pułapki
- „Nuclear Option działa”: zamknij grę i wyeksportuj ponownie.
- Urządzenie zostało pominięte: dwóch podłączonych urządzeń tego samego modelu (albo klawiatury, która pokazuje się też jako kontroler gier) nie da się rozróżnić w mapach gry; JoyPro pomija je z ostrzeżeniem.
- Urządzenie zachowuje domyślne przypisania gry: podłączone urządzenie, dla którego gra nie ma zapisanej mapy, używa domyślnej mapy gry, której JoyPro nie potrafi odczytać; Wyczyść też moje inne urządzenia zostawia je w spokoju. Przypisz na nim coś w JoyPro albo raz wyczyść jego kartę w Control Mapper.
- Przepustnica utknęła na środku: sprawdź Use Throttle Axis Negative Region (patrz wyżej).
#Co JoyPro czyta i zapisuje
| Gdzie | Co to jest |
|---|---|
HKCU\Software\Shockfront\NuclearOption |
ustawienia gry w Unity w rejestrze; wartości Rewired są binarne (tekst UTF-8 plus jeden bajt zerowy), nazwy kończą się na _h<hash> |
jedna wartość na urządzenie z dataType=ControllerMap i hardwareIdentifier urządzenia w nazwie |
mapa joysticka jednego urządzenia (Rewired XML) dla gracza Player0 |
ta sama nazwa z dataType=ControllerMap_KnownActionIds |
ID akcji znane mapie; JoyPro zapisuje ją razem z nową mapą |
<install>\NuclearOption_Data\resources.assets |
lista akcji Rewired gry: tylko do odczytu, dla listy poleceń |
%LOCALAPPDATA%\JoyPro2\GameMetadata\HKCU_Software_Shockfront_NuclearOption.joypro-meta.json |
nazwy, grupy i strojenie eksportowanych przypisań w JoyPro, na potrzeby następnego importu |
Przed pierwszym zapisem JoyPro robi migawkę wartości map kontrolerów gracza Player0 w magazynie kopii zapasowych; Cofnij ostatni eksport zapisuje je z powrotem i usuwa wartości map dodane przez JoyPro. Niektóre nazwy wartości mają ponad 255 znaków, więc JoyPro używa API rejestru (Regedit i reg export nie pokazują ich wszystkich).
#Tryby eksportu w Nuclear Option
| Tryb | Co dzieje się w mapach Twoich urządzeń |
|---|---|
| Tylko dodaj | Nic w grze się nie zmienia; przypisanie, którego przycisk lub oś już steruje inną akcją (albo drugim biegunem osi), zostaje pominięte i wymienione na liście. |
| Aktualizuj, zachowaj przypisania gry | Akcja Flight Controls na wejściu, które dajesz innej akcji, traci je; akcja zachowuje swoje pozostałe wejścia. |
| Aktualizuj, wygrywa mój profil | Jak wyżej, a dodatkowo każda przypisana przez Ciebie akcja (lub biegun) traci swoje pozostałe wejścia na każdym podłączonym urządzeniu, które JoyPro potrafi odczytać. |
| Zastąp na moich urządzeniach | Każda inna akcja Flight Controls zapisanych urządzeń zostaje zwolniona. |
| + Wyczyść też moje inne urządzenia | Akcje Flight Controls w innych zapisanych mapach podłączonych urządzeń zostają zwolnione. Urządzenia bez zapisanej mapy zachowują domyślną mapę gry. |
#Co nigdy nie jest ruszane
- Każda akcja poza Flight Controls: przypisania kamery, rozgrywki, czatu, debugowania i edytora misji.
- Mapy klawiatury i myszy, mapy kalibracji, zachowania wejść, przydziały kontrolerów i każde ustawienie gry (grafika,
ThrottleUseNegativei pozostałe opcje sterowania). - Urządzenia, które nie są podłączone, dwa lub więcej urządzeń jednego modelu, urządzenia ignorowane przy imporcie i urządzenie vJoy, do którego JoyPro przekazuje wejścia.
- Wszystko w edytowanej mapie poza mapami elementów zmienianymi przez JoyPro, także przypisania akcji z modów.
#Szczegółowość, krzywe, reszta
- Szczegółowość: globalna, jeden zestaw przypisań dla każdej maszyny (akcja Throttle jest też kolektywem śmigłowca).
- Krzywe osi: nie są zapisywane. Martwa strefa kalibracji gry zostaje bez zmian.
- Klawiatura i modyfikatory: nie są zapisywane; przypisania joysticka w grze nie mają modyfikatorów.
- Haty: jeszcze nie są odczytywane ani zapisywane. Suwaki są zapisywane z ostrzeżeniem.
- Force feedback, telemetria: brak.
- Obserwator: powiadomienie o zmianie w rejestrze dla klucza gry; odcisk obejmuje tylko mapy kontrolerów gracza Player0 (obserwator).
- HUD: HUD rozpoznaje grę po jej procesie (
NuclearOption).
#Wewnątrz integracji Nuclear Option
flowchart LR A["resources.assets<br/>(lista akcji gry,<br/>czytana przez refresh-db)"] --> E["engine nuclearoption export<br/>(najpierw migawka<br/>wartości map kontrolerów)"] P["Twój profil"] --> E E --> R["HKCU / Software / Shockfront /<br/>NuclearOption<br/>(mapa joysticka dla każdego urządzenia)"] R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Kod: engine\Games\NuclearOptionIntegration.cs (magazyn w rejestrze, specyfika gry, układ katalogu) na bazie engine\Games\RewiredMapIntegration.cs (odczyt i zapis map joysticka Rewired, wspólny z Tiny Combat Arena).
- Nazwy wartości: Unity dopisuje
_h<hash>do każdego klucza (djb2 z XOR po kluczu UTF-8, dziesiętnie). - Urządzenia: żadne z typowych urządzeń HOTAS nie jest znane Rewired w grze, więc ich mapy mają zerowy
hardwareGuid, ahardwareIdentifier=WindowsRawInput+ nazwa produktu HID bez spacji + PID + VID (po cztery cyfry hex, wielkimi literami).duplicateliczy urządzenia jednego modelu; JoyPro obsługuje tylko jedno na model. - Elementy: osie X, Y, Z, Rx, Ry, Rz = 0 do 5, suwaki 6 i 7, przycisk n = 31 + n. Przycisk na akcji osi to
<Action>.Positive/.Negative(axisContribution0 / 1). Domyślna mapa gry przypisuje Pitch, Roll, Yaw, Throttle i Brake do osi 0 do 4 oraz jedenaście przycisków. - Zapis: zmieniają się tylko dotknięte bloki
ActionElementMap(przyciski w<buttonMaps>, osie w<axisMaps>); nowa mapa masourceMapId-1 i listę znanych ID akcji, więc gra nie dodaje do niej domyślnych przypisań. - Lista poleceń:
engine nuclearoption refresh-dbznajduje Rewired InputManager wresources.assetspo jego pierwszej akcji ("Pitch") i zapisujeDB\NuclearOption\actions.tsv(nazwa akcji, tytuł, kategoria, ID Rewired; akcje osi dostają też wiersze biegunów). - Polecenia:
engine nuclearoption paths,engine nuclearoption catalog,engine nuclearoption scan,engine nuclearoption import,engine nuclearoption export; cofanie przezengine backups restore.
#Znane ograniczenia
- Urządzenia, które Rewired w grze rozpoznaje (niezerowy
hardwareGuid, na przykład T.16000M), nie są obsługiwane. - ID elementów hatów nie pojawiły się w żadnej zapisanej mapie, więc haty są pomijane; ID suwaków wynikają z ogólnej definicji Rewired.
- Przypisania sprawdzono w menu gry, ale jeszcze nie w locie; znak osi, którego gra oczekuje dla Pitch, nie jest jeszcze potwierdzony.
- Testy:
engine\tests\smoke\nuclearoption.ps1(prawdziwa mapa vJoy plus przypisania kamery i rozgrywki); w grzetools\e2e\games\NuclearOptionSettings.ps1(Pitch, Roll i Yaw na losowych osiach vJoy pojawiają się na karcie vJoy w Control Mapper, a import po ponownym zapisie gry odczytuje je z powrotem).
Wszystkie notatki techniczne o tej grze (wygenerowane z repozytorium): nuclear-option.md.