JoyPro2 Discord GitHub
Hry

X-Plane 12 / 11

Zobrazit:

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.

Pro začátečníky

#Zprovozněte to ve 3 krocích

  1. Nastavit vše za mě
    na stránce Start
  2. Použít tato tlačítka
    nejdřív se podívejte na seznam
  3. 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

  1. 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.txt nainstalovaného X-Plane.
  2. Stiskněte Importovat na kartě a zvolte Přidat do mého profilu (X-Plane v tomto souboru nemá přiřazení klávesnice).
  3. Stiskněte Importovat nyní. Zobrazit moje relace otevře, co přišlo.
Stránka Start s vašimi hramiStránka Start s vašimi hrami
Stránka Start s vašimi hrami (Obrázky ukazují aplikaci v angličtině.)

#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

  1. 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.
  2. Otevřete Export. Každá nainstalovaná verze má vlastní kartu.
  3. 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ě.
Ve hře: Co uvidíte v X-Plane

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.
Pokročilé

#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í).
Technické podrobnosti

#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
Každá verze X-Plane má vlastní soubor předvoleb. Kalibrace a nulová zóna zůstávají na X-Plane.

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ů z Commands.txt (sim/flight_controls, engines, autopilot, lights ...; ne sim/view, operation, replay ...).
  • Import / export: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), totéž pro engine 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.ps1 projde 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.