JoyPro2 Discord GitHub
Гульні

X-Plane 12 / 11

Паказаць:

X-Plane захоўвае прызначэнні ўсіх вашых прылад у адным файле налад унутры сваёй усталёўкі: «use» восі (pitch, throttle, flaps ...) для кожнай апаратнай восі, каманду для кожнай кнопкі і, па жаданні, крывыя водгуку. JoyPro чытае гэты файл у ваш профіль, аб'ядноўвае яго з вашымі іншымі гульнямі ў сувязях і запісвае назад, змяняючы толькі тыя лётныя радкі, якімі ён кіруе. X-Plane 12 і X-Plane 11 — дзве гульні ў JoyPro, кожная са сваёй усталёўкай, спісам каманд і наладамі; абедзве можна ўсталяваць побач.

X-Plane 12 напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine xplane12
Файл прывязак
Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (пастрочны фармат)
Уваходы, якія чытае гульня
чытае 160 кнопак, 25 восяў, 1 Hat на joystick (праверана)
Спіс каманд з
Resources\plugins\Commands.txt
Праверка ў гульні
33/33 крокаў пройдзена (2026-10-11)
  • ✓ Імпарт
  • ✓ Экспарт
  • ✗ Прывязкі клавіятуры
  • ✗ Мадыфікатары
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✓ Налады кіравання ў гульні
  • ◐ Налады зваротнай сувязі па сіле ў гульніX-Plane 12: толькі пераключальнік «control-loaded axes» для кожнай прылады, для ручак са зваротнай сувяззю па сіле; уласных эфектаў зваротнай сувязі па сіле для ручкі ў сімулятара няма (толькі плагіны).
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✓ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ✓ Майстар налады / Auto Assign
  • ✓ Кабіны
  • ✓ Шпаргалкі
  • ✓ Праверка ў гульні
X-Plane 11 напрамую (уласныя файлы прывязак)
Падтрымка
напрамую (уласныя файлы прывязак)
Каманда рухавіка
engine xplane11
Файл прывязак
як X-Plane 12
Уваходы, якія чытае гульня
чытае 160 кнопак, 25 восяў, 1 Hat на joystick (праверана)
Спіс каманд з
Resources\plugins\Commands.txt
  • ✓ Імпарт
  • ✓ Экспарт
  • ✗ Прывязкі клавіятуры
  • ✗ Мадыфікатары
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✓ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✓ Запіс тэлеметрыі
  • ✓ Віртуальны joystick (vJoy)
  • ◐ Віртуальны пульт Xbox
  • ✓ Віртуальныя функцыі
  • ✓ Майстар налады / Auto Assign
  • ✓ Кабіны
  • ✓ Шпаргалкі
  • ✗ Праверка ў гульні

З матрыцы падтрымкі, створанай з кода рухавіка: усе гульні.

Для пачаткоўцаў

#Запуск за 3 крокі

  1. Наладзіць усё за мяне
    на старонцы «Старт»
  2. Выкарыстаць гэтыя кнопкі
    спачатку паглядзіце спіс
  3. Запісаць у маю гульню
    X-Plane павінен быць закрыты

Да: запусціце X-Plane адзін раз з падключанымі прыладамі, потым выйдзіце.

Потым: адкалібруйце свае прылады ў X-Plane (Settings > Joystick). Там жа відаць і вашы прызначэнні.

Вы ўжо прывязвалі кнопкі ў X-Plane? Тады старонка «Старт» прапануе Імпартаваць, потым запоўніць прабелы. Вашы прывязкі застаюцца, і новыя задачы атрымліваюць толькі вольныя кнопкі. Гл. Хуткі старт: каб мая ручка кіравання запрацавала.

#Што JoyPro робіць для X-Plane

  • Імпарт: прызначэнні восяў, каманды кнопак, сцяжкі рэверсу і крывыя водгуку вашых прылад трапляюць у ваш профіль.
  • Сувязі: адна сувязь — гэта адна функцыя ва ўсіх вашых гульнях («Шасі» ў X-Plane, MSFS і DCS на адной кнопцы). Лётныя каманды X-Plane бяруцца з яго ўласнага Commands.txt.
  • Экспарт: JoyPro запісвае налады джойсціка той версіі, у якую вы экспартуеце. X-Plane паказвае вашы прызначэнні ў Settings > Joystick.

#Імпарт вашых прызначэнняў X-Plane

  1. Адкрыйце Старт. Картка X-Plane 12 (або X-Plane 11) паказвае малюнак гульні. Калі яна просіць спіс каманд, націсніце Пабудаваць спіс: JoyPro чытае Resources\plugins\Commands.txt усталяванага X-Plane.
  2. Націсніце Імпарт на картцы і выберыце Дадаць у мой профіль (у гэтым файле X-Plane няма прывязак клавіятуры).
  3. Націсніце Імпартаваць зараз. Паглядзець мае сувязі адкрывае тое, што было імпартавана.
Старонка «Старт» з вашымі гульняміСтаронка «Старт» з вашымі гульнямі
Старонка «Старт» з вашымі гульнямі (На малюнках праграма па-англійску.)

#Стварэнне і праверка сувязей

На старонцы Сувязі каманда або вось X-Plane у сувязі стаіць побач з той жа функцыяй у вашых іншых гульнях. Аб'яднайце іх з дапамогай працэсу сувязей, потым націсніце Праверыць зараз на старонцы «Экспарт» (праверка).

#Экспарт у X-Plane

  1. Закрыйце X-Plane. Ён перазапісвае свае налады, калі зачыняецца акно налад, і пры выхадзе. Абедзве версіі працуюць як X-Plane.exe, таму JoyPro адмаўляецца запісваць, пакуль працуе любая з іх.
  2. Адкрыйце Экспарт. Кожная ўсталяваная версія мае сваю картку.
  3. Пакіньце Замяніць на маіх прыладах разам з Ачысціць і іншыя мае прылады, калі вы наладжваеце свае прылады ў JoyPro. Націсніце Экспартаваць зараз на картцы.
У гульні: Што вы ўбачыце ў X-Plane

Запусціце X-Plane і адкрыйце Settings > Joystick, потым выберыце сваю прыладу. Кожная вось паказвае прызначэнне, якое запісаў JoyPro, кнопкі паказваюць свае каманды, а Edit Response Curve на восі паказвае пункты і інтэрпаляцыю, якія запісаў JoyPro.

#Што вы робіце самі ў X-Plane

  • Запусціце X-Plane адзін раз з падключанымі прыладамі, потым выйдзіце з яго. У версіі, якую ні разу не запускалі, яшчэ няма файла налад. Пры самым першым запуску адкрываецца навучальны палёт, а налады джойсціка X-Plane запісвае пры выхадзе.
  • Калібруйце ў X-Plane. Каліброўка і нулявая зона застаюцца за X-Plane (Settings > Joystick); JoyPro іх ніколі не запісвае.
  • Каманд плагінаў і лятальных апаратаў няма ў спісе JoyPro: прывязвайце іх у X-Plane, JoyPro іх не чапае.

#Тыповыя памылкі

  • Вось нічога не робіць («Multiple axes assigned to yaw»): X-Plane ігнаруе прызначэнне, якое падзяляюць дзве падключаныя восі. Экспарт папярэджвае; Ачысціць і іншыя мае прылады або «Замяніць» ачышчае другую вось.
  • РУД працуе ў адваротны бок: X-Plane сам рэверсуе восі РУД. JoyPro запісвае вашу інверсію без змен, таму не ўключайце інверсію, калі толькі ваш рычаг сапраўды не рухаецца ў іншы бок.
  • Крывая, якую вы зрабілі ў X-Plane, змянілася: у рэжымах «Абнавіць» і «Толькі дадаць» яна застаецца, калі налада JoyPro лінейная (з папярэджаннем); «мой профіль мацнейшы» і «Замяніць» запісваюць крывую JoyPro.
Дадаткова

#Файлы, якія JoyPro чытае і запісвае

Файл Што гэта
<install>\Output\preferences\X-Plane Joystick Settings.prf бягучыя прызначэнні ўсіх прылад (па радках)
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf захаваныя профілі кіравання, той жа фармат
<file>.joypro.json, <file>.joypro-meta.json уваходы і крывыя, якія запісаў JoyPro; назвы, групы і налада для наступнага імпарту
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt дзе ўсталёўшчык X-Plane пералічвае свае ўсталёўкі (толькі для чытання)

X-Plane Keys.prf (клавіятура) ніколі не закранаецца. Версія, усталяваная праз Steam і ні разу не запушчаная, знаходзіцца ў сваёй папцы Steam. Іншая папка задаецца ў Налады > Гульні.

#Рэжымы экспарту ў X-Plane

Рэжым Што адбываецца ў X-Plane
Толькі дадаць Толькі вольныя ўваходы. Прывязка на ўваходзе з іншым прызначэннем або камандай не запісваецца і трапляе ў спіс; прызначэнне восі, якое X-Plane мае на іншай восі, застаецца там (папярэджанне).
Абнавіць, пакінуць прывязкі гульні Замяняе іншае прызначэнне або каманду на вашым уваходзе і захоўвае ўсё астатняе; прызначэнне восі пераносіцца (X-Plane ігнаруе прызначэнне, агульнае для дзвюх восей).
Абнавіць, мой профіль мацнейшы Таксама вызваляе іншыя восі і кнопкі падключаных прылад, якія маюць прызначэнне або каманду, што вы прывязваеце, разам з іх крывымі.
Замяніць на маіх прыладах Таксама вызваляе кожную іншую вось палёту і каманду на прыладах, у якія вы запісваеце.
+ Ачысціць і іншыя мае прылады Падключаныя прылады, у якія вы не запісваеце, губляюць свае прызначэнні палёту і каманды.

#Што ніколі не змяняецца

  • Слоты прылад, якія не падключаны, прылады, якія імпарт ігнаруе, і прылада vJoy, у якую JoyPro перадае ўвод.
  • Восі агляду, камеры, VR і карыстальніцкіх каманд, каманды плагінаў і лятальных апаратаў, клавіятура.
  • Ключы каліброўкі (_joy_center, _joy_null, сырыя даныя каліброўкі), _eq_pfc_* і кожны іншы радок.

#Крывыя і налады

  • Дэталізацыя: адзін файл для ўсіх лятальных апаратаў (X-Plane можа звязваць лятальныя апараты з профілямі кіравання; JoyPro запісвае файлы, якія знаходзіць).
  • Крывыя водгуку (мадэль восі xplane): любая колькасць апорных кропак з LINEAR, CATMULL_ROM або CUBIC_AVG і фіксаваныя дыяпазоны восей РУД, кроку шрубы і сумесі (beta, feather, cutoff, FADEC ...). Крывая па змаўчанні ператвараецца ў апорныя кропкі; нязменная крывая захоўвае свае байты. Наладу можна задаць для адной версіі або для абедзвюх (family:xplane).
  • Рэверс: _joy_rev_axis, ваша інверсія без змен (X-Plane сам рэверсуе РУД).
  • Налады гульні (Налады > Налады зваротнай сувязі па сіле гульняў): водгук кіравання па pitch, roll і yaw; у X-Plane 12 таксама восі другога пілота і "control-loaded axes" для ручак кіравання са зваротнай сувяззю па сіле; у X-Plane 11 — павелічэнне ўстойлівасці; у абедзвюх — фіксаваныя становішчы закрылкаў. Змяняюцца толькі радкі, якія ўжо ёсць у файле.
  • Зваротная сувязь па сіле: уласнай у X-Plane няма; толькі пераключальнік control-loaded.
  • Запіс тэлеметрыі: з вываду даных UDP X-Plane (порт 49000), са становішчам, таму магчымы трэк для Tacview.
  • Назіральнік: змены ў наладах JoyPro заўважае пасля закрыцця X-Plane (назіральнік).
Тэхнічныя падрабязнасці

#Унутры інтэграцыі X-Plane

flowchart LR
  P["Ваш профіль<br/>(сувязі + прывязкі)"] --> E["engine xplane12 export<br/>(або xplane11)"]
  D["Слоты прылад<br/>VID:PID + шлях 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
Кожная версія X-Plane мае свой файл налад. Каліброўка і нулявая зона застаюцца за X-Plane.

Код: engine\Games\XPlaneIntegration.cs (адзін асобнік на версію), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (профілі з часоў да падзелу на дзве версіі пераносяцца пры загрузцы).

  • Радкі: _joy_AXIS_use<i> (код прызначэння), _joy_rev_axis<i>, _joy_BUTN_use<i> (шлях каманды, sim/none/none = вольна), axis_response_curve<i>. Глабальныя індэксы: вось = слот × 25 + вось, кнопка = слот × 160 + кнопка.
  • Прылады: слоты _joy_unique_id<slot> VID:<dec>PID:<dec>; пры аднолькавых прыладах шлях інтэрфейсу HID у DirectInput павінен супадаць з _joy_location<slot>. Кнопкі — гэта кнопкі прылады, потым першы Hat як 8 кнопак па гадзіннікавай стрэлцы ад верху; іншыя Hat не супастаўляюцца. Чытаюцца 160 кнопак і 25 восей на прыладу.
  • Коды прызначэння: ад 0 да 66 у абедзвюх версіях; X-Plane 12 дадае throttle 9, pitch/roll/yaw/тармазы/рулявое кола другога пілота і абодва колавыя тармазы. Коды ад 74 да 77 і восі агляду не ўнесены ў каталог.
  • Спіс каманд: engine xplane12 refresh-db / engine xplane11 refresh-db: табліца восей версіі плюс групы каманд палёту з Commands.txt (sim/flight_controls, engines, autopilot, lights ...; не sim/view, operation, replay ...).
  • Імпарт / экспарт: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), тое ж самае для engine xplane11 export. Спачатку рэзервовая копія ў .jpbak.
  • Налады і крывыя: 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 (вымерана ў X-Plane 12.4.3 з дакладнасцю да 0.0001).

#Вядомыя абмежаванні

  • Значэнне кодаў прызначэння ад 74 да 77; парадак восей HID у параўнанні з DirectInput выведзены ўскосна.
  • Control Sensitivity у X-Plane без крывой не ўваходзіць у папярэдні прагляд.
  • X-Plane 11 правераны толькі па яго ўсталяваных файлах; праверка ў меню гульні яшчэ наперадзе.
  • Тэсты: engine\tests\smoke\xplane.ps1; у гульні (X-Plane 12) прывязкі і крывыя водгуку прайшлі 33 з 33 крокаў; tools\e2e\games\XPlaneCurves.ps1 праганяе кожную вось і параўноўвае з папярэднім праглядам JoyPro.

Усе тэхнічныя нататкі пра гэту гульню (створаны з рэпазіторыя): xplane.md.