JoyPro2 Discord GitHub
Spill

X4: Foundations

Vis:

X4: Foundations lagrer tilordningene dine i inputmap.xml og navngir en joystick etter plassen (1 til 8), ikke etter navnet. Hvilken enhet som sitter på hvilken plass, står i config.xml. JoyPro leser romflytilordningene inn i profilen din og skriver dem tilbake på stedet, til plassene X4 har festet til enhetene dine. Inverteringer og dødsonen gjelder hele spillet i X4, så JoyPro setter dem ut fra relasjonene dine for hele spillet.

X4: Foundations nativ (egne tilordningsfiler)
Støtte
nativ (egne tilordningsfiler)
Motorkommando
engine x4
Tilordningsfil
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + plassene i config.xml
Innganger spillet leser
leser 64 knapper, 8 akser, 1 hat per joystick (verifisert)
Kommandoliste fra
navnetabellene i X4.exe og .cat/.dat-arkivene
Test i spillet
36/36 trinn bestått (2026-10-11)
  • ✓ Importer
  • ✓ Eksporter
  • ✓ Tastaturtilordninger
  • ◐ ModifikatorerX4: Shift/Ctrl på tastaturtilordninger; joysticktilordninger tar ingen modifikator.
  • ✓ Kommandoliste bygd på din PC
  • ✓ Spillovervåker
  • ✗ Aksekurver og dødsonerX4: bare spillets felles dødsone og inverteringer (Game settings), ingenting per tilordning.
  • ✓ Spillets kontrollinnstillinger
  • ✗ Force feedback-innstillinger i spillet
  • ✗ Force feedback fra telemetri
  • ✗ Telemetriopptak
  • ✓ Virtuell joystick (vJoy)
  • ◐ Virtuell Xbox-kontroller
  • ✓ Virtuelle funksjoner
  • ✓ Oppsettveiviser / Auto-tilordne
  • ✓ Cockpiter
  • ✓ Jukselapper
  • ✓ Test i spillet
X Rebirth bare dokumentert
Støtte
bare dokumentert
Motorkommando
ingen
  • — Importer
  • — Eksporter
  • — Tastaturtilordninger
  • — Modifikatorer
  • — Kommandoliste bygd på din PC
  • — Spillovervåker
  • — Aksekurver og dødsoner
  • — Spillets kontrollinnstillinger
  • — Force feedback-innstillinger i spillet
  • — Force feedback fra telemetri
  • — Telemetriopptak
  • — Virtuell joystick (vJoy)
  • — Virtuell Xbox-kontroller
  • — Virtuelle funksjoner
  • — Oppsettveiviser / Auto-tilordne
  • — Cockpiter
  • — Jukselapper
  • — Test i spillet
X3 (Reunion, Terran Conflict, Albion Prelude) bare dokumentert
Støtte
bare dokumentert
Motorkommando
ingen
  • — Importer
  • — Eksporter
  • — Tastaturtilordninger
  • — Modifikatorer
  • — Kommandoliste bygd på din PC
  • — Spillovervåker
  • — Aksekurver og dødsoner
  • — Spillets kontrollinnstillinger
  • — Force feedback-innstillinger i spillet
  • — Force feedback fra telemetri
  • — Telemetriopptak
  • — Virtuell joystick (vJoy)
  • — Virtuell Xbox-kontroller
  • — Virtuelle funksjoner
  • — Oppsettveiviser / Auto-tilordne
  • — Cockpiter
  • — Jukselapper
  • — Test i spillet

Fra støttematrisen, generert fra motorens kode: alle spill.

For nybegynnere

#Få det til å virke i 3 trinn

  1. Sett opp alt for meg
    på Start-siden
  2. Bruk disse knappene
    se på listen først
  3. Skriv til spillet mitt
    hold X4 lukket

Før: gi hver enhet en plass én gang. Åpne Manage Controllers/Joysticks i kontrollinnstillingene i X4. Tildel hver enhet en plass, og gå deretter ut av spillet på vanlig måte.

Deretter: tilordningene dine ligger i Settings > Controls.

Har du tilordnet knapper i X4 før? Da tilbyr Start Importer, fyll så hullene. Tilordningene dine blir værende, og bare ledige knapper får nye oppgaver. Se Hurtigstart: få styrespaken min til å virke.

#Hva JoyPro gjør for X4

  • Importer: romflytilordningene på styrespakene, gasshendlene og pedalene dine kommer inn i profilen din, med spillets inverteringer og gassmodus.
  • Relasjoner: én relasjon er én funksjon i alle spill. «Boost» kan være samme knapp i X4, Elite Dangerous og Star Citizen.
  • Eksporter: JoyPro redigerer inputmap.xml på stedet, på plassene til enhetene dine. Tilordninger for menyer, førstepersonsvisning, tastatur og mus blir værende.

#Importer tilordningene dine fra X4

  1. Åpne Start. Hvis X4-kortet ber om en kommandoliste, trykk Bygg liste: JoyPro leser spillets kontroller fra installasjonen din (bare lesing).
  2. Trykk Importer på X4-kortet. Behold Legg til i profilen min. Kryss av for Ta også med tastaturtastene hvis du vil ha flytastene dine i JoyPro også.
  3. Trykk på Importer nå. Se relasjonene mine åpner det som kom inn.

#Bygg og kontroller relasjoner

Koble sammen samme funksjon i spillene dine med relasjonsflyten, og trykk så Kontroller på Eksport-siden. Hold joysticktilordningene dine uten modifikatorer: X4 godtar ingen modifikator på en joysticktilordning.

#Eksporter til X4

  1. Lukk X4. Spillet skriver inputmap.xml og config.xml når en økt avsluttes, så JoyPro nekter å skrive mens det kjører.
  2. Åpne Eksporter og kryss av for X4-kortet.
  3. Behold Erstatt på enhetene mine med Tøm også de andre enhetene mine hvis det er i JoyPro du setter opp styrespakene dine. Trykk på Eksporter nå på kortet.
I spillet: Dette ser du i X4

Start spillet og åpne Settings > Controls. Tilordningene dine ligger i kolonnen for kontroller / joystick for hver romflykontroll, på plassen til enheten din. Invert Controller / Joystick Axes viser inverteringene JoyPro satte, og radene for toveis gass, joystick-dødsone og adaptiv styring viser verdiene dine. Auto-rull og vibrasjon ligger i spillinnstillingene.

#Dette gjør du selv i X4

  • Gi hver enhet en plass én gang. Åpne Manage Controllers/Joysticks i kontrollinnstillingene i X4 og tildel hver styrespak, gasshendel og hvert pedalsett en plass, og gå deretter ut av spillet på vanlig måte. X4 husker da enheten i config.xml. En enhet uten en slik oppføring flytter mellom plasser fra én økt til den neste, så JoyPro hopper over den («tildel enheten en plass i X4 én gang»). En enhet satt til "none" der hoppes også over.
  • Koble til enhetene dine før du eksporterer.

#Vanlige fallgruver

  • «X4 kjører»: avslutt spillet og eksporter på nytt.
  • En enhet ble hoppet over: den er ikke festet til en plass i X4. Tildel den under Manage Controllers/Joysticks.
  • En styrespak på plass 1 gjør gamepad-ting: plass 1 er gamepad-plassen i X4s standardkart, så en styrespak der arver standard gamepad-tilordningene. Erstatt på enhetene mine fjerner dem.
  • Knapper over 64 eller en andre hat gjør ingenting: X4 leser 64 knapper, 8 akser og én hat per enhet. JoyPro hopper over tilordninger utover det med en advarsel.
  • En invertering ble latt være: én invertering gjelder for alle enheter på den kontrollen. Når relasjonene dine er uenige, eller en gamepad er tilordnet samme kontroll, beholder JoyPro spillets verdi og advarer.
Avansert

#Filer JoyPro leser og skriver

Fil Hva det er
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml de aktive tilordningene (<action>, <state>, <range> per kontroll og inngang) og <config>-parameterne (inverteringer, dødsone, toveis gass, adaptiv styring). <id> er Steam-kontoens mappe.
...\X4\<id>\config.xml enhetsplassene (<joysticks>) og spillinnstillinger som rumble, auto-roll og kontrollermodus; lest for plassene, redigert på stedet for innstillingene
...\X4\<id>\inputmap.xml.joypro-meta.json JoyPros navn, grupper og justering for de skrevne tilordningene, lest tilbake av neste import
inputmap.xml.jpbak, config.xml.jpbak kopier fra før første skriving, pluss JoyPros versjonerte sikkerhetskopilager

Filen skrives som tekst: deklarasjonen, linjeskift, innrykk, seksjonskommentarene, <config>, rotattributtene og alle urørte linjer blir værende byte for byte. En ny linje legges inn i seksjonen sin etter den siste oppføringen av samme slag med et lavere kontrollnummer. JoyPro rører aldri de lagrede profilene inputmap_1.xml til inputmap_5.xml eller lagringene dine. Steam Cloud synkroniserer mappen; hvilke filer den synkroniserer, er ikke bekreftet ennå.

#Eksportmodusene i X4

En konflikt er en annen flykontroll på samme plass og inngang. Kart- og detaljmonitor-tvillingene til en kontroll regnes som samme kontroll.

Modus Hva som skjer i inputmap.xml
Bare legg til Ingenting fjernes. En tilordning der en annen flykontroll har inngangen, skrives ikke og får merket «Ikke skrevet til spillet».
Oppdater, behold spillets tilordninger Linjene dine legges inn ved siden av kontrollens andre innganger; bare konflikter fjernes.
Oppdater, min profil vinner Som over, og en kontroll du tilordner, mister de andre linjene sine på fastlåste plasser for tilkoblede enheter (med tastaturvalget også tastaturlinjene sine).
Erstatt på enhetene mine Flytilordningene på de skrevne plassene som ikke er i profilen din, fjernes, også de medfølgende flytilordningene for kontroller på plass 1.
+ Tøm også de andre enhetene mine Det samme for plasser som config.xml låser til tilkoblede enheter som eksporten ikke bruker. En plass uten fastlåst enhet blir latt være: enheten der er ukjent.

Menyen i X4 binder noen kontroller sammen: «Toggle Travel Mode» setter samme inngang også inne i kartet, «Dock» kobler også fra. JoyPro skriver og fjerner slike grupper slik menyen gjør, og fjerner aldri førstepersons-tvillingen «Interact».

#Hva som aldri røres

  • Kontroller for meny, kart, førsteperson, valg og tilgjengelighet; oppføringer i sirkelmenyen.
  • Tastatur- og muselinjer; tastaturet skrives bare med tastaturvalget, bare for flykontroller, aldri med tastene menyen i X4 avviser (Escape, Delete, Ctrl+X/C/V ...).
  • Plasser for enheter som ikke er tilkoblet eller ikke fastlåst, kontrollere, enhetene importen ignorerer, og vJoy-enheten JoyPro sender inndata gjennom.
  • Alle <config>-linjer JoyPro ikke setter.

#Kurver og spillinnstillinger

  • Granularitet: ett sett tilordninger for alle skip (romflykontrollene).
  • Inverteringer er én verdi per kontroll for alle enheter (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Relasjonen din beholder retningen fra DCS; X4s egne HOTAS-kart regner pitch, roll og gass som invertert, så JoyPro setter parameteren til din invertering snudd for disse. Den setter en parameter bare når alle JoyPro-akser på den kontrollen er enige.
  • Toveis gass følger gassrelasjonens Glidebryter: Glidebryter = bare forover, ingen Glidebryter = midten er null skyvekraft.
  • Dødsone: X4 har én dødsone for alle akser på alle joysticker. Dødsoner fra relasjoner skrives ikke (eksporten sier det); sett spillets dødsone i Innstillinger > Force feedback-innstillinger for spillene (velg X4) eller med engine ffb set. Samme sted finner du adaptiv styring, rumble, auto-roll og kontrollermodus. En innstilling du lagrer der, vinner over relasjonene, med en advarsel når den snur dem.
  • Ingen kurver eller metning per akse i X4; ingen force feedback; ingen telemetri.
  • Overvåker: en tilordning eller et valg du endrer i spillet, blir oppdaget etter at det er lukket (inputmap.xml og config.xml), og JoyPro spør om det skal tas over.
  • HUD: HUD-en finner spillet via prosessen og viser X4-tilordningene dine.

#X Rebirth og X3

X Rebirth bruker de samme inputmap.xml-ordene som X4, men kommandolisten ville trenge sin egen uttrekking fra en installasjon. X3 (Reunion, Terran Conflict, Albion Prelude) har en annen motor og et ukjent filformat. Begge er bare dokumentert: JoyPro importerer eller eksporterer dem ikke.

Teknisk

#Slik virker X4-integrasjonen

flowchart LR
  D["Enheten din<br/>(instans-GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Låst til en plass:<br/>plass 1 ... 8"]
  C --> K["Ikke låst eller deaktivert:<br/>hoppes over, tildel den<br/>i X4 én gang"]
  P["Profilen din"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>tilordninger per plass"]
  E --> O["valg for hele spillet:<br/>inverteringer, gassmodus"]
X4 navngir en joystick etter plassen. En enhet uten fast plass hoppes over.

Kode: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs og innstillingsmodellen engine\FfbModels\X4.cs.

  • Plasser: en tilordning nevner en kilde: INPUT_SOURCE_JOYBUTTONS (knapper og hat) eller INPUT_SOURCE_JOYAXES, uten suffiks for plass 1 og med _2 til _8 for de andre. config.xml knytter enheter til plasser via DirectInput-instans-GUID, skrevet i X4s egen form ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num 0 til 7 er plassen, disabled="1" betyr ingen. JoyPro skriver bare til plasser der den nåværende, aktiverte oppføringen svarer til en tilkoblet enhet.
  • Koder: knapp 1 til 11 bruker X4s kontrollernavn (INPUT_XBUTTON_A ... BIGBUTTON), 12 til 64 INPUT_XBUTTON_12 ...; hat-en INPUT_XBUTTON_DPAD_* (åtte retninger); akser INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Områder får ingen sgn. Tastatur: INPUT_KEYCODE_<DIK> med _SHIFT / _CONTROL.
  • Kommandoliste: engine x4 refresh-db leser gameoptions.lua og den engelske tekstsiden fra .cat/.dat-arkivene og navnetabellene i X4.exe, med bare lesing; 128 romflykontroller (6 akser, 122 knapper). Radene leses som «Yaw (Primary Steering Axis)», «Roll (Secondary Steering Axis)». engine x4 catalog viser den, engine x4 paths viser filene som ble funnet.
  • Import / eksport: 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.
  • Spillinnstillinger: engine ffb set --device * --game X4 --param <key>=<value>; parametere redigeres på stedet, en som mangler, legges til som siste linje i <config>. En eksport uten X4-tilordninger skriver likevel de lagrede innstillingene.

#Kjente begrensninger

  • Enheter uten fastlåst plass hoppes over; JoyPro låser dem ikke selv ennå.
  • Joystick-modifikatorer skrives ikke: markeringen deres i filen er ikke bekreftet ennå.
  • 64 knapper, 8 akser og én hat per enhet; åtte plasser, delt med kontrollere.
  • Rumble: spillets glidebryter viser verdien ganger 100 avkortet (21 % vises som 20); filen beholder den nøyaktige verdien.
  • Tester: engine\tests\smoke\x4.ps1 (også katalogoppdateringen); i spillet tools\e2e\games\X4.ps1 (tilordninger og modusmatrise, i en egen profilmappe) og tools\e2e\games\X4Settings.ps1 (inverteringer, gassmodus, spillinnstillinger).

Alle tekniske notater om dette spillet (generert fra kodelageret): x4.md.