JoyPro2 Discord GitHub
Hry

X4: Foundations

Zobrazit:

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 v config.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.exe a 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.

Pro začátečníky

#Zprovozněte to ve 3 krocích

  1. Nastavit vše za mě
    na stránce Start
  2. Použít tato tlačítka
    nejdřív se podívejte na seznam
  3. 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.xml pří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

  1. 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í).
  2. 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.
  3. 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

  1. Zavřete X4. Hra zapisuje inputmap.xml a config.xml na konci relace hraní, takže JoyPro odmítne zapisovat, dokud běží.
  2. Otevřete Export a zaškrtněte kartu X4.
  3. 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ě.
Ve hře: Co uvidíte v X4

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í.
Pokročilé

#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.xml a config.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.

Technické podrobnosti

#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"]
X4 pojmenovává joystick podle jeho slotu. Zařízení bez pevného slotu se přeskočí.

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) nebo INPUT_SOURCE_JOYAXES, bez přípony pro slot 1 a s _2 až _8 pro ostatní. config.xml př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}); num 0 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ž 64 INPUT_XBUTTON_12 ...; hat INPUT_XBUTTON_DPAD_* (osm směrů); osy INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Rozsahy nedostanou sgn. Klávesnice: INPUT_KEYCODE_<DIK> s _SHIFT / _CONTROL.
  • Seznam příkazů: engine x4 refresh-db načte gameoptions.lua a anglickou textovou stránku z archivů .cat/.dat a tabulky názvů z X4.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 catalog ho vypíše, engine x4 paths ukáž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ře tools\e2e\games\X4.ps1 (přiřazení a matice režimů, ve vlastní složce profilu) a tools\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.