JoyPro2 Discord GitHub
Gry

X4: Foundations

Pokaż:

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 w config.xml
Wejścia, które gra czyta
odczytuje 64 przyciski, 8 osi, 1 hat na joystick (zweryfikowane)
Lista poleceń z
tablice nazw z X4.exe i 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.

Dla początkujących

#Uruchom to w 3 krokach

  1. Ustaw wszystko za mnie
    na stronie Start
  2. Użyj tych przycisków
    najpierw obejrzyj listę
  3. 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.xml w miejscu, na miejscach Twoich urządzeń. Przypisania menu, widoku z pierwszej osoby, klawiatury i myszy zostają.

#Zaimportuj przypisania z X4

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

  1. Zamknij X4. Gra zapisuje inputmap.xml i config.xml na koniec sesji, więc JoyPro nie zapisuje, gdy gra działa.
  2. Otwórz Eksportuj i zaznacz kartę X4.
  3. 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.
W grze: Co widzisz w X4

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.
Zaawansowane

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

Szczegóły techniczne

#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"]
X4 nazywa joystick według jego slotu. Urządzenie bez stałego slotu jest pomijane.

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) albo INPUT_SOURCE_JOYAXES, bez przyrostka dla slotu 1 i z _2 do _8 dla pozostałych. config.xml przypisuje 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}); num od 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 64 INPUT_XBUTTON_12 ...; hat INPUT_XBUTTON_DPAD_* (osiem kierunków); osie INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Zakresy nie dostają sgn. Klawiatura: INPUT_KEYCODE_<DIK> z _SHIFT / _CONTROL.
  • Lista poleceń: engine x4 refresh-db czyta gameoptions.lua i angielską stronę tekstów z archiwów .cat/.dat oraz tabele nazw z X4.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 catalog ją wyświetla, engine x4 paths pokazuje 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 grze tools\e2e\games\X4.ps1 (przypisania i macierz trybów, we własnym folderze profilu) i tools\e2e\games\X4Settings.ps1 (odwrócenia, tryb przepustnicy, ustawienia gry).

Wszystkie notatki techniczne o tej grze (wygenerowane z repozytorium): x4.md.