JoyPro2 Discord GitHub
Games

Nuclear Option

Tonen:

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.assets van 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.

Voor beginners

#In 3 stappen aan de slag

  1. Alles voor me instellen
    op de startpagina
  2. Deze knoppen gebruiken
    bekijk eerst de lijst
  3. 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

  1. Start Nuclear Option één keer (zodat de registersleutel bestaat) en sluit de game.
  2. 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

  1. 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.
  2. 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.
De pagina ExporterenDe pagina Exporteren
De pagina Exporteren (De afbeeldingen tonen de app in het Engels.)
In de game: Wat je ziet in 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).
Geavanceerd

#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, ThrottleUseNegative en 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).
Technische details

#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"]
De game bewaart zijn bediening in het Windows-register. JoyPro slaat een momentopname op voordat het schrijft.

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 hardwareGuid van nul en hardwareIdentifier = WindowsRawInput + HID-productnaam zonder spaties + PID + VID (elk vier hexcijfers, hoofdletters). duplicate telt 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 (axisContribution 0 / 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 heeft sourceMapId -1 en de lijst met bekende actie-id's, zodat de game er geen standaardtoewijzingen aan toevoegt.
  • Commandolijst: engine nuclearoption refresh-db vindt de Rewired-InputManager in resources.assets aan zijn eerste actie ("Pitch") en schrijft DB\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 met engine backups restore.

#Bekende beperkingen

  • Apparaten die Rewired in de game herkent (een hardwareGuid die 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 game tools\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.