JoyPro2 Discord GitHub
Spel

X4: Foundations

Visa:

X4: Foundations sparar dina bindningar i inputmap.xml och namnger en joystick efter dess plats (1 till 8), inte efter dess namn. Vilken enhet som sitter på vilken plats står i config.xml. JoyPro läser in rymdflygningsbindningarna i din profil och skriver tillbaka dem på plats, till de platser som X4 har fäst vid dina enheter. Inverteringar och dödzonen gäller hela spelet i X4, så JoyPro ställer in dem utifrån dina relationer för hela spelet.

X4: Foundations nativ (egna bindningsfiler)
Stöd
nativ (egna bindningsfiler)
Motorkommando
engine x4
Bindningsfil
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + platserna i config.xml
Ingångar som spelet läser
läser 64 knappar, 8 axlar, 1 hatt per joystick (verifierat)
Kommandolista från
namntabellerna i X4.exe och .cat/.dat-arkiven
Test i spelet
36/36 steg godkända (2026-10-11)
  • ✓ Importera
  • ✓ Exportera
  • ✓ Tangentbordsbindningar
  • ◐ ModifierareX4: Shift/Ctrl på tangentbordsbindningar; joystickbindningar tar ingen modifierare.
  • ✓ Kommandolista byggd på din dator
  • ✓ Spelbevakare
  • ✗ Axelkurvor och dödzonerX4: bara spelets gemensamma dödzon och inverteringar (Game settings), inget per bindning.
  • ✓ Spelets kontrollinställningar
  • ✗ Force feedback-inställningar i spelet
  • ✗ Force feedback från telemetri
  • ✗ Telemetriinspelning
  • ✓ Virtuell joystick (vJoy)
  • ◐ Virtuell Xbox-handkontroll
  • ✓ Virtuella funktioner
  • ✓ Konfigurationsguide / Tilldela automatiskt
  • ✓ Cockpits
  • ✓ Fusklappar
  • ✓ Test i spelet
X Rebirth endast dokumenterat
Stöd
endast dokumenterat
Motorkommando
inga
  • — Importera
  • — Exportera
  • — Tangentbordsbindningar
  • — Modifierare
  • — Kommandolista byggd på din dator
  • — Spelbevakare
  • — Axelkurvor och dödzoner
  • — Spelets kontrollinställningar
  • — Force feedback-inställningar i spelet
  • — Force feedback från telemetri
  • — Telemetriinspelning
  • — Virtuell joystick (vJoy)
  • — Virtuell Xbox-handkontroll
  • — Virtuella funktioner
  • — Konfigurationsguide / Tilldela automatiskt
  • — Cockpits
  • — Fusklappar
  • — Test i spelet
X3 (Reunion, Terran Conflict, Albion Prelude) endast dokumenterat
Stöd
endast dokumenterat
Motorkommando
inga
  • — Importera
  • — Exportera
  • — Tangentbordsbindningar
  • — Modifierare
  • — Kommandolista byggd på din dator
  • — Spelbevakare
  • — Axelkurvor och dödzoner
  • — Spelets kontrollinställningar
  • — Force feedback-inställningar i spelet
  • — Force feedback från telemetri
  • — Telemetriinspelning
  • — Virtuell joystick (vJoy)
  • — Virtuell Xbox-handkontroll
  • — Virtuella funktioner
  • — Konfigurationsguide / Tilldela automatiskt
  • — Cockpits
  • — Fusklappar
  • — Test i spelet

Från stödmatrisen, genererad från motorns kod: alla spel.

För nybörjare

#Kom igång i 3 steg

  1. Ställ in allt åt mig
    på sidan Start
  2. Använd de här knapparna
    titta på listan först
  3. Skriv till mitt spel
    ha X4 stängt

Före: ge varje enhet en plats en gång. Öppna Manage Controllers/Joysticks i X4:s kontrollinställningar. Tilldela varje enhet en plats och lämna sedan spelet på vanligt sätt.

Sedan: dina bindningar finns under Settings > Controls.

Har du bundit knappar i X4 tidigare? Då erbjuder Start Importera, fyll sedan luckorna. Dina bindningar finns kvar och bara lediga knappar får nya uppgifter. Se Snabbstart: få min styrspak att fungera.

#Vad JoyPro gör för X4

  • Importera: rymdflygningsbindningarna för dina styrspakar, gasreglage och pedaler kommer in i din profil, med spelets inverteringar och gasläge.
  • Relationer: en relation är en funktion i alla spel. "Boost" kan vara samma knapp i X4, Elite Dangerous och Star Citizen.
  • Exportera: JoyPro redigerar inputmap.xml på plats, på dina enheters platser. Bindningar för menyer, förstapersonsläge, tangentbord och mus finns kvar.

#Importera dina X4-bindningar

  1. Öppna Start. Om X4-kortet ber om en kommandolista trycker du på Bygg lista: JoyPro läser spelets kontroller från din installation (bara läsning).
  2. Tryck på Importera på X4-kortet. Behåll Lägg till i min profil. Kryssa i Ta även tangentbordstangenterna om du också vill ha dina flygtangenter i JoyPro.
  3. Tryck på Importera nu. Se mina relationer öppnar det som kom in.

#Bygg och kontrollera relationer

Koppla ihop samma funktion i dina spel med relationsflödet och tryck sedan på Kontrollera på exportsidan. Håll dina joystickbindningar utan modifierare: X4 tar ingen modifierare på en joystickbindning.

#Exportera till X4

  1. Stäng X4. Spelet skriver inputmap.xml och config.xml när en session slutar, så JoyPro vägrar skriva medan det körs.
  2. Öppna Exportera och kryssa i X4-kortet.
  3. Behåll Ersätt på mina enheter med Rensa även mina andra enheter om det är i JoyPro du ställer in dina spakar. Tryck på Exportera nu på kortet.
I spelet: Vad du ser i X4

Starta spelet och öppna Settings > Controls. Dina bindningar finns i kolumnen för handkontroll/joystick för varje rymdflygningskontroll, på din enhets plats. Invert Controller / Joystick Axes visar inverteringarna som JoyPro ställde in, och raderna för dubbelriktat gasreglage, joystickens dödzon och adaptiv styrning visar dina värden. Automatisk rollning och vibration finns i spelinställningarna.

#Vad du gör själv i X4

  • Ge varje enhet en plats en gång. Öppna Manage Controllers/Joysticks i X4:s kontrollinställningar och tilldela varje styrspak, gasreglage och pedalsats en plats, och lämna sedan spelet på vanligt sätt. X4 kommer då ihåg enheten i config.xml. En enhet utan en sådan post flyttar mellan platser från en session till nästa, så JoyPro hoppar över den ("tilldela enheten en plats i X4 en gång"). En enhet som är inställd på "none" där hoppas också över.
  • Anslut dina enheter innan du exporterar.

#Vanliga fallgropar

  • "X4 körs": avsluta spelet och exportera igen.
  • En enhet hoppades över: den är inte fäst vid en plats i X4. Tilldela den under Manage Controllers/Joysticks.
  • En styrspak på plats 1 gör handkontrollssaker: plats 1 är handkontrollsplatsen i X4:s standardkarta, så en spak där ärver de förinställda handkontrollsbindningarna. Ersätt på mina enheter tar bort dem.
  • Knappar över 64 eller en andra hatt gör ingenting: X4 läser 64 knappar, 8 axlar och en hatt per enhet. JoyPro hoppar över bindningar utöver det med en varning.
  • En invertering lämnades orörd: en invertering gäller för alla enheter på den kontrollen. När dina relationer inte stämmer överens, eller en handkontroll är bunden till samma kontroll, lämnar JoyPro spelets värde och varnar.
Avancerat

#Filer som JoyPro läser och skriver

Fil Vad det är
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml de aktiva bindningarna (<action>, <state>, <range> per kontroll och ingång) och <config>-parametrarna (inverteringar, dödzon, dubbelriktat gasreglage, adaptiv styrning). <id> är Steam-kontots mapp.
...\X4\<id>\config.xml enhetsplatserna (<joysticks>) och spelinställningar som vibration, automatisk roll och handkontrollsläge; läses för platserna, redigeras på plats för inställningarna
...\X4\<id>\inputmap.xml.joypro-meta.json JoyPros namn, grupper och justeringar för de skrivna bindningarna, som läses tillbaka vid nästa import
inputmap.xml.jpbak, config.xml.jpbak kopior från före den första skrivningen, plus JoyPros versionshanterade lagring av säkerhetskopior

Filen skrivs som text: deklarationen, radsluten, indraget, avsnittskommentarerna, <config>, rotattributen och varje orörd rad förblir byte för byte desamma. En ny rad hamnar i sitt avsnitt efter den sista posten av samma slag med lägre kontrollnummer. JoyPro rör aldrig de sparade profilerna inputmap_1.xml till inputmap_5.xml eller dina sparade spel. Steam Cloud synkar mappen; vilka filer den synkar är inte bekräftat ännu.

#Exportlägena i X4

En konflikt är en annan flygkontroll på samma plats och ingång. En kontrolls tvillingar för kartan och detaljmonitorn räknas som samma kontroll.

Läge Vad som händer i inputmap.xml
Bara lägga till Ingenting tas bort. En bindning vars ingång en annan flygkontroll har skrivs inte och markeras "Inte skrivet till spelet".
Uppdatera, behåll spelets bindningar Dina rader läggs till bredvid kontrollens andra ingångar; bara konflikter tas bort.
Uppdatera, min profil vinner Som ovan, och en kontroll du binder förlorar sina andra rader på fastlåsta platser för anslutna enheter (med tangentbordsalternativet även sina tangentbordsrader).
Ersätt på mina enheter Flygbindningarna på de skrivna platserna som inte finns i din profil tas bort, även handkontrollens standardflygbindningar på plats 1.
+ Rensa även mina andra enheter Samma sak för platser som config.xml låser till anslutna enheter som exporten inte använder. En plats utan fastlåst enhet lämnas orörd: dess enhet är okänd.

X4:s meny binder vissa kontroller tillsammans: "Toggle Travel Mode" sätter samma ingång även i kartan, "Dock" kopplar också loss. JoyPro skriver och tar bort sådana grupper så som menyn gör, och tar aldrig bort förstapersonstvillingen "Interact".

#Det som aldrig rörs

  • Kontroller för meny, karta, förstaperson, alternativ och tillgänglighet; poster i den radiella menyn.
  • Rader för tangentbord och mus; tangentbordet skrivs bara med tangentbordsalternativet, bara för flygkontroller, aldrig med tangenter som X4:s meny avvisar (Escape, Delete, Ctrl+X/C/V ...).
  • Platser för enheter som inte är anslutna eller inte fastlåsta, handkontroller, enheter som importen ignorerar och den vJoy-enhet som JoyPro tunnlar in i.
  • Varje <config>-rad som JoyPro inte ställer in.

#Kurvor och spelinställningar

  • Granularitet: en uppsättning bindningar för alla skepp (rymdflygkontrollerna).
  • Inverteringar är ett värde per kontroll för alla enheter (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Din relation behåller riktningen från DCS; X4:s egna HOTAS-mappningar räknar pitch, roll och gasreglage som inverterade, så för dessa sätter JoyPro parametern till din invertering omvänd. Den sätter en parameter bara när alla JoyPro-axlar på den kontrollen är överens.
  • Dubbelriktat gasreglage följer gasreglagerelationens Reglage: Reglage = bara framåt, inget Reglage = mitten är noll dragkraft.
  • Dödzon: X4 har en dödzon för alla axlar på alla joystickar. Relationernas dödzoner skrivs inte (exporten säger det); ställ in spelets dödzon under Inställningar > Spelens force feedback-inställningar (välj X4) eller med engine ffb set. På samma ställe finns adaptiv styrning, vibration, automatisk roll och handkontrollsläge. En inställning du sparar där vinner över relationerna, med en varning när den vänder på dem.
  • Inga kurvor eller mättnad per axel i X4; ingen force feedback; ingen telemetri.
  • Bevakning: en bindning eller ett alternativ du ändrar i spelet märks efter att det har stängts (inputmap.xml och config.xml), och JoyPro frågar om ändringen ska tas över.
  • HUD: HUD hittar spelet via dess process och visar dina bindningar för X4.

#X Rebirth och X3

X Rebirth använder samma ord i inputmap.xml som X4, men dess kommandolista skulle behöva en egen extrahering från en installation. X3 (Reunion, Terran Conflict, Albion Prelude) har en annan motor och ett okänt filformat. Båda är bara dokumenterade: JoyPro importerar eller exporterar dem inte.

Tekniska detaljer

#Inuti X4-integrationen

flowchart LR
  D["Din enhet<br/>(instans-GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Fastlåst till en plats:<br/>plats 1 ... 8"]
  C --> K["Inte fastlåst eller inaktiverad:<br/>hoppas över, tilldela den<br/>en gång i X4"]
  P["Din profil"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>bindningar per plats"]
  E --> O["alternativ för hela spelet:<br/>inverteringar, gasreglageläge"]
X4 namnger en joystick efter dess plats. En enhet utan fast plats hoppas över.

Kod: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs och inställningsmodellen engine\FfbModels\X4.cs.

  • Platser: en bindning anger en källa: INPUT_SOURCE_JOYBUTTONS (knappar och hatt) eller INPUT_SOURCE_JOYAXES, utan suffix för plats 1 och _2 till _8 för de andra. config.xml kopplar enheter till platser via DirectInput-instans-GUID, skrivet i X4:s egen form ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num 0 till 7 är platsen, disabled="1" betyder ingen. JoyPro skriver bara till platser vars aktuella, aktiverade post matchar en ansluten enhet.
  • Koder: knapparna 1 till 11 använder X4:s handkontrollsnamn (INPUT_XBUTTON_A ... BIGBUTTON), 12 till 64 INPUT_XBUTTON_12 ...; hatten INPUT_XBUTTON_DPAD_* (åtta riktningar); axlarna INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Intervall får inget sgn. Tangentbord: INPUT_KEYCODE_<DIK> med _SHIFT / _CONTROL.
  • Kommandolista: engine x4 refresh-db läser gameoptions.lua och den engelska textsidan från .cat/.dat-arkiven samt namntabellerna i X4.exe, endast läsning; 128 rymdflygkontroller (6 axlar, 122 knappar). Raderna lyder till exempel "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)". engine x4 catalog listar den, engine x4 paths visar de hittade filerna.
  • Import / export: 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.
  • Spelinställningar: engine ffb set --device * --game X4 --param <key>=<value>; parametrar redigeras på plats, en som saknas läggs till som sista rad i <config>. En export utan bindningar för X4 skriver ändå de sparade inställningarna.

#Kända begränsningar

  • Enheter utan fastlåst plats hoppas över; JoyPro låser inte fast dem själv ännu.
  • Joystickmodifierare skrivs inte: hur de märks upp i filen är inte bekräftat ännu.
  • 64 knappar, 8 axlar och en hatt per enhet; åtta platser, delade med handkontroller.
  • Vibration: spelets reglage visar värdet gånger 100, avkortat (21 % visas som 20); filen behåller det exakta värdet.
  • Tester: engine\tests\smoke\x4.ps1 (även uppdateringen av katalogen); i spelet tools\e2e\games\X4.ps1 (bindningar och lägesmatris, i en egen profilmapp) och tools\e2e\games\X4Settings.ps1 (inverteringar, gasreglageläge, spelinställningar).

Alla tekniska anteckningar om det här spelet (genererade från kodförrådet): x4.md.