X4: Foundations drží vaše přiřazení v inputmap.xml a pojmenovává joystick podle jeho slotu (1 až 8), ne podle názvu. Které zařízení sedí ve kterém slotu, je v config.xml. JoyPro načte přiřazení pro vesmírný let do vašeho profilu a zapíše je zpět přímo na místo, do slotů, které X4 vašim zařízením pevně přidělil. Inverze a mrtvá zóna platí v X4 pro celou hru, takže je JoyPro nastaví z vašich relací pro celou hru.
X4: Foundations nativně (vlastní soubory přiřazení)
- Podpora
- nativně (vlastní soubory přiřazení)
- Příkaz enginu
engine x4- Soubor přiřazení
Documents\Egosoft\X4\<id>\inputmap.xml(XML) + sloty vconfig.xml- Vstupy, které hra čte
- čte 64 tlačítek, 8 os, 1 hat na joystick (ověřeno)
- Seznam příkazů z
- tabulky názvů z
X4.exea archivy.cat/.dat - Herní test
- 36/36 kroků splněno (2026-10-11)
- ✓ Importovat
- ✓ Export
- ✓ Přiřazení klávesnice
- ◐ ModifikátoryX4: Shift/Ctrl na přiřazeních klávesnice; přiřazení joysticku modifikátor nepřijímají.
- ✓ Seznam příkazů sestavený na vašem PC
- ✓ Sledování her
- ✗ Křivky os a mrtvé zónyX4: jen celoherní mrtvá zóna a invertování (Game settings), nic na přiřazení.
- ✓ Nastavení ovládání hry
- ✗ Herní nastavení zpětné vazby síly
- ✗ Zpětná vazba síly z telemetrie
- ✗ Záznam telemetrie
- ✓ Virtuální joystick (vJoy)
- ◐ Virtuální gamepad Xbox
- ✓ Virtuální funkce
- ✓ Průvodce nastavením / Automatické přiřazení
- ✓ Kokpity
- ✓ Taháky
- ✓ Herní test
X Rebirth jen zdokumentováno
- Podpora
- jen zdokumentováno
- Příkaz enginu
- žádné
- — Importovat
- — Export
- — Přiřazení klávesnice
- — Modifikátory
- — Seznam příkazů sestavený na vašem PC
- — Sledování her
- — Křivky os a mrtvé zóny
- — Nastavení ovládání hry
- — Herní nastavení zpětné vazby síly
- — Zpětná vazba síly z telemetrie
- — Záznam telemetrie
- — Virtuální joystick (vJoy)
- — Virtuální gamepad Xbox
- — Virtuální funkce
- — Průvodce nastavením / Automatické přiřazení
- — Kokpity
- — Taháky
- — Herní test
X3 (Reunion, Terran Conflict, Albion Prelude) jen zdokumentováno
- Podpora
- jen zdokumentováno
- Příkaz enginu
- žádné
- — Importovat
- — Export
- — Přiřazení klávesnice
- — Modifikátory
- — Seznam příkazů sestavený na vašem PC
- — Sledování her
- — Křivky os a mrtvé zóny
- — Nastavení ovládání hry
- — Herní nastavení zpětné vazby síly
- — Zpětná vazba síly z telemetrie
- — Záznam telemetrie
- — Virtuální joystick (vJoy)
- — Virtuální gamepad Xbox
- — Virtuální funkce
- — Průvodce nastavením / Automatické přiřazení
- — Kokpity
- — Taháky
- — Herní test
Z matice podpory, vygenerované z kódu enginu: všechny hry.
#Zprovozněte to ve 3 krocích
- Nastavit vše za mě
na stránce Start - Použít tato tlačítka
nejdřív se podívejte na seznam - Zapsat do mé hry
mějte X4 zavřené
Před: jednou dejte každému zařízení slot. V nastavení ovládání X4 otevřete Manage Controllers/Joysticks. Přidělte každé zařízení slotu, pak hru normálně opusťte.
Pak: vaše přiřazení jsou v Settings > Controls.
Přiřazovali jste tlačítka v X4 už dříve? Pak stránka Start nabídne Importovat, pak doplnit mezery. Vaše přiřazení zůstanou a nové úkoly dostanou jen volná tlačítka. Viz Rychlý start: zprovoznit můj ovladač.
#Co JoyPro dělá pro X4
- Importovat: přiřazení pro vesmírný let z vašich ovladačů, plynových pák a pedálů přijdou do vašeho profilu, s inverzemi a režimem plynu ze hry.
- Relace: jedna relace je jedna funkce v každé hře. "Boost" může být stejné tlačítko v X4, Elite Dangerous a Star Citizen.
- Export: JoyPro upraví
inputmap.xmlpřímo na místě, na slotech vašich zařízení. Přiřazení menu, pohledu z první osoby, klávesnice a myši zůstanou.
#Import přiřazení z X4
- Otevřete Start. Pokud karta X4 žádá seznam příkazů, stiskněte Sestavit seznam: JoyPro načte ovládání hry z vaší instalace (jen čtení).
- Stiskněte Importovat na kartě X4. Ponechte Přidat do mého profilu. Zaškrtněte Převzít také klávesy klávesnice, pokud chcete mít v JoyPro i své letové klávesy.
- Stiskněte Importovat nyní. Zobrazit moje relace otevře, co přišlo.
#Vytvořte a zkontrolujte relace
Spojte stejnou funkci vašich her pomocí postupu relací, pak stiskněte Zkontrolovat na stránce Export. Nechte svá přiřazení joysticku bez modifikátorů: X4 u přiřazení joysticku žádný modifikátor nepřijme.
#Export do X4
- Zavřete X4. Hra zapisuje
inputmap.xmlaconfig.xmlna konci relace hraní, takže JoyPro odmítne zapisovat, dokud běží. - Otevřete Export a zaškrtněte kartu X4.
- Ponechte Nahradit na mých zařízeních s Vymazat i má ostatní zařízení, pokud své ovladače nastavujete v JoyPro. Stiskněte Exportovat nyní na kartě.
Spusťte hru a otevřete Settings > Controls. Vaše přiřazení jsou ve sloupci controller / joystick u každého ovládání vesmírného letu, na slotu vašeho zařízení. Invert Controller / Joystick Axes ukazuje inverze, které JoyPro nastavil, a řádky obousměrného plynu, mrtvé zóny joysticku a adaptivního řízení ukazují vaše hodnoty. Auto-roll a vibrace jsou v nastavení hry.
#Co v X4 uděláte sami
- Jednou dejte každému zařízení slot. V nastavení ovládání X4 otevřete Manage Controllers/Joysticks a přidělte každý ovladač, plynovou páku a sadu pedálů slotu, pak hru normálně opusťte. X4 si pak zařízení zapamatuje v
config.xml. Zařízení bez takové položky se mezi spuštěními přesouvá mezi sloty, takže ho JoyPro přeskočí ("assign the device to a slot in X4 once"). Zařízení tam nastavené na "none" se přeskočí také. - Před exportem připojte svá zařízení.
#Časté chyby
- "X4 běží": ukončete hru a exportujte znovu.
- Zařízení bylo přeskočeno: v X4 není pevně přidělené slotu. Přidělte ho v Manage Controllers/Joysticks.
- Ovladač ve slotu 1 dělá věci gamepadu: slot 1 je slot gamepadu ve výchozí mapě X4, takže ovladač tam zdědí standardní přiřazení gamepadu. Nahradit na mých zařízeních je odstraní.
- Tlačítka nad 64 nebo druhý hat nic nedělají: X4 čte 64 tlačítek, 8 os a jeden hat na zařízení. JoyPro přiřazení nad tento rámec s varováním přeskočí.
- Inverze zůstala nedotčená: jedna inverze platí pro každé zařízení na tom ovládání. Když se vaše relace neshodnou, nebo je na stejné ovládání přiřazený gamepad, JoyPro ponechá hodnotu hry a upozorní.
#Soubory, které JoyPro čte a zapisuje
| Soubor | Co to je |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
aktivní přiřazení (<action>, <state>, <range> pro každý ovládací prvek a vstup) a parametry <config> (invertování, mrtvá zóna, obousměrný plyn, adaptivní řízení). <id> je složka účtu Steam. |
...\X4\<id>\config.xml |
sloty zařízení (<joysticks>) a nastavení hry, jako jsou vibrace, auto-roll a režim gamepadu; čte se kvůli slotům, kvůli nastavení se upravuje přímo na místě |
...\X4\<id>\inputmap.xml.joypro-meta.json |
názvy, skupiny a ladění zapsaných přiřazení od JoyPro, které příští import načte zpět |
inputmap.xml.jpbak, config.xml.jpbak |
kopie z doby před prvním zápisem plus verzované úložiště záloh JoyPro |
Soubor se zapisuje jako text: deklarace, konce řádků, odsazení, komentáře sekcí, <config>, atributy kořene a každý nedotčený řádek zůstanou bajt po bajtu stejné. Nový řádek jde do své sekce za poslední položku stejného druhu s nižším číslem ovládacího prvku. JoyPro se nikdy nedotkne uložených profilů inputmap_1.xml až inputmap_5.xml ani vašich uložených her. Steam Cloud synchronizuje složku; které soubory synchronizuje, zatím není potvrzeno.
#Režimy exportu v X4
Konflikt je jiný letový ovládací prvek na stejném slotu a vstupu. Dvojčata ovládacího prvku pro mapu a detailní monitor se počítají jako tentýž prvek.
| Režim | Co se stane v inputmap.xml |
|---|---|
| Pouze přidat | Nic se neodstraní. Přiřazení, jehož vstup má jiný letový ovládací prvek, se nezapíše a dostane označení "Nezapsáno do hry". |
| Aktualizovat, ponechat přiřazení hry | Vaše řádky se přidají vedle ostatních vstupů prvku; odstraní se jen konflikty. |
| Aktualizovat, vyhraje můj profil | Jako výše a navíc prvek, který přiřadíte, přijde o své ostatní řádky na pevně přiřazených slotech připojených zařízení (s možností klávesnice i o své řádky klávesnice). |
| Nahradit na mých zařízeních | Letová přiřazení zapsaných slotů, která nejsou ve vašem profilu, se odstraní, včetně standardních letových přiřazení gamepadu na slotu 1. |
| + Vymazat i má ostatní zařízení | Totéž pro sloty, které config.xml pevně přiřazuje připojeným zařízením, která export nepoužívá. Slotu bez pevně přiřazeného zařízení se export nedotkne: jeho zařízení není známé. |
Menu X4 přiřazuje některé ovládací prvky společně: "Toggle Travel Mode" nastaví stejný vstup i uvnitř mapy, "Dock" také odpojuje. JoyPro takové skupiny zapisuje a odstraňuje stejně jako menu a nikdy neodstraní dvojče "Interact" z pohledu první osoby.
#Čeho se nikdy nedotkne
- Ovládací prvky menu, mapy, pohledu první osoby, možností a přístupnosti; položky kruhového menu.
- Řádky klávesnice a myši; klávesnice se zapisuje jen s možností klávesnice, jen pro letové ovládací prvky, nikdy s klávesami, které menu X4 odmítá (Escape, Delete, Ctrl+X/C/V ...).
- Sloty zařízení, která nejsou připojená nebo pevně přiřazená, gamepady, zařízení ignorovaná při importu a zařízení vJoy, do kterého JoyPro tuneluje.
- Každý řádek
<config>, který JoyPro nenastavuje.
#Křivky a nastavení hry
- Granularita: jedna sada přiřazení pro všechny lodě (ovládání letu ve vesmíru).
- Invertování je jedna hodnota na ovládací prvek pro všechna zařízení (
invert_steering_yaw,_pitch,_roll,invert_throttle,invert_strafe_*). Vaše relace si zachová směr podle DCS; vlastní mapy HOTAS v X4 počítají pitch, roll a plyn jako invertované, proto JoyPro u nich nastaví parametr na vaše invertování obrácené. Parametr nastaví jen tehdy, když se na něm shodnou všechny osy JoyPro na tomto prvku. - Obousměrný plyn se řídí volbou Posuvník relace plynu: Posuvník = jen dopředu, bez Posuvníku = střed je nulový tah.
- Mrtvá zóna: X4 má jednu mrtvou zónu pro všechny osy všech joysticků. Mrtvé zóny relací se nezapisují (export to oznámí); mrtvou zónu hry nastavte v Nastavení > Nastavení zpětné vazby síly her (vyberte X4) nebo pomocí
engine ffb set. Na stejném místě je adaptivní řízení, vibrace, auto-roll a režim gamepadu. Nastavení, které tam uložíte, vyhraje nad relacemi, s varováním, když je obrací. - V X4 nejsou křivky ani saturace pro jednotlivé osy; žádná zpětná vazba síly; žádná telemetrie.
- Sledování: přiřazení nebo možnost, kterou změníte ve hře, se zaznamená po jejím zavření (
inputmap.xmlaconfig.xml) a JoyPro se zeptá, zda ji převzít. - HUD: HUD najde hru podle jejího procesu a ukazuje vaše přiřazení pro X4.
#X Rebirth a X3
X Rebirth používá stejná slova v inputmap.xml jako X4, ale jeho seznam příkazů by potřeboval vlastní extrakci z instalace. X3 (Reunion, Terran Conflict, Albion Prelude) má jiný engine a neznámý formát souborů. Obě jsou jen zdokumentované: JoyPro je neimportuje ani neexportuje.
#Uvnitř integrace X4
flowchart LR D["Vaše zařízení<br/>(GUID instance)"] --> C["config.xml<br/>joysticks"] C --> S["Pevně přiřazeno ke slotu:<br/>slot 1 ... 8"] C --> K["Nepřiřazeno nebo vypnuto:<br/>přeskočeno, přiřaďte ho<br/>jednou v X4"] P["Váš profil"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>přiřazení pro každý slot"] E --> O["možnosti pro celou hru:<br/>invertování, režim plynu"]
Kód: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs a model nastavení engine\FfbModels\X4.cs.
- Sloty: přiřazení uvádí zdroj:
INPUT_SOURCE_JOYBUTTONS(tlačítka a hat) neboINPUT_SOURCE_JOYAXES, bez přípony pro slot 1 a s_2až_8pro ostatní.config.xmlpřiřazuje zařízení ke slotům podle instančního GUID DirectInput, zapsaného ve vlastní podobě X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00});num0 až 7 je slot,disabled="1"znamená žádný. JoyPro zapisuje jen do slotů, jejichž aktuální zapnutá položka odpovídá připojenému zařízení. - Kódy: tlačítka 1 až 11 používají názvy gamepadu z X4 (
INPUT_XBUTTON_A...BIGBUTTON), 12 až 64INPUT_XBUTTON_12...; hatINPUT_XBUTTON_DPAD_*(osm směrů); osyINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Rozsahy nedostanousgn. Klávesnice:INPUT_KEYCODE_<DIK>s_SHIFT/_CONTROL. - Seznam příkazů:
engine x4 refresh-dbnačtegameoptions.luaa anglickou textovou stránku z archivů.cat/.data tabulky názvů zX4.exe, jen ke čtení; 128 ovládacích prvků letu ve vesmíru (6 os, 122 tlačítek). Řádky zní jako "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)".engine x4 catalogho vypíše,engine x4 pathsukáže nalezené soubory. - 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. - Nastavení hry:
engine ffb set --device * --game X4 --param <key>=<value>; parametry se upravují na místě, chybějící se přidá jako poslední řádek<config>. Export bez přiřazení pro X4 přesto zapíše uložená nastavení.
#Známá omezení
- Zařízení bez pevně přiřazeného slotu se přeskočí; JoyPro je zatím sám nepřiřazuje.
- Modifikátory joysticku se nezapisují: jejich zápis v souboru zatím není potvrzený.
- 64 tlačítek, 8 os a jeden hat na zařízení; osm slotů, sdílených s gamepady.
- Vibrace: posuvník hry ukazuje hodnotu krát 100 useknutou (21 % se zobrazí jako 20); soubor uchovává přesnou hodnotu.
- Testy:
engine\tests\smoke\x4.ps1(také obnovení katalogu); ve hřetools\e2e\games\X4.ps1(přiřazení a matice režimů, ve vlastní složce profilu) atools\e2e\games\X4Settings.ps1(invertování, režim plynu, nastavení hry).
Všechny technické poznámky k této hře (vygenerované z repozitáře): x4.md.