JoyPro2 Discord GitHub
Giochi

Nuclear Option

Mostra:

Nuclear Option è un gioco di combattimento aereo con jet, VTOL ed elicotteri e un solo set di assegnazioni per ogni velivolo. Non salva i suoi comandi in un file ma nel registro di Windows: una mappa joystick Rewired per dispositivo, scritta dal Control Mapper del gioco. JoyPro legge queste mappe nel tuo profilo e ci riscrive dentro le tue assegnazioni Flight Controls; le assegnazioni di telecamera, gameplay e chat restano come sono.

Nuclear Option nativo (i suoi file di assegnazioni)
Supporto
nativo (i suoi file di assegnazioni)
Comando del motore
engine nuclearoption
File di assegnazioni
registro HKCU\Software\Shockfront\NuclearOption (XML Rewired in valori REG_BINARY)
Elenco comandi da
resources.assets del gioco
Test nel gioco
5/5 passi superati (2026-10-10)
  • ✓ Importa
  • ✓ Esporta
  • ✗ Assegnazioni da tastiera
  • ✗ Modificatori
  • ✓ Elenco comandi creato sul tuo PC
  • ✓ Monitoraggio giochi
  • ✗ Curve degli assi e zone morteNuclear Option: la zona morta di calibrazione del gioco non viene scritta.
  • ✗ Impostazioni dei comandi del gioco
  • ✗ Impostazioni del force feedback nel gioco
  • ✗ Force feedback dalla telemetria
  • ✗ Registrazione della telemetria
  • ✓ Joystick virtuale (vJoy)
  • ◐ Pad Xbox virtuale
  • ✓ Funzioni virtuali
  • ✓ Configurazione guidata / Assegnazione automatica
  • ✓ Cockpits
  • ✓ Schede riepilogo
  • ✓ Test nel gioco

Dalla matrice di supporto, generata dal codice del motore: tutti i giochi.

Per principianti

#Funziona in 3 passi

  1. Configura tutto per me
    nella pagina Start
  2. Usa questi pulsanti
    prima guarda l'elenco
  3. Scrivi nel mio gioco
    tieni Nuclear Option chiuso

Prima: avvia Nuclear Option una volta, poi chiudilo.

Poi: le tue assegnazioni sono in Settings > Controls > Open Control Bindings Menu, nella scheda del tuo dispositivo.

Avevi già assegnato dei pulsanti in Nuclear Option? Allora la pagina Start ti offre Importa, poi riempi i vuoti. Le tue assegnazioni restano, e solo i pulsanti liberi ricevono nuovi compiti. Vedi Avvio rapido: far funzionare la mia cloche.

#Cosa fa JoyPro per Nuclear Option

  • Importa: le mappe joystick dei tuoi dispositivi collegati entrano nel tuo profilo: assi con la loro inversione, pulsanti, e pulsanti su un asse (per esempio "Increase Throttle").
  • Relazioni: una relazione è una funzione; Nuclear Option non ha elenchi di velivoli, quindi una relazione vale per ogni velivolo.
  • Esporta: JoyPro modifica direttamente la mappa di ogni dispositivo, solo le azioni Flight Controls che scrive. Un dispositivo per cui il gioco non ha una mappa salvata riceve una nuova mappa con le tue assegnazioni.

#Importa le tue assegnazioni

  1. Avvia Nuclear Option una volta (così esiste la sua chiave di registro) e chiudilo.
  2. Apri Avvia, premi Importa sulla scheda di Nuclear Option, poi Importa ora.

#Crea e verifica le relazioni

Crea le relazioni come per ogni gioco (flusso delle relazioni); la configurazione guidata e l'Assegnazione automatica conoscono le funzioni del gioco. Poi esegui la Verifica nella pagina Esporta.

#Esportare in Nuclear Option

  1. Chiudi Nuclear Option. JoyPro si rifiuta di scrivere mentre è in esecuzione: il gioco scrive le sue mappe quando il menu delle assegnazioni si chiude e quando un dispositivo viene scollegato.
  2. Apri Esporta, lascia Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi, e premi Esporta ora sulla scheda di Nuclear Option.
La pagina EsportaLa pagina Esporta
La pagina Esporta (Le immagini mostrano l'app in inglese.)
Nel gioco: Cosa vedi in Nuclear Option

Apri Settings > Controls > Open Control Bindings Menu. Il Control Mapper ha una scheda per dispositivo: fai clic sul tuo dispositivo in alto per vedere lì le tue assegnazioni Flight Controls (con i nomi del gioco, per esempio Pitch, Roll, Yaw, Throttle). Le assegnazioni di telecamera, gameplay e chat non cambiano.

#Cosa fai tu in Nuclear Option

  • Avvia il gioco una volta prima della prima importazione o esportazione, così crea la sua chiave di registro.
  • Use Throttle Axis Negative Region nei comandi del gioco: lascialo attivo per un asse della manetta completo. JoyPro avvisa quando è disattivato e il tuo profilo assegna un asse della manetta.
  • Hat: per ora assegna le direzioni degli hat nel gioco; JoyPro non le scrive ancora.

#Errori frequenti

  • "Nuclear Option è in esecuzione": chiudi il gioco ed esporta di nuovo.
  • Un dispositivo viene saltato: due dispositivi collegati dello stesso modello (o una tastiera che appare anche come controller di gioco) non si possono distinguere nelle mappe del gioco; JoyPro li lascia fuori con un avviso.
  • Un dispositivo mantiene le assegnazioni predefinite del gioco: un dispositivo collegato per cui il gioco non ha una mappa salvata usa la mappa predefinita del gioco, che JoyPro non può leggere; Cancella anche gli altri miei dispositivi non lo tocca. Assegnagli qualcosa in JoyPro, oppure svuota una volta la sua scheda nel Control Mapper.
  • Manetta bloccata a metà: controlla Use Throttle Axis Negative Region (vedi sopra).
Avanzate

#Cosa legge e scrive JoyPro

Dove Di cosa si tratta
HKCU\Software\Shockfront\NuclearOption Le impostazioni Unity del gioco nel registro; i valori Rewired sono binari (testo UTF-8 più un byte zero), i nomi finiscono con _h<hash>
un valore per dispositivo con dataType=ControllerMap e lo hardwareIdentifier del dispositivo nel nome la mappa joystick di un dispositivo (XML Rewired), per il giocatore Player0
lo stesso nome con dataType=ControllerMap_KnownActionIds gli id delle azioni che la mappa conosce; JoyPro lo scrive con una nuova mappa
<install>\NuclearOption_Data\resources.assets l'elenco delle azioni Rewired del gioco: solo lettura, per l'elenco comandi
%LOCALAPPDATA%\JoyPro2\GameMetadata\HKCU_Software_Shockfront_NuclearOption.joypro-meta.json i nomi, i gruppi e la regolazione di JoyPro per le assegnazioni esportate, per la prossima importazione

Prima della prima scrittura JoyPro salva un'istantanea dei valori controller-map di Player0 nell'archivio dei backup; Annulla ultima esportazione li riscrive e rimuove i valori di mappa aggiunti da JoyPro. Alcuni nomi di valore superano i 255 caratteri, quindi JoyPro usa l'API del registro (Regedit e reg export non li mostrano tutti).

#Le modalità di esportazione in Nuclear Option

Modalità Cosa succede nelle mappe dei tuoi dispositivi
Aggiungi soltanto Nel gioco non cambia niente; un'assegnazione il cui pulsante o asse comanda già un'altra azione (o l'altro polo di un asse) viene esclusa ed elencata.
Aggiorna, mantieni le assegnazioni del gioco Un'azione Flight Controls su un input che dai a un'altra azione lo perde; l'azione mantiene i suoi altri input.
Aggiorna, prevale il mio profilo Come sopra, e ogni azione (o polo) che assegni lascia i suoi altri input, su ogni dispositivo collegato che JoyPro può leggere.
Sostituisci sui miei dispositivi Ogni altra azione Flight Controls dei dispositivi scritti viene liberata.
+ Cancella anche gli altri miei dispositivi Le azioni Flight Controls delle altre mappe salvate dei dispositivi collegati vengono liberate. I dispositivi senza una mappa salvata mantengono la mappa predefinita del gioco.

#Cosa non viene mai toccato

  • Ogni azione fuori da Flight Controls: assegnazioni di telecamera, gameplay, chat, debug ed editor delle missioni.
  • Le mappe di tastiera e mouse, le mappe di calibrazione, i comportamenti degli input, le assegnazioni dei controller e ogni impostazione del gioco (grafica, ThrottleUseNegative e le altre opzioni dei comandi).
  • I dispositivi non collegati, due o più dispositivi dello stesso modello, i dispositivi ignorati dall'importazione e il dispositivo vJoy in cui JoyPro convoglia gli input.
  • Tutto ciò che in una mappa modificata sta fuori dalle element map cambiate da JoyPro, anche le assegnazioni delle azioni delle mod.

#Granularità, curve, il resto

  • Granularità: globale, un solo set di assegnazioni per tutti i velivoli (l'azione Throttle è anche il collettivo dell'elicottero).
  • Curve degli assi: non vengono scritte. La zona morta di calibrazione del gioco resta com'è.
  • Tastiera e modificatori: non vengono scritti; le assegnazioni joystick del gioco non hanno modificatori.
  • Hat: non ancora letti né scritti. Gli slider vengono scritti con un avviso.
  • Force feedback, telemetria: nessuno.
  • Monitoraggio: una notifica di modifica del registro sulla chiave del gioco; l'impronta copre solo le controller map di Player0 (il monitoraggio).
  • HUD: l'HUD trova il gioco dal suo processo (NuclearOption).
Dettagli tecnici interni

#Dentro l'integrazione di Nuclear Option

flowchart LR
  A["resources.assets<br/>(l'elenco delle azioni del gioco,<br/>letto da refresh-db)"] --> E["engine nuclearoption export<br/>(prima un'istantanea dei<br/>valori controller-map)"]
  P["Il tuo profilo"] --> E
  E --> R["HKCU / Software / Shockfront /<br/>NuclearOption<br/>(una mappa joystick per dispositivo)"]
  R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Il gioco tiene i suoi comandi nel registro di Windows. JoyPro salva un'istantanea prima di scrivere.

Codice: engine\Games\NuclearOptionIntegration.cs (l'archivio nel registro, le specificità del gioco, il layout del catalogo) sopra engine\Games\RewiredMapIntegration.cs (lettura e scrittura delle mappe joystick Rewired, condiviso con Tiny Combat Arena).

  • Nomi dei valori: Unity aggiunge _h<hash> a ogni chiave (djb2 con XOR sulla chiave UTF-8, decimale).
  • Dispositivi: nessuno dei soliti dispositivi HOTAS è conosciuto dal Rewired del gioco, quindi le loro mappe hanno un hardwareGuid zero e hardwareIdentifier = WindowsRawInput + stringa prodotto HID senza spazi + PID + VID (quattro cifre esadecimali ciascuno, maiuscole). duplicate conta i dispositivi dello stesso modello; JoyPro ne gestisce solo uno per modello.
  • Elementi: assi X, Y, Z, Rx, Ry, Rz = da 0 a 5, slider 6 e 7, pulsante n = 31 + n. Un pulsante su un'azione d'asse è <Action>.Positive / .Negative (axisContribution 0 / 1). La mappa predefinita del gioco assegna Pitch, Roll, Yaw, Throttle e Brake sugli assi da 0 a 4 e undici pulsanti.
  • Scrittura: cambiano solo i blocchi ActionElementMap toccati (pulsanti in <buttonMaps>, assi in <axisMaps>); una nuova mappa ha sourceMapId -1 e l'elenco degli id delle azioni conosciute, così il gioco non vi aggiunge assegnazioni predefinite.
  • Elenco comandi: engine nuclearoption refresh-db trova l'InputManager Rewired in resources.assets dalla sua prima azione ("Pitch") e scrive DB\NuclearOption\actions.tsv (nome dell'azione, titolo, categoria, id Rewired; le azioni d'asse ricevono anche righe per i poli).
  • Comandi: engine nuclearoption paths, engine nuclearoption catalog, engine nuclearoption scan, engine nuclearoption import, engine nuclearoption export; Annulla con engine backups restore.

#Limiti noti

  • I dispositivi che il Rewired del gioco riconosce (un hardwareGuid diverso da zero, per esempio un T.16000M) non vengono gestiti.
  • Gli id degli elementi hat non sono stati visti in una mappa salvata, quindi gli hat vengono saltati; gli id degli slider seguono la definizione generica di Rewired.
  • Le assegnazioni sono state verificate nel menu del gioco, non ancora in volo; il segno dell'asse che il gioco si aspetta per Pitch non è ancora confermato.
  • Test: engine\tests\smoke\nuclearoption.ps1 (una vera mappa vJoy più assegnazioni di telecamera e gameplay); nel gioco tools\e2e\games\NuclearOptionSettings.ps1 (Pitch, Roll e Yaw su assi vJoy casuali appaiono nella scheda vJoy del Control Mapper, e un'importazione dopo un nuovo salvataggio del gioco li rilegge).

Tutte le note tecniche su questo gioco (generate dal repository): nuclear-option.md.