JoyPro2 Discord GitHub
Pelit

X-Plane 12 / 11

Näytä:

X-Plane tallentaa kaikkien laitteidesi määritykset yhteen asetustiedostoon asennuksensa sisällä: akselin ”käyttö” (pitch, kaasu, laipat ...) laitteiston akselia kohden, komento painiketta kohden ja valinnaiset vastekäyrät. JoyPro lukee tiedoston profiiliisi, yhdistää sen muihin peleihisi suhteissa ja kirjoittaa sen takaisin muuttaen vain hallitsemiaan lentorivejä. X-Plane 12 ja X-Plane 11 ovat JoyProssa kaksi peliä, kummallakin oma asennus, komentoluettelo ja asetukset; molemmat voidaan asentaa rinnakkain.

X-Plane 12 natiivi (omat näppäinmääritystiedostot)
Tuki
natiivi (omat näppäinmääritystiedostot)
Moottorin komento
engine xplane12
Näppäinmääritystiedosto
Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (rivipohjainen)
Pelin lukemat tulot
lukee 160 painiketta, 25 akselia, 1 Hatin joystickia kohden (varmistettu)
Komentoluettelon lähde
Resources\plugins\Commands.txt
Pelinsisäinen testi
33/33 vaihetta läpäisty (2026-10-11)
  • ✓ Tuo
  • ✓ Vie
  • ✗ Näppäimistön näppäinmääritykset
  • ✗ Muuntimet
  • ✓ Komentoluettelo rakennetaan PC:lläsi
  • ✓ Pelien seuranta
  • ✓ Akselikäyrät ja kuolleet alueet
  • ✓ Pelin ohjainasetukset
  • ◐ Pelin voimapalauteasetuksetX-Plane 12: vain laitekohtainen kytkin ”control-loaded axes” voimapalauteohjainsauvoille; simulaattorissa ei ole omia ohjainsauvan voimapalaute-efektejä (vain lisäosat).
  • ✗ Voimapalaute telemetriasta
  • ✓ Telemetrian tallennus
  • ✓ Virtuaalinen joystick (vJoy)
  • ◐ Virtuaalinen Xbox-ohjain
  • ✓ Virtuaaliset toiminnot
  • ✓ Ohjattu määritys / Automaattinen määritys
  • ✓ Ohjaamot
  • ✓ Pikaohjeet
  • ✓ Pelinsisäinen testi
X-Plane 11 natiivi (omat näppäinmääritystiedostot)
Tuki
natiivi (omat näppäinmääritystiedostot)
Moottorin komento
engine xplane11
Näppäinmääritystiedosto
kuten X-Plane 12
Pelin lukemat tulot
lukee 160 painiketta, 25 akselia, 1 Hatin joystickia kohden (varmistettu)
Komentoluettelon lähde
Resources\plugins\Commands.txt
  • ✓ Tuo
  • ✓ Vie
  • ✗ Näppäimistön näppäinmääritykset
  • ✗ Muuntimet
  • ✓ Komentoluettelo rakennetaan PC:lläsi
  • ✓ Pelien seuranta
  • ✓ Akselikäyrät ja kuolleet alueet
  • ✓ Pelin ohjainasetukset
  • ✗ Pelin voimapalauteasetukset
  • ✗ Voimapalaute telemetriasta
  • ✓ Telemetrian tallennus
  • ✓ Virtuaalinen joystick (vJoy)
  • ◐ Virtuaalinen Xbox-ohjain
  • ✓ Virtuaaliset toiminnot
  • ✓ Ohjattu määritys / Automaattinen määritys
  • ✓ Ohjaamot
  • ✓ Pikaohjeet
  • ✗ Pelinsisäinen testi

Tukimatriisista, joka on luotu moottorin koodista: kaikki pelit.

Aloittelijoille

#Käyttöön 3 vaiheessa

  1. Tee kaikki puolestani
    Alku-sivulla
  2. Käytä näitä painikkeita
    katso ensin luettelo
  3. Kirjoita peliini
    pidä X-Plane suljettuna

Ennen: käynnistä X-Plane kerran laitteet kytkettyinä ja sulje se.

Sitten: kalibroi laitteesi X-Planessa (Settings > Joystick). Myös määrityksesi näkyvät siellä.

Oletko aiemmin määrittänyt painikkeita X-Planessa? Silloin Alku-sivu tarjoaa vaihtoehdon Tuo ja täytä sitten aukot. Määrityksesi säilyvät, ja vain vapaat painikkeet saavat uusia tehtäviä. Katso Pika-aloitus: saa ohjainsauvani toimimaan.

#Mitä JoyPro tekee X-Planelle

  • Tuo: laitteidesi akselien käytöt, painikekomennot, kääntömerkinnät ja vastekäyrät tulevat profiiliisi.
  • Suhteet: yksi suhde on yksi toiminto kaikissa peleissäsi (”Gear” X-Planessa, MSFS:ssä ja DCS:ssä samalla painikkeella). X-Planen lentokomennot tulevat sen omasta tiedostosta Commands.txt.
  • Vie: JoyPro kirjoittaa viemäsi version joystick-asetukset. X-Plane näyttää määrityksesi kohdassa Settings > Joystick.

#Tuo X-Planen määrityksesi

  1. Avaa Alku. X-Plane 12 (tai X-Plane 11) -kortti näyttää pelin kuvan. Jos se pyytää komentoluetteloa, paina Luo luettelo: JoyPro lukee asennetun X-Planen tiedoston Resources\plugins\Commands.txt.
  2. Paina kortin Tuo ja valitse Lisää profiiliini (X-Planella ei ole tässä tiedostossa näppäimistömäärityksiä).
  3. Paina Tuo nyt. Näytä suhteeni avaa sen, mitä tuli.
Alku-sivu ja pelisiAlku-sivu ja pelisi
Alku-sivu ja pelisi (Kuvat näyttävät sovelluksen englanniksi.)

#Rakenna ja tarkista suhteet

Suhteet-sivulla suhteen X-Plane-komento tai -akseli on muiden peliesi saman toiminnon vieressä. Yhdistä ne suhteiden työnkulun avulla ja paina sitten Tarkista nyt Vie-sivulla (Tarkistus).

#Vie X-Planeen

  1. Sulje X-Plane. Se kirjoittaa asetuksensa uudelleen, kun asetusikkuna sulkeutuu ja kun se sulkeutuu. Molemmat versiot toimivat nimellä X-Plane.exe, joten JoyPro kieltäytyy, kun kumpi tahansa on käynnissä.
  2. Avaa Vie. Jokaisella asennetulla versiolla on oma korttinsa.
  3. Pidä Korvaa laitteillani ja Tyhjennä myös muut laitteeni valittuina, jos määrität laitteesi JoyProssa. Paina kortin Vie nyt.
Pelissä: Mitä näet X-Planessa

Käynnistä X-Plane, avaa Settings > Joystick ja valitse laitteesi. Jokainen akseli näyttää JoyPron kirjoittaman käytön, painikkeet näyttävät komentonsa, ja akselin Edit Response Curve näyttää JoyPron kirjoittamat pisteet ja interpoloinnin.

#Mitä teet itse X-Planessa

  • Käynnistä X-Plane kerran laitteet kytkettyinä ja sulje se. Versiolla, jota ei ole koskaan käynnistetty, ei ole vielä asetustiedostoa. Aivan ensimmäinen käynnistys lentää opetusohjelman, ja X-Plane kirjoittaa joystick-asetuksensa sulkeutuessaan.
  • Kalibroi X-Planessa. Kalibrointi ja nolla-alue pysyvät X-Planen hallinnassa (Settings > Joystick); JoyPro ei koskaan kirjoita niitä.
  • Laajennusten ja ilma-alusten komennot eivät ole JoyPron luettelossa: määritä ne X-Planessa, JoyPro ei koske niihin.

#Yleiset sudenkuopat

  • Akseli ei tee mitään (”Multiple axes assigned to yaw”): X-Plane ei huomioi käyttöä, joka on kahdella kytketyllä akselilla. Vienti varoittaa; Tyhjennä myös muut laitteeni tai Korvaa tyhjentää toisen akselin.
  • Kaasu toimii väärään suuntaan: X-Plane kääntää kaasuakselit itse. JoyPro kirjoittaa kääntösi muuttamattomana, joten pidä kääntö pois päältä, ellei vipusi todella liiku toiseen suuntaan.
  • X-Planessa tekemäsi käyrä muuttui: Päivitä-tiloissa ja Vain lisää -tilassa se säilyy, kun JoyPron säätö on lineaarinen (varoituksen kanssa); ”Profiilini voittaa” ja Korvaa kirjoittavat JoyPron käyrän.
Lisäasetukset

#Tiedostot, joita JoyPro lukee ja kirjoittaa

Tiedosto Mikä se on
<install>\Output\preferences\X-Plane Joystick Settings.prf kaikkien laitteiden nykyiset määritykset (rivipohjainen)
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf tallennetut ohjausprofiilit, sama muoto
<file>.joypro.json, <file>.joypro-meta.json JoyPron kirjoittamat tulot ja käyrät; nimet, ryhmät ja säädöt seuraavaa tuontia varten
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt missä X-Planen asennusohjelma luettelee asennuksensa (vain luku)

X-Plane Keys.prf (näppäimistö) ei koskaan muutu. Steamin asentama versio, jota ei ole koskaan käynnistetty, löytyy Steam-kansiostaan. Toinen kansio asetetaan kohdassa Asetukset > Pelit.

#Vientitilat X-Planessa

Tila Mitä X-Planessa tapahtuu
Vain lisää Vain vapaat tulot. Näppäinmääritystä tuloon, jolla on toinen käyttö tai komento, ei kirjoiteta, ja se luetellaan; akselikäyttö, joka X-Planella on toisella akselilla, pysyy siellä (varoitus).
Päivitä, säilytä pelin määritykset Korvaa tulosi toisen käytön tai komennon ja säilyttää kaiken muun; akselikäyttö siirtyy (X-Plane ohittaa käytön, joka on kahdella akselilla).
Päivitä, profiilini voittaa Vapauttaa myös kytkettyjen laitteiden muut akselit ja painikkeet, joilla on määrittämäsi käyttö tai komento, käyrineen.
Korvaa laitteillani Vapauttaa myös kaikki muut lentoakselit ja komennot kirjoittamillasi laitteilla.
+ Tyhjennä myös muut laitteeni Kytketyt laitteet, joihin et kirjoita, menettävät lentokäyttönsä ja komentonsa.

#Mihin ei koskaan kosketa

  • Laitteiden paikat, joita ei ole kytketty, tuonnissa ohitetut laitteet sekä vJoy-laite, jonka kautta JoyPro ohjaa syötteet.
  • Näkymän, kameran, VR:n ja mukautettujen komentojen akselit, lisäosien ja ilma-alusten komennot, näppäimistö.
  • Kalibrointiavaimet (_joy_center, _joy_null, raaka kalibrointidata), _eq_pfc_* ja jokainen muu rivi.

#Käyrät ja asetukset

  • Tarkkuus: yksi tiedosto kaikille ilma-aluksille (X-Plane voi liittää ilma-aluksia ohjausprofiileihin; JoyPro kirjoittaa löytämänsä tiedostot).
  • Vastekäyrät (akselimalli xplane): mikä tahansa määrä pisteitä tavoilla LINEAR, CATMULL_ROM tai CUBIC_AVG sekä kaasu-, potkuri- ja seosakselien kiinteät alueet (beta, feather, cutoff, FADEC ...). Oletuskäyrä muuttuu pisteiksi; muuttamaton käyrä säilyttää tavunsa. Säädön voi asettaa yhdelle versiolle tai molemmille (family:xplane).
  • Käännös: _joy_rev_axis, käännöksesi muuttamattomana (X-Plane kääntää kaasut itse).
  • Peliasetukset (Asetukset > Pelien voimapalauteasetukset): pitchin, rollin ja yaw'n ohjausvaste; X-Plane 12:ssa myös perämiehen akselit ja "control-loaded axes" voimapalauteohjainsauvoille; X-Plane 11:ssä vakavuuden lisäys; molemmissa laippojen pykälät. Vain tiedostossa jo olevia rivejä muutetaan.
  • Voimapalaute: X-Planessa ei ole omaa voimapalautetta; vain control-loaded-kytkin.
  • Telemetrian tallennus: X-Planen UDP-datatulosteesta (portti 49000), sijainnin kera, joten Tacview-tallenne on mahdollinen.
  • Seuranta: asetustiedostojen muutokset huomataan X-Planen sulkemisen jälkeen (seuranta).
Tekninen

#X-Plane-integraation sisältä

flowchart LR
  P["Profiilisi<br/>(suhteet + näppäinmääritykset)"] --> E["engine xplane12 export<br/>(tai xplane11)"]
  D["Laitepaikat<br/>VID:PID + HID-polku"] --> 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
Kullakin X-Plane-versiolla on oma asetustiedostonsa. Kalibrointi ja nolla-alue jäävät X-Planen hoidettaviksi.

Koodi: engine\Games\XPlaneIntegration.cs (yksi instanssi versiota kohden), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (profiilit ajalta ennen jakoa kahteen versioon siirretään ladattaessa).

  • Rivit: _joy_AXIS_use<i> (käyttökoodi), _joy_rev_axis<i>, _joy_BUTN_use<i> (komentopolku, sim/none/none = vapaa), axis_response_curve<i>. Yleiset indeksit: akseli = paikka × 25 + akseli, painike = paikka × 160 + painike.
  • Laitteet: paikat _joy_unique_id<slot> VID:<dec>PID:<dec>; identtisillä laitteilla DirectInputin HID-liitännän polun on oltava sama kuin _joy_location<slot>. Painikkeet ovat laitteen painikkeet, sitten ensimmäinen Hat-kytkin 8 painikkeena myötäpäivään ylhäältä alkaen; muita Hat-kytkimiä ei kuvata. Lukee 160 painiketta ja 25 akselia laitetta kohden.
  • Käyttökoodit: 0–66 molemmissa versioissa; X-Plane 12 lisää kaasun 9, perämiehen pitch/roll/yaw/jarrut/nokkapyörän ohjauksen ja molemmat pyöräjarrut. Koodeja 74–77 ja näkymäakseleita ei ole luetteloitu.
  • Komentoluettelo: engine xplane12 refresh-db / engine xplane11 refresh-db: version akselitaulukko sekä Commands.txt-tiedoston lentokomentoryhmät (sim/flight_controls, engines, autopilot, lights ...; ei sim/view, operation, replay ...).
  • Tuonti / vienti: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), samoin engine xplane11 export. Varmuuskopio ensin tiedostoon .jpbak.
  • Asetukset ja käyrät: 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 (mitattu X-Plane 12.4.3:ssa 0,0001:n tarkkuudella).

#Tunnetut rajoitukset

  • Käyttökoodien 74–77 merkitys; HID- ja DirectInput-akselijärjestyksen ero on päätelty.
  • X-Planen Control Sensitivity ilman käyrää ei näy esikatselussa.
  • X-Plane 11 on tarkistettu vain sen asennettuja tiedostoja vasten; pelin sisäisen valikon tarkistus on vielä tekemättä.
  • Testit: engine\tests\smoke\xplane.ps1; pelissä (X-Plane 12) näppäinmääritykset ja vastekäyrät läpäisivät 33/33 vaihetta; tools\e2e\games\XPlaneCurves.ps1 käy jokaisen akselin läpi JoyPron esikatselua vasten.

Kaikki tämän pelin tekniset huomiot (luotu repositoriosta): xplane.md.