X-Plane trzyma przypisania wszystkich Twoich urządzeń w jednym pliku preferencji w swojej instalacji: "use" osi (pitch, throttle, flaps ...) dla każdej osi sprzętowej, polecenie dla każdego przycisku i opcjonalne krzywe odpowiedzi. JoyPro wczytuje ten plik do Twojego profilu, łączy go w relacjach z Twoimi innymi grami i zapisuje z powrotem, zmieniając tylko linie lotu, którymi zarządza. X-Plane 12 i X-Plane 11 to w JoyPro dwie gry, każda z własną instalacją, listą poleceń i ustawieniami; obie mogą być zainstalowane obok siebie.
X-Plane 12 natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine xplane12- Plik przypisań
Output\preferences\X-Plane Joystick Settings.prf,control profiles\*.prf(format wierszowy)- Wejścia, które gra czyta
- odczytuje 160 przycisków, 25 osi, 1 hat na joystick (zweryfikowane)
- Lista poleceń z
Resources\plugins\Commands.txt- Test w grze
- 33/33 kroków zaliczonych (2026-10-11)
- ✓ 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 grzeX-Plane 12: tylko przełącznik „control-loaded axes” dla każdego urządzenia, dla drążków z force feedback; symulator nie ma własnych efektów force feedback dla drążka (tylko wtyczki).
- ✗ Force feedback z telemetrii
- ✓ Nagrywanie telemetrii
- ✓ Wirtualny joystick (vJoy)
- ◐ Wirtualny pad Xbox
- ✓ Funkcje wirtualne
- ✓ Kreator konfiguracji / Autoprzypisanie
- ✓ Kokpity
- ✓ Ściągi
- ✓ Test w grze
X-Plane 11 natywnie (własne pliki przypisań)
- Obsługa
- natywnie (własne pliki przypisań)
- Polecenie silnika
engine xplane11- Plik przypisań
- jak X-Plane 12
- Wejścia, które gra czyta
- odczytuje 160 przycisków, 25 osi, 1 hat na joystick (zweryfikowane)
- Lista poleceń z
Resources\plugins\Commands.txt
- ✓ 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
X-Plane musi być zamknięty
Przed: uruchom raz X-Plane z podłączonymi urządzeniami, potem wyjdź.
Potem: skalibruj urządzenia w X-Plane (Settings > Joystick). Twoje przypisania też są tam widoczne.
Przypisywałeś już przyciski w X-Plane? 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 X-Plane
- Importuj: zastosowania osi, polecenia przycisków, flagi odwrócenia i krzywe odpowiedzi Twoich urządzeń trafiają do Twojego profilu.
- Relacje: jedna relacja to jedna funkcja we wszystkich Twoich grach ("Gear" w X-Plane, MSFS i DCS na tym samym przycisku). Polecenia lotu X-Plane pochodzą z jego własnego pliku
Commands.txt. - Eksportuj: JoyPro zapisuje preferencje joysticka wersji, którą eksportujesz. X-Plane pokazuje Twoje przypisania w Settings > Joystick.
#Zaimportuj przypisania z X-Plane
- Otwórz Start. Karta X-Plane 12 (lub X-Plane 11) pokazuje obraz gry. Jeśli prosi o listę poleceń, naciśnij Zbuduj listę: JoyPro odczyta
Resources\plugins\Commands.txtzainstalowanego X-Plane. - Naciśnij Importuj na karcie i wybierz Dodaj do mojego profilu (X-Plane nie ma w tym pliku przypisań klawiatury).
- Naciśnij Importuj teraz. Pokaż moje relacje otwiera to, co przyszło.


#Buduj i sprawdzaj relacje
Na stronie Relacje polecenie lub oś X-Plane w relacji stoi obok tej samej funkcji w Twoich innych grach. Użyj przebiegu relacji, żeby je połączyć, potem naciśnij Sprawdź teraz na stronie Eksport (Sprawdzanie).
#Eksport do X-Plane
- Zamknij X-Plane. Nadpisuje swoje preferencje, gdy zamyka się okno ustawień i przy wyjściu. Obie wersje działają jako
X-Plane.exe, więc JoyPro odmawia, gdy działa którakolwiek. - Otwórz Eksportuj. Każda zainstalowana wersja ma własną kartę.
- Zostaw Zastąp na moich urządzeniach razem z Wyczyść też moje inne urządzenia, jeśli to w JoyPro konfigurujesz swoje urządzenia. Naciśnij Eksportuj teraz na karcie.
Uruchom X-Plane i otwórz Settings > Joystick, potem wybierz urządzenie. Każda oś pokazuje zastosowanie zapisane przez JoyPro, przyciski pokazują swoje polecenia, a Edit Response Curve na osi pokazuje punkty i interpolację zapisane przez JoyPro.
#Co robisz sam w X-Plane
- Uruchom raz X-Plane z podłączonymi urządzeniami, potem z niego wyjdź. Wersja, która nigdy nie była uruchomiona, nie ma jeszcze pliku preferencji. Przy pierwszym uruchomieniu leci się samouczek, a X-Plane zapisuje preferencje joysticka przy wyjściu.
- Kalibruj w X-Plane. Kalibracja i strefa zerowa należą do X-Plane (Settings > Joystick); JoyPro nigdy ich nie zapisuje.
- Polecenia wtyczek i maszyn nie są na liście JoyPro: przypisz je w X-Plane, JoyPro ich nie rusza.
#Częste pułapki
- Oś nic nie robi ("Multiple axes assigned to yaw"): X-Plane ignoruje zastosowanie, które dzielą dwie podłączone osie. Eksport ostrzega; Wyczyść też moje inne urządzenia albo Zastąp czyści drugą oś.
- Przepustnica działa odwrotnie: X-Plane sam odwraca osie przepustnicy. JoyPro zapisuje Twoje odwrócenie bez zmian, więc zostaw odwrócenie wyłączone, chyba że Twoja dźwignia naprawdę działa w drugą stronę.
- Krzywa zrobiona w X-Plane się zmieniła: w trybach Aktualizuj i Tylko dodaj zostaje, gdy strojenie JoyPro jest liniowe (z ostrzeżeniem); „wygrywa mój profil” i Zastąp zapisują krzywą JoyPro.
#Pliki, które JoyPro czyta i zapisuje
| Plik | Co to jest |
|---|---|
<install>\Output\preferences\X-Plane Joystick Settings.prf |
bieżące przypisania wszystkich urządzeń (oparte na wierszach) |
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf |
zapisane profile sterowania, ten sam format |
<file>.joypro.json, <file>.joypro-meta.json |
wejścia i krzywe zapisane przez JoyPro; nazwy, grupy i strojenie na potrzeby następnego importu |
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt |
gdzie instalator X-Plane wymienia swoje instalacje (tylko do odczytu) |
X-Plane Keys.prf (klawiatura) nigdy nie jest dotykany. Wersja zainstalowana przez Steam i nigdy nieuruchomiona zostaje znaleziona w swoim folderze Steam. Inny folder ustawia się w Ustawienia > Gry.
#Tryby eksportu w X-Plane
| Tryb | Co dzieje się w X-Plane |
|---|---|
| Tylko dodaj | Tylko wolne wejścia. Przypisanie na wejściu z innym zastosowaniem lub poleceniem nie jest zapisywane i zostaje wymienione na liście; zastosowanie osi, które X-Plane ma na innej osi, tam zostaje (ostrzeżenie). |
| Aktualizuj, zachowaj przypisania gry | Zastępuje inne zastosowanie lub polecenie na Twoim wejściu i zachowuje wszystko inne; zastosowanie osi się przenosi (X-Plane ignoruje zastosowanie, które dzielą dwie osie). |
| Aktualizuj, wygrywa mój profil | Zwalnia też pozostałe osie i przyciski podłączonych urządzeń, które mają przypisywane przez Ciebie zastosowanie lub polecenie, razem z ich krzywymi. |
| Zastąp na moich urządzeniach | Zwalnia też każdą inną oś lotu i każde inne polecenie na zapisywanych urządzeniach. |
| + Wyczyść też moje inne urządzenia | Podłączone urządzenia, których nie zapisujesz, tracą swoje zastosowania lotu i polecenia. |
#Co nigdy nie jest ruszane
- Sloty urządzeń, które nie są podłączone, urządzenia ignorowane przy imporcie i urządzenie vJoy, do którego JoyPro przekazuje wejścia.
- Osie widoku, kamery, VR i własnych poleceń, polecenia wtyczek i maszyn, klawiatura.
- Klucze kalibracji (
_joy_center,_joy_null, surowe dane kalibracji),_eq_pfc_*i każdy inny wiersz.
#Krzywe i ustawienia
- Szczegółowość: jeden plik dla wszystkich maszyn (X-Plane potrafi łączyć maszyny z profilami sterowania; JoyPro zapisuje pliki, które znajdzie).
- Krzywe odpowiedzi (model osi
xplane): dowolna liczba punktów z LINEAR, CATMULL_ROM albo CUBIC_AVG oraz stałe zakresy osi przepustnicy, śmigła i mieszanki (beta, feather, cutoff, FADEC ...). Krzywa domyślna zmienia się w punkty; niezmieniona krzywa zachowuje swoje bajty. Strojenie można ustawić dla jednej wersji albo dla obu (family:xplane). - Odwrócenie:
_joy_rev_axis, Twoje odwrócenie bez zmian (X-Plane sam odwraca przepustnice). - Ustawienia gry (Ustawienia > Ustawienia force feedback gier): odpowiedź sterowania dla pitch, roll i yaw; w X-Plane 12 także osie drugiego pilota i "control-loaded axes" dla drążków z force feedback; w X-Plane 11 wspomaganie stateczności; w obu położenia klap. Zmieniane są tylko wiersze, które plik już ma.
- Force feedback: X-Plane nie ma własnego; jest tylko przełącznik control-loaded.
- Nagrywanie telemetrii: z wyjścia danych UDP X-Plane (port 49000), z pozycją, więc możliwy jest ślad dla Tacview.
- Obserwator: zmiany w preferencjach zostają zauważone po zamknięciu X-Plane (obserwator).
#Wewnątrz integracji X-Plane
flowchart LR P["Twój profil<br/>(relacje + przypisania)"] --> E["engine xplane12 export<br/>(albo xplane11)"] D["Sloty urządzeń<br/>VID:PID + ścieżka HID"] --> E E --> J["Output / preferences /<br/>X-Plane Joystick Settings.prf"] E --> C["control profiles /<br/>Name - Joysticks.prf"] J --> G["X-Plane: Settings > Joystick"] C --> G
Kod: engine\Games\XPlaneIntegration.cs (jedna instancja na wersję), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (profile sprzed podziału na dwie wersje są migrowane przy wczytaniu).
- Wiersze:
_joy_AXIS_use<i>(kod zastosowania),_joy_rev_axis<i>,_joy_BUTN_use<i>(ścieżka polecenia,sim/none/none= wolne),axis_response_curve<i>. Indeksy globalne: oś = slot × 25 + oś, przycisk = slot × 160 + przycisk. - Urządzenia: sloty
_joy_unique_id<slot> VID:<dec>PID:<dec>; przy identycznych urządzeniach ścieżka interfejsu HID z DirectInput musi być równa_joy_location<slot>. Przyciski to przyciski urządzenia, potem pierwszy hat jako 8 przycisków zgodnie z ruchem wskazówek zegara od góry; inne haty nie są mapowane. Odczytuje 160 przycisków i 25 osi na urządzenie. - Kody zastosowań: od 0 do 66 w obu wersjach; X-Plane 12 dodaje throttle 9, pitch/roll/yaw/hamulce/tiller drugiego pilota i oba hamulce kół. Kody od 74 do 77 i osie widoku nie są w katalogu.
- Lista poleceń:
engine xplane12 refresh-db/engine xplane11 refresh-db: tabela osi danej wersji plus grupy poleceń lotu zCommands.txt(sim/flight_controls,engines,autopilot,lights...; bezsim/view,operation,replay...). - Import / eksport:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), to samo dlaengine xplane11 export. Najpierw kopia zapasowa do.jpbak. - Ustawienia i krzywe:
engine ffb set--game XPlane12,engine binds tuning set--scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1,engine binds tuning preview(zmierzone w X-Plane 12.4.3 z dokładnością do 0.0001).
#Znane ograniczenia
- Znaczenie kodów zastosowań od 74 do 77; kolejność osi HID względem DirectInput jest wywnioskowana.
- Control Sensitivity w X-Plane bez krzywej nie jest uwzględnione w podglądzie.
- X-Plane 11 jest sprawdzony tylko z zainstalowanymi plikami; sprawdzenie w menu gry jeszcze czeka.
- Testy:
engine\tests\smoke\xplane.ps1; w grze (X-Plane 12) przypisania i krzywe odpowiedzi przeszły 33 z 33 kroków;tools\e2e\games\XPlaneCurves.ps1sprawdza każdą oś na całym zakresie względem podglądu JoyPro.
Wszystkie notatki techniczne o tej grze (wygenerowane z repozytorium): xplane.md.