JoyPro2 Discord GitHub
Hry

X4: Foundations

Zobraziť:

X4: Foundations uchováva vaše väzby v inputmap.xml a joystick pomenúva podľa slotu (1 až 8), nie podľa názvu. Ktoré zariadenie je v ktorom slote, je v config.xml. JoyPro načíta väzby vesmírneho letu do vášho profilu a zapíše ich späť priamo na mieste, do slotov, ktoré X4 pevne priradilo vašim zariadeniam. Invertovania a mŕtva zóna platia v X4 pre celú hru, preto ich JoyPro nastaví z vašich vzťahov pre celú hru.

X4: Foundations natívne (vlastné súbory väzieb)
Podpora
natívne (vlastné súbory väzieb)
Príkaz nástroja
engine x4
Súbor väzieb
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + sloty v config.xml
Vstupy, ktoré hra číta
číta 64 tlačidiel, 8 osí, 1 hat na joystick (overené)
Zoznam príkazov z
tabuľky názvov z X4.exe a archívy .cat/.dat
Test v hre
36/36 krokov splnených (2026-10-11)
  • ✓ Importovať
  • ✓ Export
  • ✓ Väzby klávesnice
  • ◐ ModifikátoryX4: Shift/Ctrl na väzbách klávesnice; väzby joysticku modifikátor neprijímajú.
  • ✓ Zoznam príkazov zostavený vo vašom PC
  • ✓ Sledovanie hier
  • ✗ Krivky osí a mŕtve zónyX4: iba celoherná mŕtva zóna a invertovania (Game settings), nič na väzbu.
  • ✓ Nastavenia ovládania v hre
  • ✗ Nastavenia Force Feedback v hre
  • ✗ Force Feedback z telemetrie
  • ✗ Záznam telemetrie
  • ✓ Virtuálny joystick (vJoy)
  • ◐ Virtuálny gamepad Xbox
  • ✓ Virtuálne funkcie
  • ✓ Sprievodca nastavením / Automatické priradenie
  • ✓ Kokpity
  • ✓ Ťaháky
  • ✓ Test v hre
X Rebirth iba zdokumentované
Podpora
iba zdokumentované
Príkaz nástroja
žiadne
  • — Importovať
  • — Export
  • — Väzby klávesnice
  • — Modifikátory
  • — Zoznam príkazov zostavený vo vašom PC
  • — Sledovanie hier
  • — Krivky osí a mŕtve zóny
  • — Nastavenia ovládania v hre
  • — Nastavenia Force Feedback v hre
  • — Force Feedback z telemetrie
  • — Záznam telemetrie
  • — Virtuálny joystick (vJoy)
  • — Virtuálny gamepad Xbox
  • — Virtuálne funkcie
  • — Sprievodca nastavením / Automatické priradenie
  • — Kokpity
  • — Ťaháky
  • — Test v hre
X3 (Reunion, Terran Conflict, Albion Prelude) iba zdokumentované
Podpora
iba zdokumentované
Príkaz nástroja
žiadne
  • — Importovať
  • — Export
  • — Väzby klávesnice
  • — Modifikátory
  • — Zoznam príkazov zostavený vo vašom PC
  • — Sledovanie hier
  • — Krivky osí a mŕtve zóny
  • — Nastavenia ovládania v hre
  • — Nastavenia Force Feedback v hre
  • — Force Feedback z telemetrie
  • — Záznam telemetrie
  • — Virtuálny joystick (vJoy)
  • — Virtuálny gamepad Xbox
  • — Virtuálne funkcie
  • — Sprievodca nastavením / Automatické priradenie
  • — Kokpity
  • — Ťaháky
  • — Test v hre

Z matice podpory, vygenerovanej z kódu nástroja: všetky hry.

Pre začiatočníkov

#Spustite to v 3 krokoch

  1. Nastaviť všetko za mňa
    na stránke Úvod
  2. Použiť tieto tlačidlá
    najprv si pozrite zoznam
  3. Zapísať do mojej hry
    X4 nechajte zatvorené

Pred: raz dajte každému zariadeniu slot. V nastaveniach ovládania X4 otvorte Manage Controllers/Joysticks. Priraďte každé zariadenie do slotu a potom hru normálne ukončite.

Potom: vaše väzby sú v Settings > Controls.

Priraďovali ste už tlačidlá v X4? Potom vám Úvod ponúkne Importovať, potom doplniť medzery. Vaše väzby zostanú a nové úlohy dostanú iba voľné tlačidlá. Pozri Rýchly štart: rozbehať moju páku.

#Čo JoyPro robí pre X4

  • Importovať: väzby vesmírneho letu z vašich pák, plynov a pedálov prejdú do vášho profilu s invertovaniami a režimom plynu z hry.
  • Vzťahy: jeden vzťah je jedna funkcia vo všetkých hrách. "Boost" môže byť to isté tlačidlo v X4, Elite Dangerous aj Star Citizen.
  • Export: JoyPro upravuje inputmap.xml priamo na mieste, na slotoch vašich zariadení. Väzby ponúk, pohľadu z prvej osoby, klávesnice a myši zostanú.

#Importujte svoje väzby z X4

  1. Otvorte Štart. Ak karta X4 žiada zoznam príkazov, stlačte Zostaviť zoznam: JoyPro načíta ovládanie hry z vašej inštalácie (iba na čítanie).
  2. Na karte X4 stlačte Importovať. Ponechajte Pridať do môjho profilu. Ak chcete mať v JoyPro aj letové klávesy, začiarknite Prevziať aj klávesy klávesnice.
  3. Stlačte Importovať teraz. Zobraziť moje vzťahy otvorí, čo prišlo.

#Vytvorte a skontrolujte vzťahy

Spojte tú istú funkciu vašich hier pomocou postupu vzťahov a potom na stránke Export stlačte Skontrolovať. Väzby joysticku nechajte bez modifikátorov: X4 neprijme modifikátor pri väzbe joysticku.

#Export do X4

  1. Zatvorte X4. Hra zapisuje inputmap.xml a config.xml na konci relácie, preto JoyPro odmietne zapisovať, kým beží.
  2. Otvorte Export a začiarknite kartu X4.
  3. Ponechajte Nahradiť na mojich zariadeniach s Vymazať aj moje ostatné zariadenia, ak svoje páky nastavujete v JoyPro. Na karte stlačte Exportovať teraz.
V hre: Čo uvidíte v X4

Spustite hru a otvorte Settings > Controls. Vaše väzby sú v stĺpci ovládača / joysticku pri každom ovládaní vesmírneho letu, na slote vášho zariadenia. Invert Controller / Joystick Axes ukazuje invertovania, ktoré JoyPro nastavil, a riadky obojsmerného plynu, mŕtvej zóny joysticku a adaptívneho riadenia ukazujú vaše hodnoty. Automatický náklon a vibrácie sú v nastaveniach hry.

#Čo urobíte sami v X4

  • Raz dajte každému zariadeniu slot. V nastaveniach ovládania X4 otvorte Manage Controllers/Joysticks, priraďte každú páku, plyn a sadu pedálov do slotu a potom hru normálne ukončite. X4 si potom zariadenie zapamätá v config.xml. Zariadenie bez takejto položky sa z jednej relácie do druhej presúva medzi slotmi, preto ho JoyPro vynechá ("assign the device to a slot in X4 once"). Vynechá sa aj zariadenie, ktoré je tam nastavené na "none".
  • Pred exportom pripojte svoje zariadenia.

#Časté problémy

  • "X4 beží": ukončite hru a exportujte znova.
  • Zariadenie sa vynechalo: v X4 nie je pevne priradené k slotu. Priraďte ho v Manage Controllers/Joysticks.
  • Páka v slote 1 robí veci gamepadu: slot 1 je slot gamepadu v predvolenej mape X4, takže páka v ňom zdedí štandardné väzby gamepadu. Nahradiť na mojich zariadeniach ich odstráni.
  • Tlačidlá nad 64 alebo druhý hat nič nerobia: X4 číta 64 tlačidiel, 8 osí a jeden hat na zariadenie. Väzby nad tento rámec JoyPro s upozornením vynechá.
  • Invertovanie zostalo nezmenené: jedno invertovanie platí pre všetky zariadenia na danom ovládaní. Keď sa vaše vzťahy nezhodujú alebo je na to isté ovládanie priradený gamepad, JoyPro ponechá hodnotu hry a upozorní.
Pokročilé

#Súbory, ktoré JoyPro číta a zapisuje

Súbor Čo to je
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml aktívne väzby (<action>, <state>, <range> pre každý ovládací prvok a vstup) a parametre <config> (invertovania, mŕtva zóna, obojsmerný plyn, adaptívne riadenie). <id> je priečinok účtu Steam.
...\X4\<id>\config.xml sloty zariadení (<joysticks>) a nastavenia hry ako vibrácie, automatické klonenie a režim gamepadu; čítané kvôli slotom, upravované na mieste kvôli nastaveniam
...\X4\<id>\inputmap.xml.joypro-meta.json Názvy, skupiny a ladenie zapísaných väzieb od JoyPro, ktoré načíta ďalší import
inputmap.xml.jpbak, config.xml.jpbak kópie spred prvého zápisu a navyše verzované úložisko záloh JoyPro

Súbor sa zapisuje ako text: deklarácia, konce riadkov, odsadenie, komentáre sekcií, <config>, atribúty koreňa a každý nedotknutý riadok zostanú bajt po bajte. Nový riadok ide do svojej sekcie za poslednú položku rovnakého druhu s nižším číslom ovládacieho prvku. JoyPro sa nikdy nedotkne uložených profilov inputmap_1.xml až inputmap_5.xml ani vašich uložených hier. Steam Cloud synchronizuje priečinok; ktoré súbory synchronizuje, zatiaľ nie je potvrdené.

#Režimy exportu v X4

Konflikt je iný letový ovládací prvok na rovnakom slote a vstupe. Dvojníky ovládacieho prvku pre mapu a detailný monitor sa počítajú ako ten istý ovládací prvok.

Režim Čo sa stane v inputmap.xml
Iba pridať Nič sa neodstráni. Väzba, ktorej vstup má iný letový ovládací prvok, sa nezapíše a dostane označenie „Nezapísané do hry“.
Aktualizovať, ponechať väzby hry Vaše riadky pribudnú vedľa ostatných vstupov ovládacieho prvku; odstránia sa iba konflikty.
Aktualizovať, môj profil vyhráva Ako vyššie, a navyše ovládací prvok, ktorý priradíte, stratí svoje ostatné riadky na pevne priradených slotoch pripojených zariadení (s možnosťou klávesnice aj svoje riadky klávesnice).
Nahradiť na mojich zariadeniach Letové väzby zapísaných slotov, ktoré nie sú vo vašom profile, sa odstránia, aj štandardné letové väzby gamepadu na slote 1.
+ Vymazať aj moje ostatné zariadenia To isté pre sloty, ktoré config.xml pevne priraďuje pripojeným zariadeniam, ktoré export nepoužíva. Slot bez pevne priradeného zariadenia zostane nedotknutý: jeho zariadenie nie je známe.

Menu X4 priraďuje niektoré ovládacie prvky spoločne: „Toggle Travel Mode“ nastaví rovnaký vstup aj vnútri mapy, „Dock“ aj odpája. JoyPro takéto skupiny zapisuje a odstraňuje rovnako ako menu a nikdy neodstráni dvojníka „Interact“ z pohľadu prvej osoby.

#Čoho sa JoyPro nikdy nedotkne

  • Ovládacie prvky menu, mapy, pohľadu prvej osoby, možností a prístupnosti; položky radiálneho menu.
  • Riadky klávesnice a myši; klávesnica sa zapisuje iba s možnosťou klávesnice, iba pre letové ovládacie prvky, nikdy s klávesmi, ktoré menu X4 odmieta (Escape, Delete, Ctrl+X/C/V ...).
  • Sloty zariadení, ktoré nie sú pripojené alebo pevne priradené, gamepady, zariadenia ignorované pri importe a zariadenie vJoy, do ktorého JoyPro posiela vstupy.
  • Každý riadok <config>, ktorý JoyPro nenastavuje.

#Krivky a nastavenia hry

  • Granularita: jedna sada väzieb pre všetky lode (ovládanie letu vo vesmíre).
  • Invertovania sú jedna hodnota na ovládací prvok pre všetky zariadenia (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Váš vzťah si ponecháva smer z DCS; vlastné mapy HOTAS v X4 počítajú pitch, roll a throttle ako invertované, preto JoyPro pre ne nastaví parameter na vaše invertovanie obrátené. Parameter nastaví iba vtedy, keď sa zhodujú všetky osi JoyPro na tomto ovládacom prvku.
  • Obojsmerný plyn sa riadi nastavením Posuvník vzťahu plynu: Posuvník = iba dopredu, bez Posuvníka = stred je nulový ťah.
  • Mŕtva zóna: X4 má jednu mŕtvu zónu pre každú os každého joysticku. Mŕtve zóny vzťahov sa nezapisujú (export to oznámi); mŕtvu zónu hry nastavte v Nastavenia > Nastavenia Force Feedback hier (vyberte X4) alebo cez engine ffb set. Na tom istom mieste je adaptívne riadenie, vibrácie, automatické klonenie a režim gamepadu. Nastavenie, ktoré tam uložíte, má prednosť pred vzťahmi, s upozornením, keď ich obráti.
  • V X4 nie sú krivky ani saturácia pre jednotlivé osi; žiadny Force Feedback; žiadna telemetria.
  • Sledovanie: väzbu alebo možnosť, ktorú zmeníte v hre, JoyPro zaznamená po jej zatvorení (inputmap.xml a config.xml) a opýta sa, či ju má prevziať.
  • HUD: HUD nájde hru podľa jej procesu a zobrazí vaše väzby pre X4.

#X Rebirth a X3

X Rebirth používa v inputmap.xml rovnaké slová ako X4, ale jeho zoznam príkazov by potreboval vlastnú extrakciu z inštalácie. X3 (Reunion, Terran Conflict, Albion Prelude) má iný engine a neznámy formát súborov. Obe sú iba zdokumentované: JoyPro ich neimportuje ani neexportuje.

Technické podrobnosti

#Ako funguje integrácia X4

flowchart LR
  D["Vaše zariadenie<br/>(inštančné GUID)"] --> C["config.xml<br/>joysticks"]
  C --> S["Pevne priradené k slotu:<br/>slot 1 ... 8"]
  C --> K["Nepriradené alebo vypnuté:<br/>preskočené, raz ho<br/>priraďte v X4"]
  P["Váš profil"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>väzby pre každý slot"]
  E --> O["možnosti pre celú hru:<br/>invertovania, režim plynu"]
X4 pomenúva joystick podľa jeho slotu. Zariadenie bez pevného slotu sa preskočí.

Kód: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs a model nastavení engine\FfbModels\X4.cs.

  • Sloty: väzba pomenúva zdroj: INPUT_SOURCE_JOYBUTTONS (tlačidlá a Hat) alebo INPUT_SOURCE_JOYAXES, bez prípony pre slot 1 a s _2 až _8 pre ostatné. config.xml priraďuje zariadenia slotom podľa GUID inštancie DirectInput, zapísaného vo vlastnom tvare X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num 0 až 7 je slot, disabled="1" znamená žiadny. JoyPro zapisuje iba do slotov, ktorých aktuálna zapnutá položka zodpovedá pripojenému zariadeniu.
  • Kódy: tlačidlá 1 až 11 používajú názvy gamepadu z X4 (INPUT_XBUTTON_A ... BIGBUTTON), 12 až 64 INPUT_XBUTTON_12 ...; Hat INPUT_XBUTTON_DPAD_* (osem smerov); osi INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Rozsahy nedostanú sgn. Klávesnica: INPUT_KEYCODE_<DIK> s _SHIFT / _CONTROL.
  • Zoznam príkazov: engine x4 refresh-db číta gameoptions.lua a anglickú textovú stránku z archívov .cat/.dat a tabuľky názvov z X4.exe, iba na čítanie; 128 ovládacích prvkov letu vo vesmíre (6 osí, 122 tlačidiel). Riadky znejú ako „Yaw (Primary Steering Axis)“, „Roll (Secondary Steering Axis)“. engine x4 catalog ho vypíše, engine x4 paths ukáže nájdené súbory.
  • 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.
  • Nastavenia hry: engine ffb set --device * --game X4 --param <key>=<value>; parametre sa upravujú na mieste, chýbajúci sa pridá ako posledný riadok <config>. Export bez väzieb pre X4 aj tak zapíše uložené nastavenia.

#Známe obmedzenia

  • Zariadenia bez pevne priradeného slotu sa preskočia; JoyPro ich zatiaľ sám nepriraďuje.
  • Modifikátory joysticku sa nezapisujú: ich zápis v súbore zatiaľ nie je potvrdený.
  • 64 tlačidiel, 8 osí a jeden Hat na zariadenie; osem slotov, spoločných s gamepadmi.
  • Vibrácie: posuvník hry ukazuje hodnotu krát 100 orezanú (21 % sa zobrazí ako 20); súbor uchováva presnú hodnotu.
  • Testy: engine\tests\smoke\x4.ps1 (aj obnovenie katalógu); v hre tools\e2e\games\X4.ps1 (väzby a matica režimov, vo vlastnom priečinku profilu) a tools\e2e\games\X4Settings.ps1 (invertovania, režim plynu, nastavenia hry).

Všetky technické poznámky k tejto hre (vygenerované z repozitára): x4.md.