JoyPro2 Discord GitHub
Spiele

Nuclear Option

Zeigen:

Nuclear Option ist ein Flugkampfspiel mit Jets, VTOLs und Hubschraubern und einem Satz Belegungen für jedes Flugzeug. Es speichert seine Steuerung nicht in einer Datei, sondern in der Windows-Registry: eine Rewired-Joystick-Zuordnung pro Gerät, geschrieben vom Control Mapper des Spiels. JoyPro liest diese Zuordnungen in Ihr Profil und schreibt Ihre Flight Controls-Belegungen in sie zurück; Belegungen für Kamera, Gameplay und Chat bleiben, wie sie sind.

Nuclear Option direkt (eigene Belegungsdateien)
Unterstützung
direkt (eigene Belegungsdateien)
Engine-Befehl
engine nuclearoption
Belegungsdatei
Registry HKCU\Software\Shockfront\NuclearOption (Rewired-XML in REG_BINARY-Werten)
Befehlsliste aus
resources.assets des Spiels
Test im Spiel
5/5 Schritte bestanden (2026-10-10)
  • ✓ Importieren
  • ✓ Exportieren
  • ✗ Tastaturbelegungen
  • ✗ Modifikatoren
  • ✓ Befehlsliste auf Ihrem PC erstellt
  • ✓ Spielüberwachung
  • ✗ Achsenkurven und TotzonenNuclear Option: Die Kalibrierungs-Totzone des Spiels wird nicht geschrieben.
  • ✗ Steuerungseinstellungen des Spiels
  • ✗ Force-Feedback-Einstellungen im Spiel
  • ✗ Force Feedback aus Telemetrie
  • ✗ Telemetrie-Aufzeichnung
  • ✓ Virtueller Joystick (vJoy)
  • ◐ Virtuelles Xbox-Pad
  • ✓ Virtuelle Funktionen
  • ✓ Einrichtungsassistent / Auto Assign
  • ✓ Cockpits
  • ✓ Spickzettel
  • ✓ Test im Spiel

Aus der Unterstützungsmatrix, erzeugt aus dem Code der Engine: alle Spiele.

Für Einsteiger

#In 3 Schritten zum Laufen bringen

  1. Alles für mich einrichten
    auf der Seite Start
  2. Diese Tasten verwenden
    zuerst die Liste ansehen
  3. In mein Spiel schreiben
    Nuclear Option geschlossen lassen

Vorher: Starten Sie Nuclear Option einmal und schließen Sie es dann.

Dann: Ihre Belegungen stehen unter Settings > Controls > Open Control Bindings Menu, auf dem Tab Ihres Geräts.

Haben Sie in Nuclear Option schon Tasten belegt? Dann bietet die Seite Start Importieren, dann Lücken füllen an. Ihre Belegungen bleiben, und nur freie Tasten bekommen neue Aufgaben. Siehe Schnellstart: meinen Stick zum Laufen bringen.

#Was JoyPro für Nuclear Option tut

  • Importieren: Die Joystick-Zuordnungen Ihrer angeschlossenen Geräte kommen in Ihr Profil: Achsen mit ihrem Invertieren, Tasten und Tasten auf einer Achse (zum Beispiel „Increase Throttle“).
  • Relationen: Eine Relation ist eine Funktion; Nuclear Option hat keine Flugzeuglisten, also gilt eine Relation für jedes Flugzeug.
  • Exportieren: JoyPro bearbeitet die Zuordnung jedes Geräts an Ort und Stelle, nur die Aktionen von Flight Controls, die es schreibt. Ein Gerät, für das das Spiel keine gespeicherte Zuordnung hat, bekommt eine neue Zuordnung mit Ihren Belegungen.

#Ihre Belegungen importieren

  1. Starten Sie Nuclear Option einmal (damit sein Registry-Schlüssel existiert) und schließen Sie es.
  2. Öffnen Sie Start, drücken Sie Importieren auf der Karte von Nuclear Option und dann Jetzt importieren.

#Relationen bauen und prüfen

Bauen Sie Relationen wie bei jedem Spiel (Ablauf Relationen); der Einrichtungsassistent und Auto Assign kennen die Funktionen des Spiels. Führen Sie dann die Prüfung auf der Seite Export aus.

#Nach Nuclear Option exportieren

  1. Schließen Sie Nuclear Option. JoyPro verweigert das Schreiben, solange es läuft: Das Spiel schreibt seine Zuordnungen, wenn das Belegungsmenü geschlossen wird und wenn ein Gerät abgesteckt wird.
  2. Öffnen Sie Exportieren, lassen Sie Auf meinen Geräten ersetzen mit Auch meine anderen Geräte leeren gewählt und drücken Sie Jetzt exportieren auf der Karte von Nuclear Option.
Die Seite ExportDie Seite Export
Die Seite Export (Die Bilder zeigen die App auf Englisch.)
Im Spiel: Was Sie in Nuclear Option sehen

Öffnen Sie Settings > Controls > Open Control Bindings Menu. Der Control Mapper hat einen Tab pro Gerät: Klicken Sie oben auf Ihr Gerät, um dort Ihre Flight-Controls-Belegungen zu sehen (mit den Namen des Spiels, zum Beispiel Pitch, Roll, Yaw, Throttle). Belegungen für Kamera, Gameplay und Chat sind unverändert.

#Was Sie in Nuclear Option selbst tun

  • Starten Sie das Spiel einmal vor dem ersten Import oder Export, damit es seinen Registry-Schlüssel anlegt.
  • Use Throttle Axis Negative Region in der Steuerung des Spiels: Lassen Sie es für eine volle Schubachse an. JoyPro warnt, wenn es aus ist und Ihr Profil eine Schubachse belegt.
  • Hats: Belegen Sie Hat-Richtungen vorerst im Spiel; JoyPro schreibt sie noch nicht.

#Häufige Stolperfallen

  • „Nuclear Option läuft“: Schließen Sie das Spiel und exportieren Sie erneut.
  • Ein Gerät wird übersprungen: Zwei angeschlossene Geräte desselben Modells (oder eine Tastatur, die auch als Gamecontroller erscheint) lassen sich in den Zuordnungen des Spiels nicht unterscheiden; JoyPro lässt sie mit einer Warnung weg.
  • Ein Gerät behält die Standardbelegungen des Spiels: Ein angeschlossenes Gerät, für das das Spiel keine gespeicherte Zuordnung hat, nutzt die Standardzuordnung des Spiels, die JoyPro nicht lesen kann; Auch meine anderen Geräte leeren lässt es in Ruhe. Belegen Sie in JoyPro etwas darauf, oder leeren Sie einmal seinen Tab im Control Mapper.
  • Schub hängt in der Mitte: Prüfen Sie Use Throttle Axis Negative Region (siehe oben).
Erweitert

#Was JoyPro liest und schreibt

Wo Was es ist
HKCU\Software\Shockfront\NuclearOption Die Unity-Einstellungen des Spiels in der Registry; die Rewired-Werte sind binär (UTF-8-Text plus ein Null-Byte), die Namen enden auf _h<hash>
ein Wert pro Gerät mit dataType=ControllerMap und dem hardwareIdentifier des Geräts im Namen die Joystick-Map eines Geräts (Rewired-XML), für den Spieler Player0
derselbe Name mit dataType=ControllerMap_KnownActionIds die Aktions-IDs, die die Map kennt; JoyPro schreibt sie zusammen mit einer neuen Map
<install>\NuclearOption_Data\resources.assets die Rewired-Aktionsliste des Spiels: nur gelesen, für die Befehlsliste
%LOCALAPPDATA%\JoyPro2\GameMetadata\HKCU_Software_Shockfront_NuclearOption.joypro-meta.json die Namen, Gruppen und Abstimmungen der exportierten Belegungen von JoyPro, für den nächsten Import

Vor dem ersten Schreiben legt JoyPro einen Schnappschuss der Controller-Map-Werte von Player0 im Sicherungsspeicher ab; Letzten Export rückgängig machen schreibt sie zurück und entfernt Map-Werte, die JoyPro hinzugefügt hat. Manche Wertnamen sind länger als 255 Zeichen, darum nutzt JoyPro die Registry-API (Regedit und reg export zeigen nicht alle).

#Die Exportmodi in Nuclear Option

Modus Was in den Maps Ihrer Geräte passiert
Nur hinzufügen Am Spiel ändert sich nichts; eine Belegung, deren Taste oder Achse schon eine andere Aktion (oder den anderen Pol einer Achse) steuert, wird ausgelassen und aufgelistet.
Aktualisieren, Belegungen des Spiels behalten Eine Flight-Controls-Aktion auf einer Eingabe, die Sie einer anderen Aktion geben, verliert sie; die Aktion behält ihre anderen Eingaben.
Aktualisieren, mein Profil gewinnt Wie oben, und jede Aktion (oder jeder Pol), die Sie belegen, verliert ihre anderen Eingaben, auf jedem angeschlossenen Gerät, das JoyPro lesen kann.
Auf meinen Geräten ersetzen Jede andere Flight-Controls-Aktion der geschriebenen Geräte wird freigegeben.
+ Auch meine anderen Geräte leeren Die Flight-Controls-Aktionen der anderen gespeicherten Maps angeschlossener Geräte werden freigegeben. Geräte ohne gespeicherte Map behalten die Standard-Map des Spiels.

#Was nie angefasst wird

  • Jede Aktion außerhalb von Flight Controls: Belegungen für Kamera, Gameplay, Chat, Debug und Missionseditor.
  • Tastatur- und Maus-Maps, die Kalibrierungs-Maps, Eingabeverhalten, die Controller-Zuordnungen und jede Spieleinstellung (Grafik, ThrottleUseNegative und die anderen Steuerungsoptionen).
  • Geräte, die nicht angeschlossen sind, zwei oder mehr Geräte desselben Modells, die beim Import ignorierten Geräte und das vJoy-Gerät, in das JoyPro einspeist.
  • Alles in einer bearbeiteten Map außerhalb der Element-Maps, die JoyPro ändert, auch Belegungen von Mod-Aktionen.

#Granularität, Kurven, der Rest

  • Granularität: global, ein Satz Belegungen für jedes Flugzeug (die Aktion Throttle ist auch der Kollektivhebel des Hubschraubers).
  • Achsenkurven: werden nicht geschrieben. Die Kalibrierungs-Totzone des Spiels bleibt, wie sie ist.
  • Tastatur und Modifikatoren: werden nicht geschrieben; die Joystick-Belegungen des Spiels haben keine Modifikatoren.
  • Hats: werden noch nicht gelesen oder geschrieben. Schieberegler werden mit einer Warnung geschrieben.
  • Force Feedback, Telemetrie: keine.
  • Überwachung: eine Registry-Änderungsmeldung auf dem Schlüssel des Spiels; der Fingerabdruck umfasst nur die Controller-Maps von Player0 (die Überwachung).
  • HUD: Das HUD erkennt das Spiel an seinem Prozess (NuclearOption).
Technische Details

#Im Inneren der Nuclear-Option-Anbindung

flowchart LR
  A["resources.assets<br/>(die Aktionsliste des Spiels,<br/>gelesen von refresh-db)"] --> E["engine nuclearoption export<br/>(zuerst ein Schnappschuss<br/>der Controller-Map-Werte)"]
  P["Das Profil"] --> E
  E --> R["HKCU / Software / Shockfront /<br/>NuclearOption<br/>(eine Joystick-Map pro Gerät)"]
  R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Das Spiel speichert seine Steuerung in der Windows-Registry. JoyPro sichert einen Schnappschuss, bevor es schreibt.

Code: engine\Games\NuclearOptionIntegration.cs (der Registry-Speicher, die Besonderheiten des Spiels, der Katalogaufbau) auf Basis von engine\Games\RewiredMapIntegration.cs (Lesen und Schreiben von Rewired-Joystick-Maps, gemeinsam mit Tiny Combat Arena).

  • Wertnamen: Unity hängt an jeden Schlüssel _h<hash> an (djb2 mit XOR über den UTF-8-Schlüssel, dezimal).
  • Geräte: Keines der üblichen HOTAS-Geräte ist dem Rewired des Spiels bekannt, darum tragen ihre Maps eine hardwareGuid von null und hardwareIdentifier = WindowsRawInput + HID-Produktname ohne Leerzeichen + PID + VID (je vier Hex-Ziffern, Großbuchstaben). duplicate zählt Geräte desselben Modells; JoyPro behandelt nur eines pro Modell.
  • Elemente: Achsen X, Y, Z, Rx, Ry, Rz = 0 bis 5, Schieberegler 6 und 7, Taste n = 31 + n. Eine Taste auf einer Achsenaktion ist <Action>.Positive / .Negative (axisContribution 0 / 1). Die Standard-Map des Spiels belegt Pitch, Roll, Yaw, Throttle und Brake auf den Achsen 0 bis 4 und elf Tasten.
  • Schreiben: Nur die berührten ActionElementMap-Blöcke ändern sich (Tasten in <buttonMaps>, Achsen in <axisMaps>); eine neue Map hat sourceMapId -1 und die Liste der bekannten Aktions-IDs, damit das Spiel ihr keine Standardbelegungen hinzufügt.
  • Befehlsliste: engine nuclearoption refresh-db findet den Rewired-InputManager in resources.assets an seiner ersten Aktion („Pitch“) und schreibt DB\NuclearOption\actions.tsv (Aktionsname, Titel, Kategorie, Rewired-ID; Achsenaktionen bekommen zusätzlich Pol-Zeilen).
  • Befehle: engine nuclearoption paths, engine nuclearoption catalog, engine nuclearoption scan, engine nuclearoption import, engine nuclearoption export; Rückgängig mit engine backups restore.

#Bekannte Grenzen

  • Geräte, die das Rewired des Spiels erkennt (eine hardwareGuid ungleich null, zum Beispiel ein T.16000M), werden nicht behandelt.
  • Hat-Element-IDs kamen in keiner gespeicherten Map vor, darum werden Hats übersprungen; die Schieberegler-IDs folgen der allgemeinen Definition von Rewired.
  • Die Belegungen wurden im Menü des Spiels geprüft, noch nicht im Flug; das Achsenvorzeichen, das das Spiel für Pitch erwartet, ist noch nicht bestätigt.
  • Tests: engine\tests\smoke\nuclearoption.ps1 (eine echte vJoy-Map plus Kamera- und Gameplay-Belegungen); im Spiel tools\e2e\games\NuclearOptionSettings.ps1 (Pitch, Roll und Yaw auf zufälligen vJoy-Achsen erscheinen im vJoy-Tab des Control Mapper, und ein Import, nachdem das Spiel wieder gespeichert hat, liest sie zurück).

Alle technischen Hinweise zu diesem Spiel (erzeugt aus dem Repository): nuclear-option.md.