JoyPro2 Discord GitHub
Spil

X-Plane 12 / 11

Vis:

X-Plane gemmer tildelingerne for alle dine enheder i én indstillingsfil i sin installation: en akse-"anvendelse" (pitch, throttle, flaps ...) pr. hardwareakse, en kommando pr. knap og valgfrie responskurver. JoyPro læser den fil ind i din profil, forbinder den med dine andre spil i relationer og skriver den tilbage, hvor den kun ændrer de flyvelinjer, den styrer. X-Plane 12 og X-Plane 11 er to spil i JoyPro, hver med sin egen installation, kommandoliste og indstillinger; begge kan være installeret side om side.

X-Plane 12 indbygget (egne tildelingsfiler)
Understøttelse
indbygget (egne tildelingsfiler)
Motorkommando
engine xplane12
Tildelingsfil
Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (linjebaseret)
Indgange, spillet læser
læser 160 knapper, 25 akser, 1 hat pr. joystick (verificeret)
Kommandoliste fra
Resources\plugins\Commands.txt
Test i spillet
33/33 trin bestået (2026-10-11)
  • ✓ Import
  • ✓ Eksport
  • ✗ Tastaturtildelinger
  • ✗ Modifikatorer
  • ✓ Kommandoliste bygget på din pc
  • ✓ Spilovervågning
  • ✓ Aksekurver og dødzoner
  • ✓ Spillets kontrolindstillinger
  • ◐ Force feedback-indstillinger i spilletX-Plane 12: kun kontakten "control-loaded axes" pr. enhed til force feedback-sticks; simulatoren har ingen egne force feedback-effekter til sticken (kun plugins).
  • ✗ Force feedback fra telemetri
  • ✓ Telemetrioptagelse
  • ✓ Virtuel joystick (vJoy)
  • ◐ Virtuel Xbox-pad
  • ✓ Virtuelle funktioner
  • ✓ Opsætningsguide / Auto-tildeling
  • ✓ Cockpits
  • ✓ Snydeark
  • ✓ Test i spillet
X-Plane 11 indbygget (egne tildelingsfiler)
Understøttelse
indbygget (egne tildelingsfiler)
Motorkommando
engine xplane11
Tildelingsfil
som X-Plane 12
Indgange, spillet læser
læser 160 knapper, 25 akser, 1 hat pr. joystick (verificeret)
Kommandoliste fra
Resources\plugins\Commands.txt
  • ✓ Import
  • ✓ Eksport
  • ✗ Tastaturtildelinger
  • ✗ Modifikatorer
  • ✓ Kommandoliste bygget på din pc
  • ✓ Spilovervågning
  • ✓ Aksekurver og dødzoner
  • ✓ Spillets kontrolindstillinger
  • ✗ Force feedback-indstillinger i spillet
  • ✗ Force feedback fra telemetri
  • ✓ Telemetrioptagelse
  • ✓ Virtuel joystick (vJoy)
  • ◐ Virtuel Xbox-pad
  • ✓ Virtuelle funktioner
  • ✓ Opsætningsguide / Auto-tildeling
  • ✓ Cockpits
  • ✓ Snydeark
  • ✗ Test i spillet

Fra understøttelsesoversigten, genereret ud fra motorens kode: alle spil.

For begyndere

#Sådan virker det på 3 trin

  1. Sæt det hele op for mig
    på siden Start
  2. Brug disse knapper
    se listen først
  3. Skriv til mit spil
    hold X-Plane lukket

Før: start X-Plane én gang med dine enheder tilsluttet, og afslut så.

Derefter: kalibrér dine enheder i X-Plane (Settings > Joystick). Dine tildelinger vises også der.

Har du tildelt knapper i X-Plane før? Så tilbyder siden Start Importér, og udfyld så hullerne. Dine tildelinger bliver, og kun ledige knapper får nye opgaver. Se Hurtig start: få min stick til at virke.

#Hvad JoyPro gør for X-Plane

  • Import: akseanvendelser, knapkommandoer, omvendt-markeringer og responskurver for dine enheder kommer ind i din profil.
  • Relationer: én relation er én funktion i alle dine spil ("Gear" i X-Plane, MSFS og DCS på den samme knap). X-Planes flyvekommandoer kommer fra dets egen Commands.txt.
  • Eksport: JoyPro skriver joystickindstillingerne for den version, du eksporterer til. X-Plane viser dine tildelinger under Settings > Joystick.

#Importér dine X-Plane-tildelinger

  1. Åbn Start. Kortet X-Plane 12 (eller X-Plane 11) viser spillets billede. Hvis det beder om en kommandoliste, så tryk på Opbyg liste: JoyPro læser Resources\plugins\Commands.txt i det installerede X-Plane.
  2. Tryk på Import på kortet, og vælg Føj til min profil (X-Plane har ingen tastaturtildelinger i denne fil).
  3. Tryk på Importér nu. Se mine relationer åbner det, der kom ind.
Siden Start med dine spilSiden Start med dine spil
Siden Start med dine spil (Billederne viser appen på engelsk.)

#Opbyg og kontrollér relationer

På siden Relationer står X-Plane-kommandoen eller -aksen i en relation ved siden af den samme funktion i dine andre spil. Brug relationsforløbet til at forbinde dem, og tryk så på Kontrollér nu på siden Eksport (Kontrollér).

#Eksportér til X-Plane

  1. Luk X-Plane. Det omskriver sine indstillinger, når indstillingsvinduet lukkes, og når det afsluttes. Begge versioner kører som X-Plane.exe, så JoyPro nægter, mens en af dem kører.
  2. Åbn Eksport. Hver installeret version har sit eget kort.
  3. Behold Erstat på mine enheder med Ryd også mine andre enheder, hvis det er i JoyPro, du sætter dine enheder op. Tryk på Eksportér nu på kortet.
I spillet: Hvad du ser i X-Plane

Start X-Plane, åbn Settings > Joystick, og vælg din enhed. Hver akse viser den anvendelse, JoyPro har skrevet, knapper viser deres kommandoer, og Edit Response Curve på en akse viser de punkter og den interpolation, JoyPro har skrevet.

#Hvad du selv gør i X-Plane

  • Start X-Plane én gang med dine enheder tilsluttet, og afslut det så. En version, der aldrig er startet, har endnu ingen indstillingsfil. Den allerførste start flyver vejledningen, og X-Plane skriver sine joystickindstillinger, når det afsluttes.
  • Kalibrér i X-Plane. Kalibreringen og nulzonen forbliver X-Planes (Settings > Joystick); JoyPro skriver dem aldrig.
  • Plugin- og flykommandoer er ikke på JoyPros liste: tildel dem i X-Plane, JoyPro lader dem være.

#Typiske faldgruber

  • En akse gør intet ("Multiple axes assigned to yaw"): X-Plane ignorerer en anvendelse, som to tilsluttede akser deler. Eksporten advarer; Ryd også mine andre enheder eller Erstat rydder den anden akse.
  • Throttlen kører baglæns: X-Plane vender selv throttle-akser om. JoyPro skriver din invertering uændret, så lad invertering være slået fra, medmindre dit greb virkelig kører den anden vej.
  • En kurve, du har lavet i X-Plane, er ændret: i Opdatér-tilstandene og Kun tilføj bliver den, når JoyPros tuning er lineær (med en advarsel); "min profil vinder" og Erstat skriver JoyPros kurve.
Avanceret

#Filer, JoyPro læser og skriver

Fil Hvad det er
<install>\Output\preferences\X-Plane Joystick Settings.prf de aktuelle tildelinger for alle enheder (linjebaseret)
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf gemte styringsprofiler, samme format
<file>.joypro.json, <file>.joypro-meta.json de indgange og kurver, JoyPro har skrevet; navne, grupper og tuning til næste import
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt hvor X-Planes installationsprogram opfører sine installationer (kun læsning)

X-Plane Keys.prf (tastatur) røres aldrig. En version, der er installeret via Steam og aldrig startet, findes i sin Steam-mappe. En anden mappe angives under Indstillinger > Spil.

#Eksporttilstandene i X-Plane

Tilstand Hvad der sker i X-Plane
Kun tilføj Kun frie indgange. En tildeling på en indgang med en anden funktion eller kommando skrives ikke og opføres; en aksefunktion, som X-Plane har på en anden akse, bliver der (advarsel).
Opdatér, behold spillets tildelinger Erstatter den anden funktion eller kommando på din indgang og beholder alt andet; en aksefunktion flyttes (X-Plane ignorerer en funktion, som to akser deler).
Opdatér, min profil vinder Frigiver også de andre akser og knapper på tilsluttede enheder, der har en funktion eller kommando, du tildeler, med deres kurver.
Erstat på mine enheder Frigiver også alle andre flyveakser og kommandoer på de enheder, du skriver.
+ Ryd også mine andre enheder De tilsluttede enheder, du ikke skriver, mister deres flyvefunktioner og kommandoer.

#Det, der aldrig røres

  • Pladser for enheder, der ikke er tilsluttet, importens ignorerede enheder og den vJoy-enhed, JoyPro sender igennem.
  • Akser til visning, kamera, VR og egne kommandoer, plugin- og flykommandoer, tastaturet.
  • Kalibreringsnøgler (_joy_center, _joy_null, rå kalibreringsdata), _eq_pfc_* og alle andre linjer.

#Kurver og indstillinger

  • Granularitet: én fil til alle fly (X-Plane kan knytte fly til styringsprofiler; JoyPro skriver de filer, det finder).
  • Responskurver (aksemodel xplane): et vilkårligt antal punkter med LINEAR, CATMULL_ROM eller CUBIC_AVG og de faste områder for throttle-, propel- og mixture-akser (beta, feather, cutoff, FADEC ...). Standardkurve bliver til punkter; en uændret kurve beholder sine bytes. Tuning kan sættes for én version eller for begge (family:xplane).
  • Reverse: _joy_rev_axis, din invertering uændret (X-Plane vender selv throttles om).
  • Spilindstillinger (Indstillinger > Spillenes force feedback-indstillinger): styringsrespons for pitch, roll og yaw; X-Plane 12 også andenpilotens akser og "control-loaded axes" til sticks med force feedback; X-Plane 11 stabilitetsforstærkningen; begge flap-hakkene. Kun linjer, filen allerede har, ændres.
  • Force feedback: X-Plane har ingen egen; kun control-loaded-kontakten.
  • Telemetrioptagelse: fra X-Planes UDP-dataoutput (port 49000), med position, så et Tacview-spor er muligt.
  • Overvågning: ændringer i præferencerne opdages, når X-Plane er lukket (overvågningen).
Teknisk

#Inde i X-Plane-integrationen

flowchart LR
  P["Din profil<br/>(relationer + tildelinger)"] --> E["engine xplane12 export<br/>(eller xplane11)"]
  D["Enhedspladser<br/>VID:PID + HID-sti"] --> 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
Hver X-Plane-version har sin egen præferencefil. Kalibrering og nulzonen forbliver X-Planes.

Kode: engine\Games\XPlaneIntegration.cs (én instans pr. version), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (profiler fra før opdelingen i to versioner migreres ved indlæsning).

  • Linjer: _joy_AXIS_use<i> (funktionskode), _joy_rev_axis<i>, _joy_BUTN_use<i> (kommandosti, sim/none/none = fri), axis_response_curve<i>. Globale indekser: akse = plads × 25 + akse, knap = plads × 160 + knap.
  • Enheder: pladser _joy_unique_id<slot> VID:<dec>PID:<dec>; ved ens enheder skal DirectInput-HID-interfacestien være lig med _joy_location<slot>. Knapperne er enhedens knapper og derefter den første hat som 8 knapper med uret fra op; andre hats knyttes ikke. Læser 160 knapper og 25 akser pr. enhed.
  • Funktionskoder: 0 til 66 i begge versioner; X-Plane 12 tilføjer throttle 9, andenpilotens pitch/roll/yaw/bremser/tiller og begge hjulbremser. Kode 74 til 77 og visningsakserne katalogiseres ikke.
  • Kommandoliste: engine xplane12 refresh-db / engine xplane11 refresh-db: versionens aksetabel plus flyvekommandogrupperne fra Commands.txt (sim/flight_controls, engines, autopilot, lights ...; ikke sim/view, operation, replay ...).
  • Import / eksport: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), det samme for engine xplane11 export. Sikkerhedskopi til .jpbak først.
  • Indstillinger og kurver: 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 (målt i X-Plane 12.4.3 inden for 0,0001).

#Kendte begrænsninger

  • Betydningen af funktionskode 74 til 77; aksernes rækkefølge i HID i forhold til DirectInput er udledt.
  • X-Planes Control Sensitivity uden en kurve er ikke med i forhåndsvisningen.
  • X-Plane 11 er kun kontrolleret mod sine installerede filer; kontrollen i spillets menu mangler endnu.
  • Tests: engine\tests\smoke\xplane.ps1; i spillet (X-Plane 12) bestod tildelinger og responskurver 33 af 33 trin; tools\e2e\games\XPlaneCurves.ps1 gennemløber hver akse mod JoyPros forhåndsvisning.

Alle tekniske noter om dette spil (genereret ud fra repositoriet): xplane.md.