JoyPro2 Discord GitHub
Gry

X-Plane 12 / 11

Pokaż:

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.

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

  1. 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.txt zainstalowanego X-Plane.
  2. Naciśnij Importuj na karcie i wybierz Dodaj do mojego profilu (X-Plane nie ma w tym pliku przypisań klawiatury).
  3. Naciśnij Importuj teraz. Pokaż moje relacje otwiera to, co przyszło.
Strona Start z Twoimi gramiStrona Start z Twoimi grami
Strona Start z Twoimi grami (Obrazy pokazują aplikację po angielsku.)

#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

  1. 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.
  2. Otwórz Eksportuj. Każda zainstalowana wersja ma własną kartę.
  3. 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.
W grze: Co widzisz w X-Plane

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

#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).
Szczegóły techniczne

#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
Każda wersja X-Plane ma własny plik preferencji. Kalibracja i strefa zerowa należą do X-Plane.

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 z Commands.txt (sim/flight_controls, engines, autopilot, lights ...; bez sim/view, operation, replay ...).
  • Import / eksport: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), to samo dla engine 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.ps1 sprawdza każdą oś na całym zakresie względem podglądu JoyPro.

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