JoyPro2 Discord GitHub
Pelit

X4: Foundations

Näytä:

X4: Foundations tallentaa määrityksesi tiedostoon inputmap.xml ja nimeää joystickin sen paikan (1–8) eikä nimen mukaan. Se, mikä laite on missäkin paikassa, on tiedostossa config.xml. JoyPro lukee avaruuslentomääritykset profiiliisi ja kirjoittaa ne takaisin paikallaan niihin paikkoihin, jotka X4 on kiinnittänyt laitteillesi. Käännöt ja kuollut alue koskevat X4:ssä koko peliä, joten JoyPro asettaa ne suhteidesi perusteella koko pelille.

X4: Foundations natiivi (omat näppäinmääritystiedostot)
Tuki
natiivi (omat näppäinmääritystiedostot)
Moottorin komento
engine x4
Näppäinmääritystiedosto
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + paikat tiedostossa config.xml
Pelin lukemat tulot
lukee 64 painiketta, 8 akselia, 1 Hatin joystickia kohden (varmistettu)
Komentoluettelon lähde
X4.exe:n nimitaulukot ja .cat/.dat-arkistot
Pelinsisäinen testi
36/36 vaihetta läpäisty (2026-10-11)
  • ✓ Tuo
  • ✓ Vie
  • ✓ Näppäimistön näppäinmääritykset
  • ◐ MuuntimetX4: Shift/Ctrl näppäimistön näppäinmäärityksissä; joystickin näppäinmääritykset eivät ota muunninta.
  • ✓ Komentoluettelo rakennetaan PC:lläsi
  • ✓ Pelien seuranta
  • ✗ Akselikäyrät ja kuolleet alueetX4: vain koko pelin kuollut alue ja käännöt (Game settings), ei mitään näppäinmäärityskohtaisesti.
  • ✓ 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
X Rebirth vain dokumentoitu
Tuki
vain dokumentoitu
Moottorin komento
ei mitään
  • — Tuo
  • — Vie
  • — Näppäimistön näppäinmääritykset
  • — Muuntimet
  • — Komentoluettelo rakennetaan PC:lläsi
  • — Pelien seuranta
  • — Akselikäyrät ja kuolleet alueet
  • — 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
X3 (Reunion, Terran Conflict, Albion Prelude) vain dokumentoitu
Tuki
vain dokumentoitu
Moottorin komento
ei mitään
  • — Tuo
  • — Vie
  • — Näppäimistön näppäinmääritykset
  • — Muuntimet
  • — Komentoluettelo rakennetaan PC:lläsi
  • — Pelien seuranta
  • — Akselikäyrät ja kuolleet alueet
  • — 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ä X4 suljettuna

Ennen: anna jokaiselle laitteelle kerran paikka. Avaa X4:n ohjausasetuksissa Manage Controllers/Joysticks. Määritä jokainen laite paikkaan ja poistu sitten pelistä normaalisti.

Sitten: määrityksesi ovat kohdassa Settings > Controls.

Oletko aiemmin määrittänyt painikkeita X4:ssä? Silloin Alku-sivu tarjoaa vaihtoehdon Tuo ja täytä sitten aukot. Määrityksesi säilyvät, ja vain vapaat painikkeet saavat uusia tehtäviä. Katso Pika-aloitus: saa ohjainsauvani toimimaan.

#Mitä JoyPro tekee X4:lle

  • Tuo: ohjainsauvojesi, kaasuvipujesi ja polkimiesi avaruuslentomääritykset tulevat profiiliisi pelin kääntöjen ja kaasutilan kanssa.
  • Suhteet: yksi suhde on yksi toiminto jokaisessa pelissä. ”Boost” voi olla sama painike X4:ssä, Elite Dangerousissa ja Star Citizenissä.
  • Vie: JoyPro muokkaa tiedostoa inputmap.xml paikallaan, laitteidesi paikoissa. Valikon, ensimmäisen persoonan, näppäimistön ja hiiren määritykset säilyvät.

#Tuo X4:n määrityksesi

  1. Avaa Alku. Jos X4-kortti pyytää komentoluetteloa, paina Luo luettelo: JoyPro lukee pelin ohjaukset asennuksestasi (vain luku).
  2. Paina X4-kortin Tuo. Pidä valittuna Lisää profiiliini. Valitse Ota mukaan myös näppäimistön näppäimet, jos haluat lentonäppäimesi myös JoyProhon.
  3. Paina Tuo nyt. Näytä suhteeni avaa sen, mitä tuli.

#Rakenna ja tarkista suhteet

Yhdistä peliesi sama toiminto suhteiden työnkulussa ja paina sitten Tarkista Vie-sivulla. Pidä joystick-määrityksesi ilman muuntimia: X4 ei hyväksy muunninta joystick-määrityksessä.

#Vie X4:ään

  1. Sulje X4. Peli kirjoittaa tiedostot inputmap.xml ja config.xml istunnon päättyessä, joten JoyPro ei kirjoita, kun peli on käynnissä.
  2. Avaa Vie ja valitse X4-kortti.
  3. Pidä Korvaa laitteillani ja Tyhjennä myös muut laitteeni valittuina, jos määrität ohjainsauvasi JoyProssa. Paina kortin Vie nyt.
Pelissä: Mitä näet X4:ssä

Käynnistä peli ja avaa Settings > Controls. Määrityksesi ovat kunkin avaruuslento-ohjauksen ohjain/joystick-sarakkeessa, laitteesi paikassa. Invert Controller / Joystick Axes näyttää JoyPron asettamat käännöt, ja kaksisuuntaisen kaasun, joystickin kuolleen alueen ja mukautuvan ohjauksen rivit näyttävät arvosi. Automaattinen kallistuksen tasaus ja tärinä ovat peliasetuksissa.

#Mitä teet itse X4:ssä

  • Anna jokaiselle laitteelle kerran paikka. Avaa X4:n ohjausasetuksissa Manage Controllers/Joysticks ja määritä jokainen ohjainsauva, kaasuvipu ja poljinsarja paikkaan, ja poistu sitten pelistä normaalisti. X4 muistaa silloin laitteen tiedostossa config.xml. Laite, jolla ei ole tällaista merkintää, siirtyy paikasta toiseen istunnosta toiseen, joten JoyPro ohittaa sen (”määritä laite kerran paikkaan X4:ssä”). Myös laite, joka on siellä asetettu tilaan ”none”, ohitetaan.
  • Kytke laitteesi ennen vientiä.

#Yleiset sudenkuopat

  • ”X4 on käynnissä”: sulje peli ja vie uudelleen.
  • Laite ohitettiin: sitä ei ole kiinnitetty paikkaan X4:ssä. Määritä se kohdassa Manage Controllers/Joysticks.
  • Paikan 1 ohjainsauva tekee peliohjaimen asioita: paikka 1 on X4:n oletuskartassa peliohjaimen paikka, joten siinä oleva ohjainsauva perii vakio-peliohjainmääritykset. Korvaa laitteillani poistaa ne.
  • Painikkeet yli 64 tai toinen Hat-kytkin eivät tee mitään: X4 lukee laitetta kohden 64 painiketta, 8 akselia ja yhden Hat-kytkimen. JoyPro ohittaa sen ylittävät määritykset ja varoittaa.
  • Kääntöä ei muutettu: yksi kääntö koskee kaikkia laitteita samassa ohjauksessa. Kun suhteesi ovat ristiriidassa tai peliohjain on määritetty samaan ohjaukseen, JoyPro jättää pelin arvon ja varoittaa.
Lisäasetukset

#Tiedostot, joita JoyPro lukee ja kirjoittaa

Tiedosto Mikä se on
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml aktiiviset näppäinmääritykset (<action>, <state>, <range> ohjainta ja tuloa kohden) ja <config>-parametrit (käännöt, kuollut alue, kaksisuuntainen kaasu, mukautuva ohjaus). <id> on Steam-tilin kansio.
...\X4\<id>\config.xml laitepaikat (<joysticks>) ja peliasetukset, kuten tärinä, automaattinen roll ja peliohjaintila; luetaan paikkoja varten, muokataan paikallaan asetusten osalta
...\X4\<id>\inputmap.xml.joypro-meta.json JoyPron nimet, ryhmät ja säädöt kirjoitetuille näppäinmäärityksille, jotka seuraava tuonti lukee takaisin
inputmap.xml.jpbak, config.xml.jpbak kopiot ajalta ennen ensimmäistä kirjoitusta sekä JoyPron versioitu varmuuskopiovarasto

Tiedosto kirjoitetaan tekstinä: määrittely, rivinvaihdot, sisennys, osioiden kommentit, <config>, juuren määritteet ja jokainen koskematon rivi säilyvät tavu tavulta. Uusi rivi menee osioonsa saman tyyppisen, pienemmän ohjainnumeron viimeisen merkinnän jälkeen. JoyPro ei koskaan koske tallennettuihin profiileihin inputmap_1.xml–inputmap_5.xml eikä pelitallennuksiisi. Steam Cloud synkronoi kansion; mitä tiedostoja se synkronoi, ei ole vielä vahvistettu.

#Vientitilat X4:ssä

Ristiriita on toinen lento-ohjain samalla paikalla ja tulolla. Ohjaimen kartta- ja detail monitor -kaksoset lasketaan samaksi ohjaimeksi.

Tila Mitä inputmap.xml-tiedostossa tapahtuu
Vain lisää Mitään ei poisteta. Näppäinmääritystä, jonka tulo on toisella lento-ohjaimella, ei kirjoiteta, ja se saa merkinnän "Ei kirjoitettu peliin".
Päivitä, säilytä pelin määritykset Rivisi lisätään ohjaimen muiden tulojen rinnalle; vain ristiriidat poistetaan.
Päivitä, profiilini voittaa Kuten yllä, ja määrittämäsi ohjain menettää muut rivinsä kytkettyjen laitteiden kiinnitetyillä paikoilla (näppäimistövalinnalla myös näppäimistörivinsä).
Korvaa laitteillani Kirjoitettujen paikkojen lentomääritykset, jotka eivät ole profiilissasi, poistetaan, myös paikan 1 vakiomuotoiset peliohjaimen lentomääritykset.
+ Tyhjennä myös muut laitteeni Sama paikoille, jotka config.xml kiinnittää kytkettyihin laitteisiin, joita vienti ei käytä. Paikka, jolla ei ole kiinnitettyä laitetta, jätetään rauhaan: sen laite on tuntematon.

X4:n valikko sitoo jotkin ohjaimet yhteen: "Toggle Travel Mode" asettaa saman tulon myös kartan sisälle, "Dock" myös irrottaa telakasta. JoyPro kirjoittaa ja poistaa tällaiset ryhmät samoin kuin valikko eikä koskaan poista ensimmäisen persoonan "Interact"-kaksosta.

#Mihin ei koskaan kosketa

  • Valikon, kartan, ensimmäisen persoonan, valintojen ja esteettömyyden ohjaimet; rengasvalikon kohdat.
  • Näppäimistö- ja hiiririvit; näppäimistö kirjoitetaan vain näppäimistövalinnalla, vain lento-ohjaimille eikä koskaan näppäimillä, jotka X4:n valikko hylkää (Escape, Delete, Ctrl+X/C/V ...).
  • Laitteiden paikat, joita ei ole kytketty tai kiinnitetty, peliohjaimet, tuonnissa ohitetut laitteet sekä vJoy-laite, jonka kautta JoyPro ohjaa syötteet.
  • Jokainen <config>-rivi, jota JoyPro ei aseta.

#Käyrät ja peliasetukset

  • Tarkkuus: yksi näppäinmäärityssarja kaikille aluksille (avaruuslennon ohjaimet).
  • Käännöt ovat yksi arvo ohjainta kohden kaikille laitteille (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Suhteesi säilyttää DCS:n suunnan; X4:n omat HOTAS-kartat laskevat pitchin, rollin ja kaasun käännetyiksi, joten JoyPro asettaa niille parametriksi käännöksesi vastakohdan. Se asettaa parametrin vain, kun kaikki ohjaimen JoyPro-akselit ovat samaa mieltä.
  • Kaksisuuntainen kaasu seuraa kaasusuhteen Liukusäädin-asetusta: Liukusäädin = vain eteenpäin, ei Liukusäädintä = keskikohta on nollatyöntövoima.
  • Kuollut alue: X4:ssä on yksi kuollut alue kaikille joystickien akseleille. Suhteiden kuolleita alueita ei kirjoiteta (vienti kertoo sen); aseta pelin kuollut alue kohdassa Asetukset > Pelien voimapalauteasetukset (valitse X4) tai komennolla engine ffb set. Samassa paikassa ovat mukautuva ohjaus, tärinä, automaattinen roll ja peliohjaintila. Sinne tallentamasi asetus voittaa suhteet, ja siitä varoitetaan, jos se kääntää ne.
  • X4:ssä ei ole akselikohtaisia käyriä eikä saturaatiota; ei voimapalautetta; ei telemetriaa.
  • Seuranta: pelissä muuttamasi näppäinmääritys tai valinta huomataan pelin sulkemisen jälkeen (inputmap.xml ja config.xml), ja JoyPro kysyy, otetaanko se käyttöön.
  • HUD: HUD tunnistaa pelin sen prosessista ja näyttää X4-näppäinmäärityksesi.

#X Rebirth ja X3

X Rebirth käyttää samoja inputmap.xml-sanoja kuin X4, mutta sen komentoluettelo pitäisi poimia erikseen asennuksesta. X3:ssa (Reunion, Terran Conflict, Albion Prelude) on eri moottori ja tuntematon tiedostomuoto. Molemmat on vain dokumentoitu: JoyPro ei tuo eikä vie niitä.

Tekninen

#X4-integraation sisältä

flowchart LR
  D["Laitteesi<br/>(instanssin GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Kiinnitetty paikkaan:<br/>paikka 1 ... 8"]
  C --> K["Ei kiinnitetty tai pois käytöstä:<br/>ohitetaan, määritä se<br/>kerran X4:ssä"]
  P["Profiilisi"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>näppäinmääritykset paikkaa kohden"]
  E --> O["koko pelin valinnat:<br/>käännöt, kaasutila"]
X4 nimeää joystickin sen paikan mukaan. Laite, jolla ei ole kiinteää paikkaa, ohitetaan.

Koodi: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs ja asetusmalli engine\FfbModels\X4.cs.

  • Paikat: näppäinmääritys nimeää lähteen: INPUT_SOURCE_JOYBUTTONS (painikkeet ja Hat) tai INPUT_SOURCE_JOYAXES, paikalle 1 ilman päätettä ja muille _2–_8. config.xml yhdistää laitteet paikkoihin DirectInput-instanssin GUID-tunnisteella X4:n omassa muodossa ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num 0–7 on paikka, disabled="1" tarkoittaa ei mitään. JoyPro kirjoittaa vain paikkoihin, joiden nykyinen, käytössä oleva merkintä vastaa kytkettyä laitetta.
  • Koodit: painikkeet 1–11 käyttävät X4:n peliohjainnimiä (INPUT_XBUTTON_A ... BIGBUTTON), 12–64 INPUT_XBUTTON_12 ...; Hat INPUT_XBUTTON_DPAD_* (kahdeksan suuntaa); akselit INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Alueet eivät saa sgn-merkintää. Näppäimistö: INPUT_KEYCODE_<DIK> ja _SHIFT / _CONTROL.
  • Komentoluettelo: engine x4 refresh-db lukee gameoptions.lua-tiedoston ja englanninkielisen tekstisivun .cat/.dat-arkistoista sekä X4.exe:n nimitaulukot, vain lukien; 128 avaruuslennon ohjainta (6 akselia, 122 painiketta). Rivit näkyvät muodossa "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)". engine x4 catalog luettelee sen, engine x4 paths näyttää löydetyt tiedostot.
  • Tuonti / vienti: engine x4 import, engine x4 scan; engine x4 export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run.
  • Peliasetukset: engine ffb set --device * --game X4 --param <key>=<value>; parametreja muokataan paikallaan, puuttuva lisätään <config>-osion viimeiseksi riviksi. Vienti ilman X4-määrityksiä kirjoittaa silti tallennetut asetukset.

#Tunnetut rajoitukset

  • Laitteet, joilla ei ole kiinnitettyä paikkaa, ohitetaan; JoyPro ei vielä kiinnitä niitä itse.
  • Joystickin muuntimia ei kirjoiteta: niiden merkintätapaa tiedostossa ei ole vielä vahvistettu.
  • 64 painiketta, 8 akselia ja yksi Hat-kytkin laitetta kohden; kahdeksan paikkaa, yhteiset peliohjainten kanssa.
  • Tärinä: pelin liukusäädin näyttää arvon kertaa 100 katkaistuna (21 % näkyy 20:nä); tiedosto säilyttää tarkan arvon.
  • Testit: engine\tests\smoke\x4.ps1 (myös luettelon päivitys); pelissä tools\e2e\games\X4.ps1 (näppäinmääritykset ja tilamatriisi omassa profiilikansiossaan) ja tools\e2e\games\X4Settings.ps1 (käännöt, kaasutila, peliasetukset).

Kaikki tämän pelin tekniset huomiot (luotu repositoriosta): x4.md.