JoyPro2 Discord GitHub
Pelit

Nuclear Option

Näytä:

Nuclear Option on taistelulentopeli, jossa on suihkukoneita, VTOL-koneita ja helikoptereita ja yksi näppäinmäärityssarja jokaiselle ilma-alukselle. Se ei säilytä ohjauksiaan tiedostossa vaan Windowsin rekisterissä: yksi Rewired-joystick-kartta laitetta kohden, jonka pelin Control Mapper kirjoittaa. JoyPro lukee nämä kartat profiiliisi ja kirjoittaa Flight Controls -näppäinmäärityksesi takaisin niihin; kamera-, pelattavuus- ja chat-määritykset säilyvät ennallaan.

Nuclear Option natiivi (omat näppäinmääritystiedostot)
Tuki
natiivi (omat näppäinmääritystiedostot)
Moottorin komento
engine nuclearoption
Näppäinmääritystiedosto
rekisteri HKCU\Software\Shockfront\NuclearOption (Rewired-XML REG_BINARY-arvoissa)
Komentoluettelon lähde
pelin resources.assets
Pelinsisäinen testi
5/5 vaihetta läpäisty (2026-10-10)
  • ✓ Tuo
  • ✓ Vie
  • ✗ Näppäimistön näppäinmääritykset
  • ✗ Muuntimet
  • ✓ Komentoluettelo rakennetaan PC:lläsi
  • ✓ Pelien seuranta
  • ✗ Akselikäyrät ja kuolleet alueetNuclear Option: pelin kalibroinnin kuollutta aluetta ei kirjoiteta.
  • ✗ Pelin ohjainasetukset
  • ✗ Pelin voimapalauteasetukset
  • ✗ Voimapalaute telemetriasta
  • ✗ Telemetrian tallennus
  • ✓ Virtuaalinen joystick (vJoy)
  • ◐ Virtuaalinen Xbox-ohjain
  • ✓ Virtuaaliset toiminnot
  • ✓ Ohjattu määritys / Automaattinen määritys
  • ✓ Ohjaamot
  • ✓ Pikaohjeet
  • ✓ Pelinsisäinen testi

Tukimatriisista, joka on luotu moottorin koodista: kaikki pelit.

Aloittelijoille

#Käyttöön 3 vaiheessa

  1. Tee kaikki puolestani
    Alku-sivulla
  2. Käytä näitä painikkeita
    katso ensin luettelo
  3. Kirjoita peliini
    pidä Nuclear Option suljettuna

Ennen: käynnistä Nuclear Option kerran ja sulje se sitten.

Sitten: näppäinmäärityksesi ovat kohdassa Settings > Controls > Open Control Bindings Menu laitteesi välilehdellä.

Määrititkö painikkeita Nuclear Optionissa aiemmin? Silloin Alku-sivu tarjoaa vaihtoehdon Tuo ja täytä sitten aukot. Näppäinmäärityksesi säilyvät, ja vain vapaat painikkeet saavat uusia tehtäviä. Katso Pika-aloitus: saa ohjainsauvani toimimaan.

#Mitä JoyPro tekee Nuclear Optionille

  • Tuo: kytkettyjen laitteidesi joystick-kartat tulevat profiiliisi: akselit käänteisyyksineen, painikkeet ja akselin painikkeet (esimerkiksi ”Increase Throttle”).
  • Suhteet: yksi suhde on yksi toiminto; Nuclear Optionissa ei ole ilma-alusluetteloita, joten suhde koskee jokaista ilma-alusta.
  • Vie: JoyPro muokkaa kunkin laitteen karttaa paikallaan, vain kirjoittamiaan Flight Controls -toimintoja. Laite, jolle pelillä ei ole tallennettua karttaa, saa uuden kartan näppäinmäärityksilläsi.

#Tuo näppäinmäärityksesi

  1. Käynnistä Nuclear Option kerran (jotta sen rekisteriavain on olemassa) ja sulje se.
  2. Avaa Alku-sivu, paina Nuclear Option -kortin Tuo ja sitten Tuo nyt.

#Rakenna ja tarkista suhteet

Rakenna suhteita kuten jokaisessa pelissä (suhteiden työnkulku); ohjattu määritys ja Automaattinen määritys tuntevat pelin toiminnot. Suorita sitten Vie-sivulla Tarkistus.

#Vie Nuclear Optioniin

  1. Sulje Nuclear Option. JoyPro kieltäytyy kirjoittamasta sen ollessa käynnissä: peli kirjoittaa karttansa, kun määritysvalikko suljetaan ja kun laite irrotetaan.
  2. Avaa Vie-sivu, pidä Korvaa laitteillani ja Tyhjennä myös muut laitteeni valittuina ja paina Nuclear Option -kortin Vie nyt.
Vie-sivuVie-sivu
Vie-sivu (Kuvat näyttävät sovelluksen englanniksi.)
Pelissä: Mitä näet Nuclear Optionissa

Avaa Settings > Controls > Open Control Bindings Menu. Control Mapperissa on yksi välilehti laitetta kohden: napsauta laitettasi ylhäällä nähdäksesi siellä Flight Controls -näppäinmäärityksesi (pelin nimillä, esimerkiksi Pitch, Roll, Yaw, Throttle). Kamera-, pelattavuus- ja chat-määritykset ovat ennallaan.

#Mitä teet itse Nuclear Optionissa

  • Käynnistä peli kerran ennen ensimmäistä tuontia tai vientiä, jotta se luo rekisteriavaimensa.
  • Use Throttle Axis Negative Region pelin ohjausasetuksissa: jätä se päälle, jotta saat koko kaasuakselin. JoyPro varoittaa, kun se on pois päältä ja profiilisi määrittää kaasuakselin.
  • Hat-kytkimet: määritä Hat-suunnat toistaiseksi pelissä; JoyPro ei vielä kirjoita niitä.

#Yleiset sudenkuopat

  • ”Nuclear Option on käynnissä”: sulje peli ja vie uudelleen.
  • Laite ohitetaan: kahta kytkettyä samanmallista laitetta (tai näppäimistöä, joka näkyy myös peliohjaimena) ei voi erottaa toisistaan pelin kartoissa; JoyPro jättää ne pois varoituksella.
  • Laite säilyttää pelin oletusmääritykset: kytketty laite, jolle pelillä ei ole tallennettua karttaa, käyttää pelin oletuskarttaa, jota JoyPro ei voi lukea; Tyhjennä myös muut laitteeni jättää sen rauhaan. Määritä sille jotain JoyProssa tai tyhjennä sen välilehti kerran Control Mapperissa.
  • Kaasu jumissa keskellä: tarkista Use Throttle Axis Negative Region (katso yllä).
Lisäasetukset

#Mitä JoyPro lukee ja kirjoittaa

Missä Mikä se on
HKCU\Software\Shockfront\NuclearOption Pelin Unity-asetukset rekisterissä; Rewired-arvot ovat binäärisiä (UTF-8-tekstiä ja yksi nollatavu), nimet päättyvät _h<hash>
yksi arvo laitetta kohden, nimessä dataType=ControllerMap ja laitteen hardwareIdentifier yhden laitteen joystick-kartta (Rewired XML) pelaajalle Player0
sama nimi, jossa dataType=ControllerMap_KnownActionIds kartan tuntemat toimintotunnukset; JoyPro kirjoittaa sen uuden kartan kanssa
<install>\NuclearOption_Data\resources.assets pelin Rewired-toimintoluettelo: vain luku, komentoluetteloa varten
%LOCALAPPDATA%\JoyPro2\GameMetadata\HKCU_Software_Shockfront_NuclearOption.joypro-meta.json JoyPron nimet, ryhmät ja säädöt viedyille näppäinmäärityksille seuraavaa tuontia varten

Ennen ensimmäistä kirjoitusta JoyPro tallentaa Player0:n ohjainkarttojen arvoista tilannevedoksen varmuuskopiovarastoon; Kumoa viimeisin vienti kirjoittaa ne takaisin ja poistaa JoyPron lisäämät kartta-arvot. Jotkin arvojen nimet ovat yli 255 merkkiä pitkiä, joten JoyPro käyttää rekisterin ohjelmointirajapintaa (Regedit ja reg export eivät näytä niitä kaikkia).

#Vientitilat Nuclear Optionissa

Tila Mitä laitteidesi kartoissa tapahtuu
Vain lisää Pelistä ei muutu mitään; näppäinmääritys, jonka painike tai akseli ohjaa jo toista toimintoa (tai akselin toista suuntaa), jätetään pois ja luetellaan.
Päivitä, säilytä pelin määritykset Flight Controls -toiminto menettää tulon, jonka annat toiselle toiminnolle; toiminto säilyttää muut tulonsa.
Päivitä, profiilini voittaa Kuten yllä, ja jokainen määrittämäsi toiminto (tai suunta) menettää muut tulonsa kaikilla kytketyillä laitteilla, jotka JoyPro pystyy lukemaan.
Korvaa laitteillani Kirjoitettujen laitteiden kaikki muut Flight Controls -toiminnot vapautetaan.
+ Tyhjennä myös muut laitteeni Kytkettyjen laitteiden muiden tallennettujen karttojen Flight Controls -toiminnot vapautetaan. Laitteet, joilla ei ole tallennettua karttaa, säilyttävät pelin oletuskartan.

#Mihin ei koskaan kosketa

  • Kaikki Flight Controls -osion ulkopuoliset toiminnot: kameran, pelattavuuden, chatin, virheenjäljityksen ja tehtäväeditorin näppäinmääritykset.
  • Näppäimistö- ja hiirikartat, kalibrointikartat, syötteiden käyttäytyminen, ohjainten määritykset ja kaikki peliasetukset (grafiikka, ThrottleUseNegative ja muut ohjausasetukset).
  • Laitteet, joita ei ole kytketty, kaksi tai useampi saman mallin laitetta, tuonnissa ohitetut laitteet sekä vJoy-laite, jonka kautta JoyPro ohjaa syötteet.
  • Kaikki muokatusta kartasta JoyPron muuttamien elementtikarttojen ulkopuolella, myös modien toimintojen näppäinmääritykset.

#Tarkkuus, käyrät ja muut

  • Tarkkuus: yleinen, yksi näppäinmäärityssarja kaikille ilma-aluksille (Throttle-toiminto on myös helikopterin kollektiivi).
  • Akselikäyrät: ei kirjoiteta. Pelin kalibroinnin kuollut alue pysyy ennallaan.
  • Näppäimistö ja muuntimet: ei kirjoiteta; pelin joystick-määrityksissä ei ole muuntimia.
  • Hat-kytkimet: ei vielä lueta eikä kirjoiteta. Liukusäätimet kirjoitetaan varoituksen kera.
  • Voimapalaute, telemetria: ei ole.
  • Seuranta: rekisterin muutosilmoitus pelin avaimesta; sormenjälki kattaa vain Player0:n ohjainkartat (seuranta).
  • HUD: HUD tunnistaa pelin sen prosessista (NuclearOption).
Tekninen

#Nuclear Option -integraation sisältä

flowchart LR
  A["resources.assets<br/>(pelin toimintoluettelo,<br/>refresh-db lukee sen)"] --> E["engine nuclearoption export<br/>(ensin tilannevedos<br/>ohjainkarttojen arvoista)"]
  P["Profiilisi"] --> E
  E --> R["HKCU / Software / Shockfront /<br/>NuclearOption<br/>(joystick-kartta laitetta kohden)"]
  R --> G["Settings > Controls ><br/>Open Control Bindings Menu"]
Peli säilyttää ohjausasetuksensa Windowsin rekisterissä. JoyPro tallentaa tilannevedoksen ennen kirjoittamista.

Koodi: engine\Games\NuclearOptionIntegration.cs (rekisterivarasto, pelin erityispiirteet, luettelon rakenne) tiedoston engine\Games\RewiredMapIntegration.cs päällä (Rewired-joystick-karttojen luku ja kirjoitus, yhteinen Tiny Combat Arenan kanssa).

  • Arvojen nimet: Unity lisää jokaiseen avaimeen _h<hash> (djb2 ja XOR UTF-8-avaimen yli, desimaalina).
  • Laitteet: pelin Rewired ei tunne yhtään tavallisista HOTAS-laitteista, joten niiden kartoissa on nolla-arvoinen hardwareGuid ja hardwareIdentifier = WindowsRawInput + HID-tuotenimi ilman välilyöntejä + PID + VID (kumpikin neljä heksanumeroa, isoin kirjaimin). duplicate laskee saman mallin laitteet; JoyPro käsittelee vain yhden mallia kohden.
  • Elementit: akselit X, Y, Z, Rx, Ry, Rz = 0–5, liukusäätimet 6 ja 7, painike n = 31 + n. Akselitoiminnon painike on <Action>.Positive / .Negative (axisContribution 0 / 1). Pelin oletuskartta määrittää Pitch-, Roll-, Yaw-, Throttle- ja Brake-toiminnot akseleille 0–4 sekä yksitoista painiketta.
  • Kirjoitus: vain muutetut ActionElementMap-lohkot muuttuvat (painikkeet kohdassa <buttonMaps>, akselit kohdassa <axisMaps>); uudella kartalla on sourceMapId -1 ja luettelo tunnetuista toimintotunnuksista, joten peli ei lisää siihen oletusmäärityksiä.
  • Komentoluettelo: engine nuclearoption refresh-db löytää Rewired InputManagerin tiedostosta resources.assets sen ensimmäisen toiminnon ("Pitch") perusteella ja kirjoittaa tiedoston DB\NuclearOption\actions.tsv (toiminnon nimi, otsikko, luokka, Rewired-tunnus; akselitoiminnot saavat myös suuntarivit).
  • Komennot: engine nuclearoption paths, engine nuclearoption catalog, engine nuclearoption scan, engine nuclearoption import, engine nuclearoption export; kumoaminen komennolla engine backups restore.

#Tunnetut rajoitukset

  • Laitteita, jotka pelin Rewired tunnistaa (nollasta poikkeava hardwareGuid, esimerkiksi T.16000M), ei käsitellä.
  • Hat-elementtien tunnuksia ei ole nähty tallennetussa kartassa, joten Hat-kytkimet ohitetaan; liukusäädinten tunnukset noudattavat Rewiredin yleistä määrittelyä.
  • Näppäinmääritykset on tarkistettu pelin valikossa, ei vielä lennossa; Pitch-toiminnon odotettua akselin etumerkkiä ei ole vielä vahvistettu.
  • Testit: engine\tests\smoke\nuclearoption.ps1 (oikea vJoy-kartta sekä kamera- ja pelattavuusmääritykset); pelissä tools\e2e\games\NuclearOptionSettings.ps1 (Pitch, Roll ja Yaw satunnaisilla vJoy-akseleilla näkyvät Control Mapperin vJoy-välilehdellä, ja tuonti pelin uuden tallennuksen jälkeen lukee ne takaisin).

Kaikki tämän pelin tekniset huomiot (luotu repositoriosta): nuclear-option.md.