X4: Foundations trzyma Twoje przypisania w inputmap.xml i nazywa joystick według jego miejsca (1 do 8), a nie nazwy. Które urządzenie jest w którym miejscu, zapisane jest w config.xml. JoyPro wczytuje przypisania lotu kosmicznego do Twojego profilu i zapisuje je z powrotem w miejscu, na miejsca, które X4 przypiął do Twoich urządzeń. Odwrócenia i martwa strefa dotyczą w X4 całej gry, więc JoyPro ustawia je z Twoich relacji dla całej gry.
X4: Foundations natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine x4- Plik przypisań
Documents\Egosoft\X4\<id>\inputmap.xml(XML) + sloty wconfig.xml- Wejścia, które gra czyta
- odczytuje 64 przyciski, 8 osi, 1 hat na joystick (zweryfikowane)
- Lista poleceń z
- tablice nazw z
X4.exei archiwa.cat/.dat - Test w grze
- 36/36 kroków zaliczonych (2026-10-11)
- ✓ Importuj
- ✓ Eksportuj
- ✓ Przypisania klawiatury
- ◐ ModyfikatoryX4: Shift/Ctrl na przypisaniach klawiatury; przypisania joysticka nie przyjmują modyfikatora.
- ✓ Lista poleceń budowana na Twoim PC
- ✓ Obserwator gier
- ✗ Krzywe osi i martwe strefyX4: tylko ogólna martwa strefa gry i odwrócenia (Game settings), nic na przypisanie.
- ✓ Ustawienia sterowania w grze
- ✗ Ustawienia force feedback w grze
- ✗ Force feedback z telemetrii
- ✗ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ✓ Kreator konfiguracji / Autoprzypisanie
- ✓ Kokpity
- ✓ Ściągi
- ✓ Test w grze
X Rebirth tylko opisane
- Obsługa
- tylko opisane
- Polecenie silnika
- brak
- — Importuj
- — Eksportuj
- — Przypisania klawiatury
- — Modyfikatory
- — Lista poleceń budowana na Twoim PC
- — Obserwator gier
- — Krzywe osi i martwe strefy
- — Ustawienia sterowania w grze
- — Ustawienia force feedback w grze
- — Force feedback z telemetrii
- — Nagrywanie telemetrii
- — Wirtualny joystick (vJoy)
- — Wirtualny pad Xbox
- — Funkcje wirtualne
- — Kreator konfiguracji / Autoprzypisanie
- — Kokpity
- — Ściągi
- — Test w grze
X3 (Reunion, Terran Conflict, Albion Prelude) tylko opisane
- Obsługa
- tylko opisane
- Polecenie silnika
- brak
- — Importuj
- — Eksportuj
- — Przypisania klawiatury
- — Modyfikatory
- — Lista poleceń budowana na Twoim PC
- — Obserwator gier
- — Krzywe osi i martwe strefy
- — Ustawienia sterowania w grze
- — Ustawienia force feedback w grze
- — Force feedback z telemetrii
- — Nagrywanie telemetrii
- — Wirtualny joystick (vJoy)
- — Wirtualny pad Xbox
- — Funkcje wirtualne
- — Kreator konfiguracji / Autoprzypisanie
- — Kokpity
- — Ściągi
- — Test w grze
Z macierzy obsługi, wygenerowanej z kodu silnika: wszystkie gry.
#Uruchom to w 3 krokach
- Ustaw wszystko za mnie
na stronie Start - Użyj tych przycisków
najpierw obejrzyj listę - Zapisz w mojej grze
X4 musi być zamknięty
Przed: raz daj każdemu urządzeniu miejsce. W ustawieniach sterowania X4 otwórz Manage Controllers/Joysticks. Przydziel każde urządzenie do miejsca, potem normalnie wyjdź z gry.
Potem: Twoje przypisania są w Settings > Controls.
Przypisywałeś już przyciski w X4? Wtedy strona Start proponuje Importuj, potem wypełnij luki. Twoje przypisania zostają, a nowe zadania dostają tylko wolne przyciski. Zobacz Szybki start: niech mój drążek działa.
#Co JoyPro robi dla X4
- Importuj: przypisania lotu kosmicznego Twoich drążków, przepustnic i pedałów trafiają do Twojego profilu, z odwróceniami i trybem przepustnicy gry.
- Relacje: jedna relacja to jedna funkcja w każdej grze. "Boost" może być tym samym przyciskiem w X4, Elite Dangerous i Star Citizen.
- Eksportuj: JoyPro edytuje
inputmap.xmlw miejscu, na miejscach Twoich urządzeń. Przypisania menu, widoku z pierwszej osoby, klawiatury i myszy zostają.
#Zaimportuj przypisania z X4
- Otwórz Start. Jeśli karta X4 prosi o listę poleceń, naciśnij Zbuduj listę: JoyPro odczyta sterowanie gry z Twojej instalacji (tylko do odczytu).
- Naciśnij Importuj na karcie X4. Zostaw Dodaj do mojego profilu. Zaznacz Uwzględnij także klawisze klawiatury, jeśli chcesz mieć w JoyPro również klawisze lotu.
- Naciśnij Importuj teraz. Pokaż moje relacje otwiera to, co przyszło.
#Buduj i sprawdzaj relacje
Połącz tę samą funkcję Twoich gier za pomocą przebiegu relacji, potem naciśnij Sprawdź na stronie Eksport. Przypisania joysticka trzymaj bez modyfikatorów: X4 nie przyjmuje modyfikatora przy przypisaniu joysticka.
#Eksport do X4
- Zamknij X4. Gra zapisuje
inputmap.xmliconfig.xmlna koniec sesji, więc JoyPro nie zapisuje, gdy gra działa. - Otwórz Eksportuj i zaznacz kartę X4.
- Zostaw Zastąp na moich urządzeniach razem z Wyczyść też moje inne urządzenia, jeśli to w JoyPro konfigurujesz swoje drążki. Naciśnij Eksportuj teraz na karcie.
Uruchom grę i otwórz Settings > Controls. Twoje przypisania są w kolumnie kontrolera / joysticka każdego elementu sterowania lotem kosmicznym, na miejscu Twojego urządzenia. Invert Controller / Joystick Axes pokazuje odwrócenia ustawione przez JoyPro, a wiersze przepustnicy dwukierunkowej, martwej strefy joysticka i sterowania adaptacyjnego pokazują Twoje wartości. Auto-roll i wibracje są w ustawieniach gry.
#Co robisz sam w X4
- Raz daj każdemu urządzeniu miejsce. W ustawieniach sterowania X4 otwórz Manage Controllers/Joysticks i przydziel do miejsca każdy drążek, przepustnicę i zestaw pedałów, potem normalnie wyjdź z gry. X4 zapamięta wtedy urządzenie w
config.xml. Urządzenie bez takiego wpisu przechodzi między miejscami z sesji na sesję, więc JoyPro je pomija ("assign the device to a slot in X4 once"). Urządzenie ustawione tam na "none" też jest pomijane. - Podłącz urządzenia przed eksportem.
#Częste pułapki
- „X4 działa”: wyjdź z gry i eksportuj ponownie.
- Urządzenie zostało pominięte: nie jest przypięte do miejsca w X4. Przydziel je w Manage Controllers/Joysticks.
- Drążek w miejscu 1 robi rzeczy gamepada: miejsce 1 to miejsce gamepada w domyślnej mapie X4, więc drążek w nim dziedziczy standardowe przypisania gamepada. Zastąp na moich urządzeniach je usuwa.
- Przyciski powyżej 64 albo drugi hat nic nie robią: X4 odczytuje 64 przyciski, 8 osi i jeden hat na urządzenie. JoyPro pomija przypisania ponad to z ostrzeżeniem.
- Odwrócenie nie zostało zmienione: jedno odwrócenie dotyczy każdego urządzenia na tym elemencie sterowania. Gdy Twoje relacje się nie zgadzają albo gamepad jest przypisany do tego samego elementu, JoyPro zostawia wartość gry i ostrzega.
#Pliki, które JoyPro czyta i zapisuje
| Plik | Co to jest |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
aktywne przypisania (<action>, <state>, <range> dla każdego sterowania i wejścia) i parametry <config> (odwrócenia, martwa strefa, dwukierunkowa przepustnica, adaptacyjne sterowanie). <id> to folder konta Steam. |
...\X4\<id>\config.xml |
sloty urządzeń (<joysticks>) i ustawienia gry, takie jak wibracje, auto-roll i tryb gamepada; odczytywany dla slotów, edytowany na miejscu dla ustawień |
...\X4\<id>\inputmap.xml.joypro-meta.json |
nazwy, grupy i strojenie zapisanych przypisań z JoyPro, odczytywane z powrotem przez następny import |
inputmap.xml.jpbak, config.xml.jpbak |
kopie sprzed pierwszego zapisu oraz wersjonowany magazyn kopii zapasowych JoyPro |
Plik jest zapisywany jako tekst: deklaracja, końce wierszy, wcięcia, komentarze sekcji, <config>, atrybuty korzenia i każdy nietknięty wiersz zostają bajt w bajt. Nowy wiersz trafia do swojej sekcji po ostatnim wpisie tego samego rodzaju z niższym numerem sterowania. JoyPro nigdy nie dotyka zapisanych profili od inputmap_1.xml do inputmap_5.xml ani Twoich zapisów gry. Steam Cloud synchronizuje folder; które pliki synchronizuje, nie jest jeszcze potwierdzone.
#Tryby eksportu w X4
Konflikt to inne sterowanie lotem na tym samym slocie i wejściu. Bliźniacze wersje sterowania dla mapy i monitora szczegółów liczą się jako to samo sterowanie.
| Tryb | Co dzieje się w inputmap.xml |
|---|---|
| Tylko dodaj | Nic nie jest usuwane. Przypisanie, którego wejście ma inne sterowanie lotem, nie jest zapisywane i dostaje oznaczenie "Nie zapisano w grze". |
| Aktualizuj, zachowaj przypisania gry | Twoje wiersze trafiają obok pozostałych wejść danego sterowania; usuwane są tylko konflikty. |
| Aktualizuj, wygrywa mój profil | Jak wyżej, a dodatkowo przypisane przez Ciebie sterowanie traci swoje pozostałe wiersze na przypiętych slotach podłączonych urządzeń (z opcją klawiatury także swoje wiersze klawiatury). |
| Zastąp na moich urządzeniach | Przypisania lotu w zapisanych slotach, których nie ma w Twoim profilu, zostają usunięte, także fabryczne przypisania lotu gamepada na slocie 1. |
| + Wyczyść też moje inne urządzenia | To samo dla slotów, które config.xml przypina do podłączonych urządzeń nieużywanych przez eksport. Slot bez przypiętego urządzenia zostaje w spokoju: jego urządzenie jest nieznane. |
Menu X4 wiąże niektóre sterowania razem: "Toggle Travel Mode" ustawia to samo wejście także na mapie, "Dock" także oddokowuje. JoyPro zapisuje i usuwa takie grupy tak jak menu i nigdy nie usuwa bliźniaczej akcji "Interact" z widoku pierwszoosobowego.
#Co nigdy nie jest ruszane
- Sterowanie menu, mapy, widoku pierwszoosobowego, opcji i dostępności; wpisy menu kołowego.
- Wiersze klawiatury i myszy; klawiatura jest zapisywana tylko z opcją klawiatury, tylko dla sterowania lotem, nigdy z klawiszami, które menu X4 odrzuca (Escape, Delete, Ctrl+X/C/V ...).
- Sloty urządzeń, które nie są podłączone lub nie są przypięte, gamepady, urządzenia ignorowane przy imporcie i urządzenie vJoy, do którego JoyPro przekazuje wejścia.
- Każdy wiersz
<config>, którego JoyPro nie ustawia.
#Krzywe i ustawienia gry
- Szczegółowość: jeden zestaw przypisań dla każdego statku (sterowanie lotem w kosmosie).
- Odwrócenia to jedna wartość na sterowanie dla każdego urządzenia (
invert_steering_yaw,_pitch,_roll,invert_throttle,invert_strafe_*). Twoja relacja zachowuje kierunek DCS; własne mapy HOTAS w X4 traktują pitch, roll i throttle jako odwrócone, więc dla nich JoyPro ustawia parametr na odwrotność Twojego odwrócenia. Ustawia parametr tylko wtedy, gdy każda oś JoyPro na tym sterowaniu się zgadza. - Dwukierunkowa przepustnica podąża za opcją Suwak relacji przepustnicy: Suwak = tylko do przodu, bez Suwaka = środek to zerowy ciąg.
- Martwa strefa: X4 ma jedną martwą strefę dla każdej osi każdego joysticka. Martwe strefy relacji nie są zapisywane (eksport to mówi); ustaw martwą strefę gry w Ustawienia > Ustawienia force feedback gier (wybierz X4) albo przez
engine ffb set. To samo miejsce zawiera adaptacyjne sterowanie, wibracje, auto-roll i tryb gamepada. Ustawienie zapisane tam wygrywa z relacjami, z ostrzeżeniem, gdy je odwraca. - Brak krzywych i nasycenia dla poszczególnych osi w X4; brak force feedback; brak telemetrii.
- Obserwator: przypisanie lub opcja zmieniona przez Ciebie w grze zostaje zauważona po jej zamknięciu (
inputmap.xmliconfig.xml), a JoyPro pyta, czy ją przejąć. - HUD: HUD rozpoznaje grę po jej procesie i pokazuje Twoje przypisania X4.
#X Rebirth i X3
X Rebirth używa tych samych słów w inputmap.xml co X4, ale jego lista poleceń wymagałaby osobnego wyodrębnienia z instalacji. X3 (Reunion, Terran Conflict, Albion Prelude) ma inny silnik i nieznany format pliku. Obie gry są tylko opisane: JoyPro ich nie importuje ani nie eksportuje.
#Wewnątrz integracji X4
flowchart LR D["Twoje urządzenie<br/>(GUID instancji)"] --> C["config.xml<br/>joysticki"] C --> S["Przypięte do slotu:<br/>slot 1 ... 8"] C --> K["Nieprzypięte lub wyłączone:<br/>pomijane, przypisz je<br/>raz w X4"] P["Twój profil"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>przypisania dla każdego slotu"] E --> O["opcje całej gry:<br/>odwrócenia, tryb przepustnicy"]
Kod: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs i model ustawień engine\FfbModels\X4.cs.
- Sloty: przypisanie wskazuje źródło:
INPUT_SOURCE_JOYBUTTONS(przyciski i hat) alboINPUT_SOURCE_JOYAXES, bez przyrostka dla slotu 1 i z_2do_8dla pozostałych.config.xmlprzypisuje urządzenia do slotów według GUID instancji DirectInput, zapisanego we własnej formie X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00});numod 0 do 7 to slot,disabled="1"oznacza brak. JoyPro zapisuje tylko do slotów, których bieżący, włączony wpis pasuje do podłączonego urządzenia. - Kody: przyciski od 1 do 11 używają nazw gamepada z X4 (
INPUT_XBUTTON_A...BIGBUTTON), od 12 do 64INPUT_XBUTTON_12...; hatINPUT_XBUTTON_DPAD_*(osiem kierunków); osieINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Zakresy nie dostająsgn. Klawiatura:INPUT_KEYCODE_<DIK>z_SHIFT/_CONTROL. - Lista poleceń:
engine x4 refresh-dbczytagameoptions.luai angielską stronę tekstów z archiwów.cat/.datoraz tabele nazw zX4.exe, tylko do odczytu; 128 elementów sterowania lotem w kosmosie (6 osi, 122 przyciski). Wiersze wyglądają tak: "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)".engine x4 catalogją wyświetla,engine x4 pathspokazuje znalezione pliki. - 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. - Ustawienia gry:
engine ffb set --device * --game X4 --param <key>=<value>; parametry są edytowane na miejscu, brakujący zostaje dodany jako ostatni wiersz<config>. Eksport bez przypisań X4 i tak zapisuje zapisane ustawienia.
#Znane ograniczenia
- Urządzenia bez przypiętego slotu są pomijane; JoyPro jeszcze sam ich nie przypina.
- Modyfikatory joysticka nie są zapisywane: ich zapis w pliku nie jest jeszcze potwierdzony.
- 64 przyciski, 8 osi i jeden hat na urządzenie; osiem slotów, wspólnych z gamepadami.
- Wibracje: suwak gry pokazuje wartość razy 100 z obciętą końcówką (21 % pokazuje się jako 20); plik zachowuje dokładną wartość.
- Testy:
engine\tests\smoke\x4.ps1(także odświeżenie katalogu); w grzetools\e2e\games\X4.ps1(przypisania i macierz trybów, we własnym folderze profilu) itools\e2e\games\X4Settings.ps1(odwrócenia, tryb przepustnicy, ustawienia gry).
Wszystkie notatki techniczne o tej grze (wygenerowane z repozytorium): x4.md.