X-Plane drží přiřazení všech vašich zařízení v jednom souboru předvoleb uvnitř své instalace: "použití" osy (klopení, plyn, klapky ...) pro každou hardwarovou osu, příkaz pro každé tlačítko a volitelné křivky odezvy. JoyPro načte tento soubor do vašeho profilu, spojí ho s vašimi dalšími hrami v relacích a zapíše ho zpět, přičemž změní jen letové řádky, které spravuje. X-Plane 12 a X-Plane 11 jsou v JoyPro dvě hry, každá s vlastní instalací, seznamem příkazů a nastavením; obě mohou být nainstalované vedle sebe.
X-Plane 12 nativně (vlastní soubory přiřazení)
- Podpora
- nativně (vlastní soubory přiřazení)
- Příkaz enginu
engine xplane12- Soubor přiřazení
Output\preferences\X-Plane Joystick Settings.prf,control profiles\*.prf(po řádcích)- Vstupy, které hra čte
- čte 160 tlačítek, 25 os, 1 hat na joystick (ověřeno)
- Seznam příkazů z
Resources\plugins\Commands.txt- Herní test
- 33/33 kroků splněno (2026-10-11)
- ✓ Importovat
- ✓ Export
- ✗ Přiřazení klávesnice
- ✗ Modifikátory
- ✓ Seznam příkazů sestavený na vašem PC
- ✓ Sledování her
- ✓ Křivky os a mrtvé zóny
- ✓ Nastavení ovládání hry
- ◐ Herní nastavení zpětné vazby sílyX-Plane 12: jen přepínač „control-loaded axes“ pro každé zařízení u ovladačů se zpětnou vazbou síly; simulátor nemá vlastní efekty zpětné vazby síly pro ovladač (jen pluginy).
- ✗ Zpětná vazba síly z telemetrie
- ✓ Záznam telemetrie
- ✓ Virtuální joystick (vJoy)
- ◐ Virtuální gamepad Xbox
- ✓ Virtuální funkce
- ✓ Průvodce nastavením / Automatické přiřazení
- ✓ Kokpity
- ✓ Taháky
- ✓ Herní test
X-Plane 11 nativně (vlastní soubory přiřazení)
- Podpora
- nativně (vlastní soubory přiřazení)
- Příkaz enginu
engine xplane11- Soubor přiřazení
- stejně jako X-Plane 12
- Vstupy, které hra čte
- čte 160 tlačítek, 25 os, 1 hat na joystick (ověřeno)
- Seznam příkazů z
Resources\plugins\Commands.txt
- ✓ Importovat
- ✓ Export
- ✗ Přiřazení klávesnice
- ✗ Modifikátory
- ✓ Seznam příkazů sestavený na vašem PC
- ✓ Sledování her
- ✓ Křivky os a mrtvé zóny
- ✓ Nastavení ovládání hry
- ✗ Herní nastavení zpětné vazby síly
- ✗ Zpětná vazba síly z telemetrie
- ✓ Záznam telemetrie
- ✓ Virtuální joystick (vJoy)
- ◐ Virtuální gamepad Xbox
- ✓ Virtuální funkce
- ✓ Průvodce nastavením / Automatické přiřazení
- ✓ Kokpity
- ✓ Taháky
- ✗ Herní test
Z matice podpory, vygenerované z kódu enginu: všechny hry.
#Zprovozněte to ve 3 krocích
- Nastavit vše za mě
na stránce Start - Použít tato tlačítka
nejdřív se podívejte na seznam - Zapsat do mé hry
mějte X-Plane zavřený
Před: jednou spusťte X-Plane s připojenými zařízeními, pak ho ukončete.
Pak: zkalibrujte svá zařízení v X-Plane (Settings > Joystick). Ukazují se tam i vaše přiřazení.
Přiřazovali jste tlačítka v X-Plane už dříve? Pak stránka Start nabídne Importovat, pak doplnit mezery. Vaše přiřazení zůstanou a nové úkoly dostanou jen volná tlačítka. Viz Rychlý start: zprovoznit můj ovladač.
#Co JoyPro dělá pro X-Plane
- Importovat: použití os, příkazy tlačítek, příznaky obrácení a křivky odezvy vašich zařízení přijdou do vašeho profilu.
- Relace: jedna relace je jedna funkce ve všech vašich hrách ("Gear" v X-Plane, MSFS a DCS na stejném tlačítku). Letové příkazy X-Plane pocházejí z jeho vlastního
Commands.txt. - Export: JoyPro zapíše předvolby joysticku té verze, kterou exportujete. X-Plane ukazuje vaše přiřazení v Settings > Joystick.
#Import přiřazení z X-Plane
- Otevřete Start. Karta X-Plane 12 (nebo X-Plane 11) ukazuje obrázek hry. Pokud žádá seznam příkazů, stiskněte Sestavit seznam: JoyPro načte
Resources\plugins\Commands.txtnainstalovaného X-Plane. - Stiskněte Importovat na kartě a zvolte Přidat do mého profilu (X-Plane v tomto souboru nemá přiřazení klávesnice).
- Stiskněte Importovat nyní. Zobrazit moje relace otevře, co přišlo.


#Vytvořte a zkontrolujte relace
Na stránce Relace stojí příkaz nebo osa X-Plane u relace vedle stejné funkce ve vašich dalších hrách. Spojte je pomocí postupu relací, pak stiskněte Zkontrolovat nyní na stránce Export (Kontrola).
#Export do X-Plane
- Zavřete X-Plane. Své předvolby přepíše, když se zavře okno nastavení a při ukončení. Obě verze běží jako
X-Plane.exe, takže JoyPro odmítne, dokud běží kterákoli z nich. - Otevřete Export. Každá nainstalovaná verze má vlastní kartu.
- Ponechte Nahradit na mých zařízeních s Vymazat i má ostatní zařízení, pokud svá zařízení nastavujete v JoyPro. Stiskněte Exportovat nyní na kartě.
Spusťte X-Plane, otevřete Settings > Joystick a vyberte své zařízení. Každá osa ukazuje použití, které JoyPro zapsal, tlačítka ukazují své příkazy a Edit Response Curve u osy ukazuje body a interpolaci, které JoyPro zapsal.
#Co v X-Plane uděláte sami
- Jednou spusťte X-Plane s připojenými zařízeními, pak ho ukončete. Verze, která nikdy nebyla spuštěna, ještě nemá soubor předvoleb. Úplně první spuštění zahájí výukový let a X-Plane zapíše své předvolby joysticku při ukončení.
- Kalibrujte v X-Plane. Kalibrace a nulová zóna zůstávají věcí X-Plane (Settings > Joystick); JoyPro je nikdy nezapisuje.
- Příkazy pluginů a letounů nejsou v seznamu JoyPro: přiřaďte je v X-Plane, JoyPro je nechá být.
#Časté chyby
- Osa nic nedělá ("Multiple axes assigned to yaw"): X-Plane ignoruje použití, které sdílejí dvě připojené osy. Export upozorní; Vymazat i má ostatní zařízení nebo Nahradit vymaže tu druhou osu.
- Plyn jde obráceně: X-Plane obrací osy plynu sám. JoyPro zapíše vaši inverzi beze změny, takže nechte inverzi vypnutou, pokud vaše páka opravdu nejde opačně.
- Křivka, kterou jste vytvořili v X-Plane, se změnila: v režimech Aktualizovat a Pouze přidat zůstane, když je ladění v JoyPro lineární (s varováním); "vyhraje můj profil" a Nahradit zapíšou křivku z JoyPro.
#Soubory, které JoyPro čte a zapisuje
| Soubor | Co to je |
|---|---|
<install>\Output\preferences\X-Plane Joystick Settings.prf |
aktuální přiřazení všech zařízení (po řádcích) |
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf |
uložené profily ovládání, stejný formát |
<file>.joypro.json, <file>.joypro-meta.json |
vstupy a křivky, které JoyPro zapsal; názvy, skupiny a ladění pro příští import |
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt |
kde instalátor X-Plane uvádí své instalace (jen ke čtení) |
X-Plane Keys.prf (klávesnice) se nikdy nedotkne. Verze nainstalovaná přes Steam a nikdy nespuštěná se najde ve své složce Steam. Jinou složku nastavíte v Nastavení > Hry.
#Režimy exportu v X-Plane
| Režim | Co se stane v X-Plane |
|---|---|
| Pouze přidat | Jen volné vstupy. Přiřazení na vstupu s jiným použitím nebo příkazem se nezapíše a uvede se v seznamu; použití osy, které má X-Plane na jiné ose, tam zůstane (varování). |
| Aktualizovat, ponechat přiřazení hry | Nahradí jiné použití nebo příkaz na vašem vstupu a vše ostatní ponechá; použití osy se přesune (X-Plane ignoruje použití, které sdílejí dvě osy). |
| Aktualizovat, vyhraje můj profil | Navíc uvolní ostatní osy a tlačítka připojených zařízení, která mají použití nebo příkaz, který přiřazujete, i s jejich křivkami. |
| Nahradit na mých zařízeních | Navíc uvolní všechny ostatní letové osy a příkazy na zařízeních, která zapisujete. |
| + Vymazat i má ostatní zařízení | Připojená zařízení, která nezapisujete, přijdou o svá letová použití a příkazy. |
#Čeho se nikdy nedotkne
- Sloty zařízení, která nejsou připojená, zařízení ignorovaná při importu a zařízení vJoy, do kterého JoyPro tuneluje.
- Osy pohledu, kamery, VR a vlastních příkazů, příkazy pluginů a letounů, klávesnice.
- Kalibrační klíče (
_joy_center,_joy_null, nezpracovaná kalibrační data),_eq_pfc_*a každý další řádek.
#Křivky a nastavení
- Granularita: jeden soubor pro všechny letouny (X-Plane umí propojit letouny s profily ovládání; JoyPro zapisuje soubory, které najde).
- Křivky odezvy (model os
xplane): libovolný počet bodů s LINEAR, CATMULL_ROM nebo CUBIC_AVG a pevné rozsahy os plynu, vrtule a směsi (beta, feather, cutoff, FADEC ...). Výchozí křivka se převede na body; nezměněná křivka si ponechá své bajty. Ladění lze nastavit pro jednu verzi nebo pro obě (family:xplane). - Reverse:
_joy_rev_axis, vaše invertování beze změny (X-Plane obrací plyny sám). - Nastavení hry (Nastavení > Nastavení zpětné vazby síly her): odezva ovládání pro pitch, roll a yaw; X-Plane 12 navíc osy druhého pilota a "control-loaded axes" pro ovladače se zpětnou vazbou síly; X-Plane 11 stabilizační augmentaci; obě verze polohy klapek. Mění se jen řádky, které soubor už má.
- Force feedback: X-Plane nemá žádný vlastní; jen přepínač control-loaded.
- Záznam telemetrie: z datového výstupu UDP X-Plane (port 49000), s polohou, takže je možný záznam pro Tacview.
- Sledování: změny v předvolbách se zaznamenají po zavření X-Plane (sledování).
#Uvnitř integrace X-Plane
flowchart LR P["Váš profil<br/>(relace + přiřazení)"] --> E["engine xplane12 export<br/>(nebo xplane11)"] D["Sloty zařízení<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 instance pro každou verzi), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (profily z doby před rozdělením na dvě verze se při načtení převedou).
- Řádky:
_joy_AXIS_use<i>(kód použití),_joy_rev_axis<i>,_joy_BUTN_use<i>(cesta příkazu,sim/none/none= volné),axis_response_curve<i>. Globální indexy: osa = slot × 25 + osa, tlačítko = slot × 160 + tlačítko. - Zařízení: sloty
_joy_unique_id<slot> VID:<dec>PID:<dec>; u stejných zařízení se musí cesta rozhraní HID z DirectInput rovnat_joy_location<slot>. Tlačítka jsou tlačítka zařízení, pak první hat jako 8 tlačítek po směru hodinových ručiček od horní polohy; ostatní haty se nemapují. Čte 160 tlačítek a 25 os na zařízení. - Kódy použití: 0 až 66 v obou verzích; X-Plane 12 přidává plyn 9, pitch/roll/yaw/brzdy/řízení příďového kola druhého pilota a obě brzdy kol. Kódy 74 až 77 a osy pohledu nejsou v katalogu.
- Seznam příkazů:
engine xplane12 refresh-db/engine xplane11 refresh-db: tabulka os dané verze plus skupiny letových příkazů zCommands.txt(sim/flight_controls,engines,autopilot,lights...; nesim/view,operation,replay...). - Import / export:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), totéž proengine xplane11 export. Nejdřív záloha do.jpbak. - Nastavení a křivky:
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(změřeno v X-Plane 12.4.3 s přesností 0.0001).
#Známá omezení
- Význam kódů použití 74 až 77; pořadí os HID oproti DirectInput je odvozené.
- Control Sensitivity v X-Plane bez křivky není v náhledu.
- X-Plane 11 je ověřen jen podle svých nainstalovaných souborů; kontrola v menu hry zatím čeká.
- Testy:
engine\tests\smoke\xplane.ps1; ve hře (X-Plane 12) prošla přiřazení a křivky odezvy 33 z 33 kroků;tools\e2e\games\XPlaneCurves.ps1projde každou osu a porovná ji s náhledem JoyPro.
Všechny technické poznámky k této hře (vygenerované z repozitáře): xplane.md.