JoyPro2 Discord GitHub
Spil

X4: Foundations

Vis:

X4: Foundations gemmer dine tildelinger i inputmap.xml og navngiver en joystick efter dens plads (1 til 8), ikke efter dens navn. Hvilken enhed der sidder på hvilken plads, står i config.xml. JoyPro læser rumflyvningstildelingerne ind i din profil og skriver dem tilbage på stedet, til de pladser, X4 har fastlåst til dine enheder. Inverteringer og dødzonen gælder for hele spillet i X4, så JoyPro sætter dem ud fra dine relationer for hele spillet.

X4: Foundations indbygget (egne tildelingsfiler)
Understøttelse
indbygget (egne tildelingsfiler)
Motorkommando
engine x4
Tildelingsfil
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + pladserne i config.xml
Indgange, spillet læser
læser 64 knapper, 8 akser, 1 hat pr. joystick (verificeret)
Kommandoliste fra
navnetabellerne i X4.exe og .cat/.dat-arkiverne
Test i spillet
36/36 trin bestået (2026-10-11)
  • ✓ Import
  • ✓ Eksport
  • ✓ Tastaturtildelinger
  • ◐ ModifikatorerX4: Shift/Ctrl på tastaturtildelinger; joysticktildelinger tager ingen modifikator.
  • ✓ Kommandoliste bygget på din pc
  • ✓ Spilovervågning
  • ✗ Aksekurver og dødzonerX4: kun spillets samlede dødzone og inverteringer (Game settings), intet pr. tildeling.
  • ✓ Spillets kontrolindstillinger
  • ✗ Force feedback-indstillinger i spillet
  • ✗ Force feedback fra telemetri
  • ✗ Telemetrioptagelse
  • ✓ Virtuel joystick (vJoy)
  • ◐ Virtuel Xbox-pad
  • ✓ Virtuelle funktioner
  • ✓ Opsætningsguide / Auto-tildeling
  • ✓ Cockpits
  • ✓ Snydeark
  • ✓ Test i spillet
X Rebirth kun dokumenteret
Understøttelse
kun dokumenteret
Motorkommando
ingen
  • — Import
  • — Eksport
  • — Tastaturtildelinger
  • — Modifikatorer
  • — Kommandoliste bygget på din pc
  • — Spilovervågning
  • — Aksekurver og dødzoner
  • — Spillets kontrolindstillinger
  • — Force feedback-indstillinger i spillet
  • — Force feedback fra telemetri
  • — Telemetrioptagelse
  • — Virtuel joystick (vJoy)
  • — Virtuel Xbox-pad
  • — Virtuelle funktioner
  • — Opsætningsguide / Auto-tildeling
  • — Cockpits
  • — Snydeark
  • — Test i spillet
X3 (Reunion, Terran Conflict, Albion Prelude) kun dokumenteret
Understøttelse
kun dokumenteret
Motorkommando
ingen
  • — Import
  • — Eksport
  • — Tastaturtildelinger
  • — Modifikatorer
  • — Kommandoliste bygget på din pc
  • — Spilovervågning
  • — Aksekurver og dødzoner
  • — Spillets kontrolindstillinger
  • — Force feedback-indstillinger i spillet
  • — Force feedback fra telemetri
  • — Telemetrioptagelse
  • — Virtuel joystick (vJoy)
  • — Virtuel Xbox-pad
  • — Virtuelle funktioner
  • — Opsætningsguide / Auto-tildeling
  • — Cockpits
  • — Snydeark
  • — Test i spillet

Fra understøttelsesoversigten, genereret ud fra motorens kode: alle spil.

For begyndere

#Sådan virker det på 3 trin

  1. Sæt det hele op for mig
    på siden Start
  2. Brug disse knapper
    se listen først
  3. Skriv til mit spil
    hold X4 lukket

Før: giv hver enhed en plads én gang. Åbn Manage Controllers/Joysticks i X4's betjeningsindstillinger. Tildel hver enhed en plads, og forlad så spillet normalt.

Derefter: dine tildelinger ligger i Settings > Controls.

Har du tildelt knapper i X4 før? Så tilbyder siden Start Importér, og udfyld så hullerne. Dine tildelinger bliver, og kun ledige knapper får nye opgaver. Se Hurtig start: få min stick til at virke.

#Hvad JoyPro gør for X4

  • Import: rumflyvningstildelingerne på dine sticks, throttles og pedaler kommer ind i din profil med spillets inverteringer og throttle-tilstand.
  • Relationer: én relation er én funktion i alle spil. "Boost" kan være den samme knap i X4, Elite Dangerous og Star Citizen.
  • Eksport: JoyPro redigerer inputmap.xml på stedet, på dine enheders pladser. Tildelinger til menuer, førstepersonsvisning, tastatur og mus bliver.

#Importér dine X4-tildelinger

  1. Åbn Start. Hvis X4-kortet beder om en kommandoliste, så tryk på Opbyg liste: JoyPro læser spillets betjening fra din installation (kun læsning).
  2. Tryk på Import på X4-kortet. Behold Føj til min profil. Markér Tag også tastaturtasterne, hvis du også vil have dine flyvetaster i JoyPro.
  3. Tryk på Importér nu. Se mine relationer åbner det, der kom ind.

#Opbyg og kontrollér relationer

Forbind den samme funktion i dine spil med relationsforløbet, og tryk så på Kontrollér på siden Eksport. Hold dine joysticktildelinger uden modifikatorer: X4 tager ingen modifikator på en joysticktildeling.

#Eksportér til X4

  1. Luk X4. Spillet skriver inputmap.xml og config.xml, når en session slutter, så JoyPro nægter at skrive, mens det kører.
  2. Åbn Eksport, og markér X4-kortet.
  3. Behold Erstat på mine enheder med Ryd også mine andre enheder, hvis det er i JoyPro, du sætter dine sticks op. Tryk på Eksportér nu på kortet.
I spillet: Hvad du ser i X4

Start spillet, og åbn Settings > Controls. Dine tildelinger ligger i controller-/joystickkolonnen for hver rumflyvningskontrol, på din enheds plads. Invert Controller / Joystick Axes viser de inverteringer, JoyPro har sat, og rækkerne for tovejs-throttle, joystick-dødzone og adaptiv styring viser dine værdier. Auto-roll og rumble ligger i spillets indstillinger.

#Hvad du selv gør i X4

  • Giv hver enhed en plads én gang. Åbn Manage Controllers/Joysticks i X4's betjeningsindstillinger, og tildel hver stick, throttle og hvert sæt pedaler en plads, og forlad så spillet normalt. X4 husker så enheden i config.xml. En enhed uden sådan en post flytter mellem pladser fra den ene session til den næste, så JoyPro springer den over ("tildel enheden en plads i X4 én gang"). En enhed, der er sat til "none" der, springes også over.
  • Tilslut dine enheder, før du eksporterer.

#Typiske faldgruber

  • "X4 kører": afslut spillet, og eksportér igen.
  • En enhed blev sprunget over: den er ikke fastlåst til en plads i X4. Tildel den under Manage Controllers/Joysticks.
  • En stick på plads 1 gør gamepad-ting: plads 1 er gamepad-pladsen i X4's standardkort, så en stick der arver standard-gamepadtildelingerne. Erstat på mine enheder fjerner dem.
  • Knapper over 64 eller en anden hat gør intet: X4 læser 64 knapper, 8 akser og én hat pr. enhed. JoyPro springer tildelinger ud over det over med en advarsel.
  • En invertering blev ikke rørt: én invertering gælder for alle enheder på den kontrol. Når dine relationer er uenige, eller en gamepad er tildelt samme kontrol, lader JoyPro spillets værdi stå og advarer.
Avanceret

#Filer, JoyPro læser og skriver

Fil Hvad det er
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml de aktive tildelinger (<action>, <state>, <range> pr. styring og indgang) og <config>-parametrene (inverteringer, dødzone, tovejs-throttle, adaptiv styring). <id> er Steam-kontoens mappe.
...\X4\<id>\config.xml enhedspladserne (<joysticks>) og spilindstillinger som rumble, auto-roll og gamepad-tilstand; læses for pladsernes skyld, redigeres på stedet for indstillingerne
...\X4\<id>\inputmap.xml.joypro-meta.json JoyPros navne, grupper og tuning af de skrevne tildelinger, læst tilbage ved næste import
inputmap.xml.jpbak, config.xml.jpbak kopier fra før første skrivning plus JoyPros versionerede lager af sikkerhedskopier

Filen skrives som tekst: erklæringen, linjeskift, indrykning, sektionskommentarerne, <config>, rodattributterne og alle urørte linjer forbliver byte for byte. En ny linje placeres i sin sektion efter den sidste post af samme slags med et lavere styringsnummer. JoyPro rører aldrig de gemte profiler inputmap_1.xml til inputmap_5.xml eller dine gemte spil. Steam Cloud synkroniserer mappen; hvilke filer den synkroniserer, er endnu ikke bekræftet.

#Eksporttilstandene i X4

En konflikt er en anden flyvestyring på samme plads og indgang. En styrings tvillinger på kortet og i detaljemonitoren tæller som samme styring.

Tilstand Hvad der sker i inputmap.xml
Kun tilføj Intet fjernes. En tildeling, hvis indgang en anden flyvestyring har, skrives ikke og får mærket "Ikke skrevet til spillet".
Opdatér, behold spillets tildelinger Dine linjer placeres ved siden af styringens andre indgange; kun konflikter fjernes.
Opdatér, min profil vinder Som ovenfor, og en styring, du tildeler, mister sine andre linjer på fastlåste pladser for tilsluttede enheder (med tastaturindstillingen også sine tastaturlinjer).
Erstat på mine enheder Flyvetildelingerne på de skrevne pladser, som ikke er i din profil, fjernes, også de medfølgende gamepad-flyvetildelinger på plads 1.
+ Ryd også mine andre enheder Det samme for pladser, som config.xml fastlåser til tilsluttede enheder, eksporten ikke bruger. En plads uden fastlåst enhed lades være: dens enhed er ukendt.

X4's menu tildeler visse styringer sammen: "Toggle Travel Mode" sætter samme indgang også inde på kortet, "Dock" udokker også. JoyPro skriver og fjerner sådanne grupper, som menuen gør, og fjerner aldrig førstepersons-tvillingen "Interact".

#Det, der aldrig røres

  • Styringer til menu, kort, førsteperson, indstillinger og tilgængelighed; poster i den radiale menu.
  • Tastatur- og muselinjer; tastaturet skrives kun med tastaturindstillingen, kun for flyvestyringer, aldrig med de taster, X4's menu afviser (Escape, Delete, Ctrl+X/C/V ...).
  • Pladser for enheder, der ikke er tilsluttet eller ikke fastlåst, gamepads, importens ignorerede enheder og den vJoy-enhed, JoyPro sender igennem.
  • Alle <config>-linjer, JoyPro ikke sætter.

#Kurver og spilindstillinger

  • Granularitet: ét sæt tildelinger til alle skibe (styringerne til rumflyvning).
  • Inverteringer er én værdi pr. styring for alle enheder (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Din relation beholder DCS' retning; X4's egne HOTAS-maps regner pitch, roll og throttle som inverterede, så JoyPro sætter parameteren til din invertering vendt om for dem. Den sætter kun en parameter, når alle JoyPro-akser på den styring er enige.
  • Tovejs-throttle følger throttle-relationens Skyder: Skyder = kun fremad, ingen Skyder = midten er nul fremdrift.
  • Dødzone: X4 har én dødzone for alle akser på alle joysticks. Relationernes dødzoner skrives ikke (eksporten siger det); indstil spillets dødzone under Indstillinger > Spillenes force feedback-indstillinger (vælg X4) eller med engine ffb set. Samme sted findes adaptiv styring, rumble, auto-roll og gamepad-tilstand. En indstilling, du gemmer der, vinder over relationerne, med en advarsel, når den vender dem om.
  • Ingen kurver eller mætning pr. akse i X4; ingen force feedback; ingen telemetri.
  • Overvågning: en tildeling eller indstilling, du ændrer i spillet, opdages, når det er lukket (inputmap.xml og config.xml), og JoyPro spørger, om den skal overtages.
  • HUD: HUD'en finder spillet via dets proces og viser dine X4-tildelinger.

#X Rebirth og X3

X Rebirth bruger de samme inputmap.xml-ord som X4, men dets kommandoliste ville kræve sin egen udtrækning fra en installation. X3 (Reunion, Terran Conflict, Albion Prelude) har en anden motor og et ukendt filformat. Begge er kun dokumenteret: JoyPro importerer og eksporterer dem ikke.

Teknisk

#Inde i X4-integrationen

flowchart LR
  D["Din enhed<br/>(instans-GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Fastlåst til en plads:<br/>plads 1 ... 8"]
  C --> K["Ikke fastlåst eller deaktiveret:<br/>springes over, tildel den<br/>i X4 én gang"]
  P["Din profil"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>tildelinger pr. plads"]
  E --> O["indstillinger for hele spillet:<br/>inverteringer, throttle-tilstand"]
X4 navngiver en joystick efter dens plads. En enhed uden fast plads springes over.

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

  • Pladser: en tildeling angiver en kilde: INPUT_SOURCE_JOYBUTTONS (knapper og hat) eller INPUT_SOURCE_JOYAXES, uden suffiks for plads 1 og med _2 til _8 for de andre. config.xml knytter enheder til pladser via DirectInput-instans-GUID, skrevet i X4's egen form ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num 0 til 7 er pladsen, disabled="1" betyder ingen. JoyPro skriver kun til pladser, hvis aktuelle, aktiverede post matcher en tilsluttet enhed.
  • Koder: knap 1 til 11 bruger X4's gamepad-navne (INPUT_XBUTTON_A ... BIGBUTTON), 12 til 64 INPUT_XBUTTON_12 ...; hatten INPUT_XBUTTON_DPAD_* (otte retninger); akserne INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Områder får ingen sgn. Tastatur: INPUT_KEYCODE_<DIK> med _SHIFT / _CONTROL.
  • Kommandoliste: engine x4 refresh-db læser gameoptions.lua og den engelske tekstside fra .cat/.dat-arkiverne og navnetabellerne i X4.exe, kun læsning; 128 styringer til rumflyvning (6 akser, 122 knapper). Rækkerne lyder som "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)". engine x4 catalog viser den, engine x4 paths viser de fundne filer.
  • 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.
  • Spilindstillinger: engine ffb set --device * --game X4 --param <key>=<value>; parametre redigeres på stedet, en manglende tilføjes som sidste linje i <config>. En eksport uden X4-tildelinger skriver stadig de gemte indstillinger.

#Kendte begrænsninger

  • Enheder uden fastlåst plads springes over; JoyPro fastlåser dem endnu ikke selv.
  • Joystick-modifikatorer skrives ikke: deres markup i filen er endnu ikke bekræftet.
  • 64 knapper, 8 akser og én hat pr. enhed; otte pladser, delt med gamepads.
  • Rumble: spillets skyder viser værdien gange 100 afskåret (21 % vises som 20); filen beholder den præcise værdi.
  • Tests: engine\tests\smoke\x4.ps1 (også katalogopdateringen); i spillet tools\e2e\games\X4.ps1 (tildelinger og tilstandsmatrix, i sin egen profilmappe) og tools\e2e\games\X4Settings.ps1 (inverteringer, throttle-tilstand, spilindstillinger).

Alle tekniske noter om dette spil (genereret ud fra repositoriet): x4.md.