Nuclear Option is een luchtgevechtgame met jets, VTOL's en helikopters en één set toewijzingen voor elk toestel. De game bewaart zijn bediening niet in een bestand maar in het Windows-register: één Rewired-joystickmap per apparaat, geschreven door de Control Mapper van de game. JoyPro leest deze maps in je profiel en schrijft je Flight Controls-toewijzingen erin terug; toewijzingen voor camera, gameplay en chat blijven zoals ze zijn.
Nuclear Option rechtstreeks (eigen toewijzingsbestanden)
- Ondersteuning
- rechtstreeks (eigen toewijzingsbestanden)
- Engine-commando
engine nuclearoption- Toewijzingsbestand
- register
HKCU\Software\Shockfront\NuclearOption(Rewired-XML in REG_BINARY-waarden) - Commandolijst uit
resources.assetsvan de game- In-game test
- 5/5 stappen geslaagd (2026-10-10)
- ✓ Importeren
- ✓ Exporteren
- ✗ Toetsenbordtoewijzingen
- ✗ Modifiers
- ✓ Commandolijst gemaakt op je pc
- ✓ Gamebewaking
- ✗ Ascurves en dode zonesNuclear Option: de kalibratie-dode-zone van de game wordt niet geschreven.
- ✗ Bedieningsinstellingen van de game
- ✗ Force-feedbackinstellingen in de game
- ✗ Force feedback uit telemetrie
- ✗ Telemetrie-opname
- ✓ Virtuele joystick (vJoy)
- ◐ Virtuele Xbox-pad
- ✓ Virtuele functies
- ✓ Installatiewizard / Automatisch toewijzen
- ✓ Cockpits
- ✓ Spiekbrieven
- ✓ In-game test
Uit de ondersteuningstabel, gegenereerd uit de code van de engine: alle games.
#In 3 stappen aan de slag
- Alles voor me instellen
op de startpagina - Deze knoppen gebruiken
bekijk eerst de lijst - Naar mijn game schrijven
houd Nuclear Option gesloten
Vooraf: start Nuclear Option één keer en sluit de game dan.
Daarna: je toewijzingen staan in Settings > Controls > Open Control Bindings Menu, op het tabblad van je apparaat.
Heb je eerder knoppen toegewezen in Nuclear Option? Dan biedt de startpagina Importeren, dan gaten vullen aan. Je toewijzingen blijven, en alleen vrije knoppen krijgen nieuwe taken. Zie Snelstart: mijn stick laten werken.
#Wat JoyPro doet voor Nuclear Option
- Importeren: de joystickmaps van je aangesloten apparaten komen in je profiel: assen met hun omkeren, knoppen, en knoppen op een as (bijvoorbeeld "Increase Throttle").
- Relaties: één relatie is één functie; Nuclear Option heeft geen toestellenlijsten, dus een relatie geldt voor elk toestel.
- Exporteren: JoyPro bewerkt de map van elk apparaat ter plekke, alleen de acties van Flight Controls die het schrijft. Een apparaat waarvoor de game geen opgeslagen map heeft, krijgt een nieuwe map met je toewijzingen.
#Je toewijzingen importeren
- Start Nuclear Option één keer (zodat de registersleutel bestaat) en sluit de game.
- Open Start, druk op Importeren op de kaart van Nuclear Option en dan op Nu importeren.
#Relaties maken en controleren
Maak relaties zoals voor elke game (werkwijze voor relaties); de installatiewizard en Automatisch toewijzen kennen de functies van de game. Voer dan de controle uit op de pagina Exporteren.
#Exporteren naar Nuclear Option
- Sluit Nuclear Option. JoyPro weigert te schrijven zolang de game draait: de game schrijft zijn maps als het toewijzingsmenu sluit en als een apparaat wordt losgekoppeld.
- Open Exporteren, laat Vervangen op mijn apparaten met Ook mijn andere apparaten wissen staan en druk op Nu exporteren op de kaart van Nuclear Option.


Open Settings > Controls > Open Control Bindings Menu. De Control Mapper heeft één tabblad per apparaat: klik bovenaan op je apparaat om daar je Flight Controls-toewijzingen te zien (met de namen van de game, bijvoorbeeld Pitch, Roll, Yaw, Throttle). Toewijzingen voor camera, gameplay en chat zijn ongewijzigd.
#Wat je zelf doet in Nuclear Option
- Start de game één keer vóór de eerste import of export, zodat hij zijn registersleutel maakt.
- Use Throttle Axis Negative Region in de bediening van de game: laat dit aan voor een volle throttle-as. JoyPro waarschuwt als het uit staat en je profiel een throttle-as toewijst.
- Hats: wijs hatrichtingen voorlopig in de game toe; JoyPro schrijft ze nog niet.
#Veelgemaakte fouten
- "Nuclear Option draait": sluit de game en exporteer opnieuw.
- Een apparaat wordt overgeslagen: twee aangesloten apparaten van hetzelfde model (of een toetsenbord dat ook als gamecontroller verschijnt) zijn in de maps van de game niet uit elkaar te houden; JoyPro laat ze weg met een waarschuwing.
- Een apparaat houdt de standaardtoewijzingen van de game: een aangesloten apparaat waarvoor de game geen opgeslagen map heeft, gebruikt de standaardmap van de game, die JoyPro niet kan lezen; Ook mijn andere apparaten wissen laat het met rust. Wijs er in JoyPro iets op toe, of wis het tabblad ervan één keer in de Control Mapper.
- Throttle blijft in het midden hangen: controleer Use Throttle Axis Negative Region (zie hierboven).
#Wat JoyPro leest en schrijft
| Waar | Wat het is |
|---|---|
HKCU\Software\Shockfront\NuclearOption |
De Unity-instellingen van de game in het register; de Rewired-waarden zijn binair (UTF-8-tekst plus één nulbyte), namen eindigen op _h<hash> |
een waarde per apparaat met dataType=ControllerMap en de hardwareIdentifier van het apparaat in de naam |
de joystickmap van één apparaat (Rewired-XML), voor de speler Player0 |
dezelfde naam met dataType=ControllerMap_KnownActionIds |
de actie-id's die de map kent; JoyPro schrijft die samen met een nieuwe map |
<install>\NuclearOption_Data\resources.assets |
de Rewired-actielijst van de game: alleen gelezen, voor de commandolijst |
%LOCALAPPDATA%\JoyPro2\GameMetadata\HKCU_Software_Shockfront_NuclearOption.joypro-meta.json |
de namen, groepen en afstelling van JoyPro voor de geëxporteerde toewijzingen, voor de volgende import |
Voor de eerste schrijfactie zet JoyPro een momentopname van de controllermap-waarden van Player0 in de back-upopslag; Laatste export ongedaan maken schrijft ze terug en verwijdert map-waarden die JoyPro heeft toegevoegd. Sommige waardenamen zijn langer dan 255 tekens, daarom gebruikt JoyPro de register-API (Regedit en reg export tonen ze niet allemaal).
#De exportmodi in Nuclear Option
| Modus | Wat er in de maps van je apparaten gebeurt |
|---|---|
| Alleen toevoegen | Er verandert niets aan de game; een toewijzing waarvan de knop of as al een andere actie bestuurt (of de andere richting van een as), wordt weggelaten en vermeld. |
| Bijwerken, toewijzingen van game behouden | Een Flight Controls-actie op een input die je aan een andere actie geeft, raakt die input kwijt; de actie houdt haar andere inputs. |
| Bijwerken, mijn profiel wint | Zoals hierboven, en elke actie (of richting) die je toewijst, verlaat haar andere inputs, op elk aangesloten apparaat dat JoyPro kan lezen. |
| Vervangen op mijn apparaten | Elke andere Flight Controls-actie van de geschreven apparaten wordt vrijgemaakt. |
| + Ook mijn andere apparaten wissen | De Flight Controls-acties van de andere opgeslagen maps van aangesloten apparaten worden vrijgemaakt. Apparaten zonder opgeslagen map houden de standaardmap van de game. |
#Wat nooit wordt aangeraakt
- Elke actie buiten Flight Controls: toewijzingen voor camera, gameplay, chat, debug en missie-editor.
- Maps voor toetsenbord en muis, de kalibratiemaps, inputgedrag, de controllertoewijzingen en elke game-instelling (graphics,
ThrottleUseNegativeen de andere bedieningsopties). - Apparaten die niet aangesloten zijn, twee of meer apparaten van één model, de apparaten die de import negeert en het vJoy-apparaat waar JoyPro naartoe doorstuurt.
- Alles van een bewerkte map buiten de elementmaps die JoyPro wijzigt, ook toewijzingen van mod-acties.
#Granulariteit, curves, de rest
- Granulariteit: globaal, één set toewijzingen voor elk toestel (de Throttle-actie is ook de collective van de helikopter).
- As-curves: niet geschreven. De dode zone uit de kalibratie van de game blijft zoals hij is.
- Toetsenbord en modifiers: niet geschreven; de joysticktoewijzingen van de game hebben geen modifiers.
- Hats: nog niet gelezen of geschreven. Schuifregelaars worden met een waarschuwing geschreven.
- Force feedback, telemetrie: geen.
- Gamebewaking: een melding van een registerwijziging op de sleutel van de game; de vingerafdruk dekt alleen de controllermaps van Player0 (de gamebewaking).
- HUD: de HUD vindt de game aan zijn proces (
NuclearOption).
#De Nuclear Option-integratie van binnen
flowchart LR A["resources.assets<br/>(de actielijst van de game,<br/>gelezen door refresh-db)"] --> E["engine nuclearoption export<br/>(eerst een momentopname van<br/>de controllermap-waarden)"] P["Je profiel"] --> E E --> R["HKCU / Software / Shockfront /<br/>NuclearOption<br/>(een joystickmap per apparaat)"] R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Code: engine\Games\NuclearOptionIntegration.cs (de registeropslag, de eigenaardigheden van de game, de opbouw van de catalogus) bovenop engine\Games\RewiredMapIntegration.cs (Rewired-joystickmaps lezen en schrijven, gedeeld met Tiny Combat Arena).
- Waardenamen: Unity plakt
_h<hash>achter elke sleutel (djb2 met XOR over de UTF-8-sleutel, decimaal). - Apparaten: geen van de gangbare HOTAS-apparaten is bekend bij Rewired in de game, dus hun maps hebben een
hardwareGuidvan nul enhardwareIdentifier=WindowsRawInput+ HID-productnaam zonder spaties + PID + VID (elk vier hexcijfers, hoofdletters).duplicatetelt apparaten van één model; JoyPro behandelt er maar één per model. - Elementen: assen X, Y, Z, Rx, Ry, Rz = 0 tot 5, schuifregelaars 6 en 7, knop n = 31 + n. Een knop op een asactie is
<Action>.Positive/.Negative(axisContribution0 / 1). De standaardmap van de game wijst Pitch, Roll, Yaw, Throttle en Brake toe op assen 0 tot 4, plus elf knoppen. - Schrijven: alleen de geraakte
ActionElementMap-blokken veranderen (knoppen in<buttonMaps>, assen in<axisMaps>); een nieuwe map heeftsourceMapId-1 en de lijst met bekende actie-id's, zodat de game er geen standaardtoewijzingen aan toevoegt. - Commandolijst:
engine nuclearoption refresh-dbvindt de Rewired-InputManager inresources.assetsaan zijn eerste actie ("Pitch") en schrijftDB\NuclearOption\actions.tsv(actienaam, titel, categorie, Rewired-id; asacties krijgen ook rijen per richting). - Commando's:
engine nuclearoption paths,engine nuclearoption catalog,engine nuclearoption scan,engine nuclearoption import,engine nuclearoption export; ongedaan maken metengine backups restore.
#Bekende beperkingen
- Apparaten die Rewired in de game herkent (een
hardwareGuiddie niet nul is, bijvoorbeeld een T.16000M), worden niet behandeld. - Element-id's voor hats zijn in geen enkele opgeslagen map gezien, dus hats worden overgeslagen; de id's van schuifregelaars volgen de algemene definitie van Rewired.
- Toewijzingen zijn gecontroleerd in het menu van de game, nog niet in de vlucht; het asteken dat de game voor Pitch verwacht, is nog niet bevestigd.
- Tests:
engine\tests\smoke\nuclearoption.ps1(een echte vJoy-map plus toewijzingen voor camera en gameplay); in de gametools\e2e\games\NuclearOptionSettings.ps1(Pitch, Roll en Yaw op willekeurige vJoy-assen verschijnen op het vJoy-tabblad van de Control Mapper, en een import nadat de game opnieuw heeft opgeslagen, leest ze terug).
Alle technische notities over deze game (gegenereerd uit de repository): nuclear-option.md.