X-Plane uchováva priradenia všetkých vašich zariadení v jednom súbore predvolieb vo svojej inštalácii: jedno "použitie" osi (klopenie, plyn, klapky ...) pre každú hardvérovú os, jeden príkaz pre každé tlačidlo a voliteľné krivky odozvy. JoyPro načíta tento súbor do vášho profilu, spojí ho s vašimi ostatnými hrami vo vzťahoch a zapíše ho späť, pričom mení iba letové riadky, ktoré spravuje. X-Plane 12 a X-Plane 11 sú v JoyPro dve hry, každá s vlastnou inštaláciou, zoznamom príkazov a nastaveniami; obe môžu byť nainštalované vedľa seba.
X-Plane 12 natívne (vlastné súbory väzieb)
- Podpora
- natívne (vlastné súbory väzieb)
- Príkaz nástroja
engine xplane12- Súbor väzieb
Output\preferences\X-Plane Joystick Settings.prf,control profiles\*.prf(po riadkoch)- Vstupy, ktoré hra číta
- číta 160 tlačidiel, 25 osí, 1 hat na joystick (overené)
- Zoznam príkazov z
Resources\plugins\Commands.txt- Test v hre
- 33/33 krokov splnených (2026-10-11)
- ✓ Importovať
- ✓ Export
- ✗ Väzby klávesnice
- ✗ Modifikátory
- ✓ Zoznam príkazov zostavený vo vašom PC
- ✓ Sledovanie hier
- ✓ Krivky osí a mŕtve zóny
- ✓ Nastavenia ovládania v hre
- ◐ Nastavenia Force Feedback v hreX-Plane 12: iba prepínač „control-loaded axes“ pre každé zariadenie pri pákach s Force Feedback; simulátor nemá vlastné efekty Force Feedback pre páku (iba pluginy).
- ✗ Force Feedback z telemetrie
- ✓ Záznam telemetrie
- ✓ Virtuálny joystick (vJoy)
- ◐ Virtuálny gamepad Xbox
- ✓ Virtuálne funkcie
- ✓ Sprievodca nastavením / Automatické priradenie
- ✓ Kokpity
- ✓ Ťaháky
- ✓ Test v hre
X-Plane 11 natívne (vlastné súbory väzieb)
- Podpora
- natívne (vlastné súbory väzieb)
- Príkaz nástroja
engine xplane11- Súbor väzieb
- rovnako ako X-Plane 12
- Vstupy, ktoré hra číta
- číta 160 tlačidiel, 25 osí, 1 hat na joystick (overené)
- Zoznam príkazov z
Resources\plugins\Commands.txt
- ✓ Importovať
- ✓ Export
- ✗ Väzby klávesnice
- ✗ Modifikátory
- ✓ Zoznam príkazov zostavený vo vašom PC
- ✓ Sledovanie hier
- ✓ Krivky osí a mŕtve zóny
- ✓ Nastavenia ovládania v hre
- ✗ Nastavenia Force Feedback v hre
- ✗ Force Feedback z telemetrie
- ✓ Záznam telemetrie
- ✓ Virtuálny joystick (vJoy)
- ◐ Virtuálny gamepad Xbox
- ✓ Virtuálne funkcie
- ✓ Sprievodca nastavením / Automatické priradenie
- ✓ Kokpity
- ✓ Ťaháky
- ✗ Test v hre
Z matice podpory, vygenerovanej z kódu nástroja: všetky hry.
#Spustite to v 3 krokoch
- Nastaviť všetko za mňa
na stránke Úvod - Použiť tieto tlačidlá
najprv si pozrite zoznam - Zapísať do mojej hry
X-Plane nechajte zatvorený
Pred: raz spustite X-Plane s pripojenými zariadeniami a potom ho ukončite.
Potom: skalibrujte svoje zariadenia v X-Plane (Settings > Joystick). Zobrazia sa tam aj vaše priradenia.
Priraďovali ste už tlačidlá v X-Plane? Potom vám Úvod ponúkne Importovať, potom doplniť medzery. Vaše väzby zostanú a nové úlohy dostanú iba voľné tlačidlá. Pozri Rýchly štart: rozbehať moju páku.
#Čo JoyPro robí pre X-Plane
- Importovať: použitia osí, príkazy tlačidiel, príznaky obrátenia a krivky odozvy vašich zariadení prejdú do vášho profilu.
- Vzťahy: jeden vzťah je jedna funkcia vo všetkých vašich hrách ("Gear" v X-Plane, MSFS aj DCS na tom istom tlačidle). Letové príkazy X-Plane pochádzajú z jeho vlastného
Commands.txt. - Export: JoyPro zapíše nastavenia joysticku tej verzie, do ktorej exportujete. X-Plane ukazuje vaše priradenia v Settings > Joystick.
#Importujte svoje priradenia z X-Plane
- Otvorte Štart. Karta X-Plane 12 (alebo X-Plane 11) ukazuje obrázok hry. Ak žiada zoznam príkazov, stlačte Zostaviť zoznam: JoyPro načíta
Resources\plugins\Commands.txtnainštalovaného X-Plane. - Na karte stlačte Importovať a zvoľte Pridať do môjho profilu (X-Plane v tomto súbore nemá väzby klávesnice).
- Stlačte Importovať teraz. Zobraziť moje vzťahy otvorí, čo prišlo.


#Vytvorte a skontrolujte vzťahy
Na stránke Vzťahy je príkaz alebo os X-Plane daného vzťahu vedľa tej istej funkcie vo vašich ostatných hrách. Spojte ich pomocou postupu vzťahov a potom na stránke Export stlačte Skontrolovať teraz (kontrola).
#Export do X-Plane
- Zatvorte X-Plane. Svoje predvoľby prepíše pri zatvorení okna nastavení a pri ukončení. Obe verzie bežia ako
X-Plane.exe, preto JoyPro odmietne zapisovať, kým beží ktorákoľvek z nich. - Otvorte Export. Každá nainštalovaná verzia má vlastnú kartu.
- Ponechajte Nahradiť na mojich zariadeniach s Vymazať aj moje ostatné zariadenia, ak svoje zariadenia nastavujete v JoyPro. Na karte stlačte Exportovať teraz.
Spustite X-Plane, otvorte Settings > Joystick a vyberte svoje zariadenie. Každá os ukazuje použitie, ktoré JoyPro zapísal, tlačidlá ukazujú svoje príkazy a Edit Response Curve pri osi ukazuje body a interpoláciu, ktoré JoyPro zapísal.
#Čo urobíte sami v X-Plane
- Raz spustite X-Plane s pripojenými zariadeniami a potom ho ukončite. Verzia, ktorá sa nikdy nespustila, ešte nemá súbor predvolieb. Pri úplne prvom spustení sa letí výukový let a X-Plane zapíše nastavenia joysticku pri ukončení.
- Kalibrujte v X-Plane. Kalibrácia a nulová zóna zostávajú na X-Plane (Settings > Joystick); JoyPro ich nikdy nezapisuje.
- Príkazy pluginov a lietadiel nie sú v zozname JoyPro: priraďte ich v X-Plane, JoyPro ich nechá tak.
#Časté problémy
- Os nič nerobí ("Multiple axes assigned to yaw"): X-Plane ignoruje použitie, ktoré zdieľajú dve pripojené osi. Export upozorní; Vymazať aj moje ostatné zariadenia alebo Nahradiť vymaže druhú os.
- Plyn ide opačne: X-Plane obracia osi plynu sám. JoyPro zapíše vaše invertovanie bez zmeny, preto invertovanie nechajte vypnuté, pokiaľ vaša páka naozaj nejde opačným smerom.
- Krivka, ktorú ste vytvorili v X-Plane, sa zmenila: v režimoch Aktualizovať a Iba pridať zostane, keď je ladenie v JoyPro lineárne (s upozornením); "môj profil vyhráva" a Nahradiť zapíšu krivku z JoyPro.
#Súbory, ktoré JoyPro číta a zapisuje
| Súbor | Čo to je |
|---|---|
<install>\Output\preferences\X-Plane Joystick Settings.prf |
aktuálne priradenia všetkých zariadení (po riadkoch) |
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf |
uložené profily ovládania, rovnaký formát |
<file>.joypro.json, <file>.joypro-meta.json |
vstupy a krivky, ktoré JoyPro zapísal; názvy, skupiny a ladenie pre ďalší import |
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt |
kde inštalátor X-Plane uvádza svoje inštalácie (iba na čítanie) |
X-Plane Keys.prf (klávesnica) sa nikdy nemení. Verzia nainštalovaná cez Steam, ktorá ešte nebola spustená, sa nájde v jej priečinku Steam. Iný priečinok sa nastaví v Nastavenia > Hry.
#Režimy exportu v X-Plane
| Režim | Čo sa stane v X-Plane |
|---|---|
| Iba pridať | Iba voľné vstupy. Väzba na vstupe s iným použitím alebo príkazom sa nezapíše a uvedie sa v zozname; použitie osi, ktoré má X-Plane na inej osi, tam zostane (upozornenie). |
| Aktualizovať, ponechať väzby hry | Nahradí iné použitie alebo príkaz na vašom vstupe a všetko ostatné ponechá; použitie osi sa presunie (X-Plane ignoruje použitie, ktoré zdieľajú dve osi). |
| Aktualizovať, môj profil vyhráva | Navyše uvoľní ostatné osi a tlačidlá pripojených zariadení, ktoré majú použitie alebo príkaz, ktorý priradíte, aj s ich krivkami. |
| Nahradiť na mojich zariadeniach | Navyše uvoľní každú inú letovú os a príkaz na zariadeniach, do ktorých zapisujete. |
| + Vymazať aj moje ostatné zariadenia | Pripojené zariadenia, do ktorých nezapisujete, stratia svoje letové použitia a príkazy. |
#Čoho sa JoyPro nikdy nedotkne
- Sloty zariadení, ktoré nie sú pripojené, zariadenia ignorované pri importe a zariadenie vJoy, do ktorého JoyPro posiela vstupy.
- Osi pohľadu, kamery, VR a vlastných príkazov, príkazy pluginov a lietadiel, klávesnica.
- Kalibračné kľúče (
_joy_center,_joy_null, surové kalibračné dáta),_eq_pfc_*a každý iný riadok.
#Krivky a nastavenia
- Granularita: jeden súbor pre všetky lietadlá (X-Plane môže lietadlá prepojiť s profilmi ovládania; JoyPro zapisuje súbory, ktoré nájde).
- Krivky odozvy (model osi
xplane): ľubovoľný počet bodov s LINEAR, CATMULL_ROM alebo CUBIC_AVG a pevné rozsahy osí plynu, vrtule a zmesi (beta, feather, cutoff, FADEC ...). Predvolená krivka sa zmení na body; nezmenená krivka si ponechá svoje bajty. Ladenie sa dá nastaviť pre jednu verziu alebo pre obe (family:xplane). - Obrátenie:
_joy_rev_axis, vaše invertovanie bez zmeny (X-Plane obracia plyn sám). - Nastavenia hry (Nastavenia > Nastavenia Force Feedback hier): odozva ovládania pre pitch, roll a yaw; X-Plane 12 aj osi druhého pilota a „control-loaded axes“ pre páky s Force Feedback; X-Plane 11 stabilizáciu (stability augmentation); obe aretácie klapiek. Menia sa iba riadky, ktoré súbor už obsahuje.
- Force feedback: X-Plane nemá vlastný; iba prepínač control-loaded.
- Záznam telemetrie: z UDP dátového výstupu X-Plane (port 49000), s polohou, takže je možná stopa pre Tacview.
- Sledovanie: zmeny v predvoľbách JoyPro zaznamená po zatvorení X-Plane (sledovanie hier).
#Ako funguje integrácia X-Plane
flowchart LR P["Váš profil<br/>(vzťahy + väzby)"] --> E["engine xplane12 export<br/>(alebo xplane11)"] D["Sloty zariadení<br/>VID:PID + cesta 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
Kód: engine\Games\XPlaneIntegration.cs (jedna inštancia na verziu), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (profily spred rozdelenia na dve verzie sa pri načítaní migrujú).
- Riadky:
_joy_AXIS_use<i>(kód použitia),_joy_rev_axis<i>,_joy_BUTN_use<i>(cesta príkazu,sim/none/none= voľné),axis_response_curve<i>. Globálne indexy: os = slot × 25 + os, tlačidlo = slot × 160 + tlačidlo. - Zariadenia: sloty
_joy_unique_id<slot> VID:<dec>PID:<dec>; pri rovnakých zariadeniach sa cesta rozhrania HID v DirectInput musí rovnať_joy_location<slot>. Tlačidlá sú tlačidlá zariadenia, potom prvý Hat ako 8 tlačidiel v smere hodinových ručičiek od hora; ostatné Haty sa nemapujú. Na zariadenie číta 160 tlačidiel a 25 osí. - Kódy použitia: 0 až 66 v oboch verziách; X-Plane 12 pridáva plyn 9, pitch/roll/yaw/brzdy/riadenie predného kolesa druhého pilota a obe brzdy kolies. Kódy 74 až 77 a osi pohľadu nie sú v katalógu.
- Zoznam príkazov:
engine xplane12 refresh-db/engine xplane11 refresh-db: tabuľka osí danej verzie plus skupiny letových príkazov zCommands.txt(sim/flight_controls,engines,autopilot,lights...; niesim/view,operation,replay...). - Import / export:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), to isté preengine xplane11 export. Najprv záloha do.jpbak. - Nastavenia a krivky:
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(zmerané v X-Plane 12.4.3 s presnosťou 0.0001).
#Známe obmedzenia
- Význam kódov použitia 74 až 77; poradie osí HID oproti DirectInput je odvodené.
- Control Sensitivity v X-Plane bez krivky nie je v náhľade.
- X-Plane 11 je overený iba voči svojim nainštalovaným súborom; kontrola v menu hry ešte čaká.
- Testy:
engine\tests\smoke\xplane.ps1; v hre (X-Plane 12) väzby a krivky odozvy prešli 33 z 33 krokov;tools\e2e\games\XPlaneCurves.ps1prejde každú os a porovná ju s náhľadom JoyPro.
Všetky technické poznámky k tejto hre (vygenerované z repozitára): xplane.md.