X-Plane hoiab kõigi sinu seadmete määranguid ühes eelistuste failis oma paigalduse sees: telje „kasutus“ (kalle, gaas, tiivaklapid ...) iga riistvaratelje kohta, käsk iga nupu kohta ja valikulised reaktsioonikõverad. JoyPro loeb selle faili sinu profiili, ühendab selle seostes sinu teiste mängudega ja kirjutab selle tagasi, muutes ainult enda hallatavaid lennuridu. X-Plane 12 ja X-Plane 11 on JoyPros kaks mängu, kummalgi oma paigaldus, käskude loend ja seaded; mõlemad võivad olla paigaldatud kõrvuti.
X-Plane 12 otse (oma määrangufailid)
- Tugi
- otse (oma määrangufailid)
- Mootori käsk
engine xplane12- Määrangufail
Output\preferences\X-Plane Joystick Settings.prf,control profiles\*.prf(reapõhine)- Sisendid, mida mäng loeb
- loeb joysticku kohta 160 nuppu, 25 telge, 1 Hati (kontrollitud)
- Käsuloendi allikas
Resources\plugins\Commands.txt- Mängusisene test
- 33/33 sammu läbitud (2026-10-11)
- ✓ Impordi
- ✓ Ekspordi
- ✗ Klaviatuuri määrangud
- ✗ Modifikaatorid
- ✓ Käsuloend koostatakse sinu arvutis
- ✓ Mängu jälgija
- ✓ Telje kõverad ja surnud tsoonid
- ✓ Mängu juhtimisseaded
- ◐ Mängusisesed force feedback'i seadedX-Plane 12: ainult seadmepõhine lüliti „control-loaded axes“ force feedbackiga juhtkangidele; simulaatoril pole juhtkangi jaoks omaenda force feedbacki efekte (ainult pluginad).
- ✗ Force feedback telemeetriast
- ✓ Telemeetria salvestamine
- ✓ Virtuaalne joystick (vJoy)
- ◐ Virtuaalne Xboxi pult
- ✓ Virtuaalsed funktsioonid
- ✓ Seadistusviisard / Automaatne määramine
- ✓ Kokpitid
- ✓ Spikrid
- ✓ Mängusisene test
X-Plane 11 otse (oma määrangufailid)
- Tugi
- otse (oma määrangufailid)
- Mootori käsk
engine xplane11- Määrangufail
- nagu X-Plane 12
- Sisendid, mida mäng loeb
- loeb joysticku kohta 160 nuppu, 25 telge, 1 Hati (kontrollitud)
- Käsuloendi allikas
Resources\plugins\Commands.txt
- ✓ Impordi
- ✓ Ekspordi
- ✗ Klaviatuuri määrangud
- ✗ Modifikaatorid
- ✓ Käsuloend koostatakse sinu arvutis
- ✓ Mängu jälgija
- ✓ Telje kõverad ja surnud tsoonid
- ✓ Mängu juhtimisseaded
- ✗ Mängusisesed force feedback'i seaded
- ✗ Force feedback telemeetriast
- ✓ Telemeetria salvestamine
- ✓ Virtuaalne joystick (vJoy)
- ◐ Virtuaalne Xboxi pult
- ✓ Virtuaalsed funktsioonid
- ✓ Seadistusviisard / Automaatne määramine
- ✓ Kokpitid
- ✓ Spikrid
- ✗ Mängusisene test
Tugimaatriksist, mis on loodud mootori koodist: kõik mängud.
#Tööle 3 sammuga
- Seadista kõik minu eest
Avalehel - Kasuta neid nuppe
vaata enne loendit - Kirjuta minu mängu
hoia X-Plane suletuna
Enne: käivita X-Plane üks kord ühendatud seadmetega ja välju siis.
Siis: kalibreeri oma seadmed X-Plane'is (Settings > Joystick). Sinu määrangud on ka seal näha.
Kas määrasid X-Plane'is varem nuppe? Siis pakub Avaleht valikut Impordi, siis täida lüngad. Sinu määrangud jäävad ja ainult vabad nupud saavad uued ülesanded. Vaata Kiirstart: pane mu juhtkang tööle.
#Mida JoyPro X-Plane'i heaks teeb
- Impordi: sinu seadmete telgede kasutused, nuppude käsud, ümberpööramise lipud ja reaktsioonikõverad tulevad sinu profiili.
- Seosed: üks seos on üks funktsioon kõigis sinu mängudes („Gear“ X-Plane'is, MSFS-is ja DCS-is samal nupul). X-Plane'i lennukäsud tulevad selle enda failist
Commands.txt. - Ekspordi: JoyPro kirjutab eksporditava versiooni joysticku eelistused. X-Plane näitab sinu määranguid menüüs Settings > Joystick.
#Impordi oma X-Plane'i määrangud
- Ava Avaleht. X-Plane 12 (või X-Plane 11) kaart näitab mängu pilti. Kui see küsib käskude loendit, vajuta Koosta loend: JoyPro loeb paigaldatud X-Plane'i faili
Resources\plugins\Commands.txt. - Vajuta kaardil Impordi ja vali Lisa minu profiilile (X-Plane'il pole selles failis klaviatuurimääranguid).
- Vajuta Impordi nüüd. Vaata minu seoseid avab selle, mis sisse tuli.


#Seoste loomine ja kontrollimine
Lehel Seosed on seose X-Plane'i käsk või telg sinu teiste mängude sama funktsiooni kõrval. Kasuta nende ühendamiseks seoste töövoogu, seejärel vajuta lehel Ekspordi Kontrolli nüüd (kontroll).
#Ekspordi X-Plane'i
- Sulge X-Plane. See kirjutab oma eelistused üle, kui seadete aken suletakse ja kui programm suletakse. Mõlemad versioonid töötavad nimega
X-Plane.exe, nii et JoyPro keeldub, kui kumbki neist töötab. - Ava Ekspordi. Igal paigaldatud versioonil on oma kaart.
- Jäta valituks Asenda minu seadmetel koos valikuga Tühjenda ka minu teised seadmed, kui seadistad oma seadmed JoyPros. Vajuta kaardil Ekspordi nüüd.
Käivita X-Plane ja ava Settings > Joystick, seejärel vali oma seade. Iga telg näitab JoyPro kirjutatud kasutust, nupud näitavad oma käske ja telje Edit Response Curve näitab JoyPro kirjutatud punkte ja interpolatsiooni.
#Mida teed X-Plane'is ise
- Käivita X-Plane üks kord ühendatud seadmetega ja välju siis. Versioonil, mida pole kunagi käivitatud, pole veel eelistuste faili. Kõige esimene käivitus lendab õppelennu ja X-Plane kirjutab oma joysticku eelistused sulgemisel.
- Kalibreeri X-Plane'is. Kalibreerimine ja nulltsoon jäävad X-Plane'i hallata (Settings > Joystick); JoyPro ei kirjuta neid kunagi.
- Pluginate ja õhusõidukite käske pole JoyPro loendis: määra need X-Plane'is, JoyPro jätab need puutumata.
#Levinud vead
- Telg ei tee midagi („Multiple axes assigned to yaw“): X-Plane eirab kasutust, mida jagavad kaks ühendatud telge. Eksport hoiatab; Tühjenda ka minu teised seadmed või Asenda tühjendab teise telje.
- Gaas töötab tagurpidi: X-Plane pöörab gaasiteljed ise ümber. JoyPro kirjutab sinu ümberpööramise muutmata, nii et jäta ümberpööramine välja, kui sinu kang päriselt teistpidi ei liigu.
- X-Plane'is tehtud kõver muutus: värskendusrežiimides ja režiimis Ainult lisa jääb see alles, kui JoyPro häälestus on lineaarne (hoiatusega); „minu profiil võidab“ ja Asenda kirjutavad JoyPro kõvera.
#Failid, mida JoyPro loeb ja kirjutab
| Fail | Mis see on |
|---|---|
<install>\Output\preferences\X-Plane Joystick Settings.prf |
kõigi seadmete praegused määramised (reapõhine) |
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf |
salvestatud juhtimisprofiilid, sama vorming |
<file>.joypro.json, <file>.joypro-meta.json |
sisendid ja kõverad, mille JoyPro kirjutas; nimed, rühmad ja häälestus järgmise impordi jaoks |
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt |
kus X-Plane'i paigaldaja oma paigaldused loetleb (ainult lugemiseks) |
X-Plane Keys.prf (klaviatuur) jääb alati puutumata. Steami paigaldatud ja kunagi käivitamata versioon leitakse selle Steami kaustast. Muu kausta saab määrata menüüs Seaded > Mängud.
#Ekspordirežiimid mängus X-Plane
| Režiim | Mis juhtub X-Plane'is |
|---|---|
| Ainult lisa | Ainult vabad sisendid. Määrangut sisendil, millel on muu kasutus või käsk, ei kirjutata ja see loetletakse; telje kasutus, mis X-Plane'il on teisel teljel, jääb sinna (hoiatus). |
| Värskenda, mängu määrangud jäävad | Asendab sinu sisendil oleva muu kasutuse või käsu ja säilitab kõik muu; telje kasutus teisaldatakse (X-Plane eirab kasutust, mis on kahel teljel ühine). |
| Värskenda, minu profiil võidab | Vabastab ka ühendatud seadmete teised teljed ja nupud, millel on sinu määratud kasutus või käsk, koos nende kõveratega. |
| Asenda minu seadmetel | Vabastab ka kõik teised lennuteljed ja käsud seadmetel, kuhu kirjutad. |
| + Tühjenda ka minu teised seadmed | Ühendatud seadmed, kuhu sa ei kirjuta, kaotavad oma lennukasutused ja käsud. |
#Mida kunagi ei puudutata
- Ühendamata seadmete pesad, impordi eiratud seadmed ja vJoy seade, mille kaudu JoyPro edastab.
- Vaate-, kaamera-, VR- ja kohandatud käskude teljed, pistikprogrammide ja õhusõidukite käsud, klaviatuur.
- Kalibreerimisvõtmed (
_joy_center,_joy_null, toored kalibreerimisandmed),_eq_pfc_*ja iga teine rida.
#Kõverad ja seaded
- Täpsus: üks fail kõigile õhusõidukitele (X-Plane saab siduda õhusõidukeid juhtimisprofiilidega; JoyPro kirjutab leitud failid).
- Reageerimiskõverad (teljemudel
xplane): mis tahes arv punkte koos LINEAR, CATMULL_ROM või CUBIC_AVG ning gaasi-, propelleri- ja segutelgede fikseeritud vahemikud (beta, feather, cutoff, FADEC ...). Vaikimisi kõver muutub punktideks; muutmata kõver säilitab oma baidid. Häälestuse saab määrata ühele versioonile või mõlemale (family:xplane). - Ümberpööramine:
_joy_rev_axis, sinu ümberpööramine muutmata (X-Plane pöörab gaasid ise ümber). - Mänguseaded (Seaded > Mängude force feedbacki seaded): pitchi, rolli ja yaw juhtimise reageerimine; X-Plane 12-s ka kaaspiloodi teljed ja "control-loaded axes" force feedbackiga juhtkangidele; X-Plane 11-s stabiilsuse võimendus; mõlemas tiivaklappide astmed. Muudetakse ainult ridu, mis failis juba on.
- Force feedback: X-Plane'il endal seda pole; ainult control-loaded lüliti.
- Telemeetria salvestamine: X-Plane'i UDP andmeväljundist (port 49000), koos asukohaga, nii et Tacview rada on võimalik.
- Jälgija: eelistuste muudatused märgatakse pärast X-Plane'i sulgemist (jälgija).
#X-Plane'i integratsioon seestpoolt
flowchart LR P["Sinu profiil<br/>(seosed + määrangud)"] --> E["engine xplane12 export<br/>(või xplane11)"] D["Seadmepesad<br/>VID:PID + HID tee"] --> 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
Kood: engine\Games\XPlaneIntegration.cs (üks eksemplar versiooni kohta), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (enne kaheks versiooniks jagamist loodud profiilid migreeritakse laadimisel).
- Read:
_joy_AXIS_use<i>(kasutuskood),_joy_rev_axis<i>,_joy_BUTN_use<i>(käsu tee,sim/none/none= vaba),axis_response_curve<i>. Globaalsed indeksid: telg = pesa × 25 + telg, nupp = pesa × 160 + nupp. - Seadmed: pesad
_joy_unique_id<slot> VID:<dec>PID:<dec>; identsete seadmete korral peab DirectInputi HID-liidese tee võrduma väärtusega_joy_location<slot>. Nupud on seadme nupud, seejärel esimene Hat 8 nupuna päripäeva alates ülemisest; teisi Hate ei vastendata. Loeb seadme kohta 160 nuppu ja 25 telge. - Kasutuskoodid: mõlemas versioonis 0 kuni 66; X-Plane 12 lisab gaasi 9, kaaspiloodi pitchi/rolli/yaw/pidurid/esiratta juhtimise ja mõlemad rattapidurid. Koode 74 kuni 77 ja vaatetelgi ei kataloogita.
- Käsuloend:
engine xplane12 refresh-db/engine xplane11 refresh-db: versiooni teljetabel pluss failiCommands.txtlennukäskude rühmad (sim/flight_controls,engines,autopilot,lights...; mittesim/view,operation,replay...). - Import / eksport:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), sama kaengine xplane11 exportjaoks. Esmalt varukoopia faili.jpbak. - Seaded ja kõverad:
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õõdetud X-Plane 12.4.3-s täpsusega 0,0001).
#Teadaolevad piirangud
- Kasutuskoodide 74 kuni 77 tähendus; HID-i ja DirectInputi telgede järjekord on tuletatud.
- X-Plane'i Control Sensitivity ilma kõverata pole eelvaates.
- X-Plane 11 on kontrollitud ainult selle paigaldatud failide põhjal; mängusisene menüükontroll on ootel.
- Testid:
engine\tests\smoke\xplane.ps1; mängus (X-Plane 12) läbisid määrangud ja reageerimiskõverad 33 sammu 33-st;tools\e2e\games\XPlaneCurves.ps1kontrollib iga telge JoyPro eelvaate vastu.
Kõik tehnilised märkused selle mängu kohta (loodud hoidlast): xplane.md.