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 крокі
- Наладзіць усё за мяне
на старонцы «Старт» - Выкарыстаць гэтыя кнопкі
спачатку паглядзіце спіс - Запісаць у маю гульню
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
- Адкрыйце Старт. Картка X-Plane 12 (або X-Plane 11) паказвае малюнак гульні. Калі яна просіць спіс каманд, націсніце Пабудаваць спіс: JoyPro чытае
Resources\plugins\Commands.txtусталяванага X-Plane. - Націсніце Імпарт на картцы і выберыце Дадаць у мой профіль (у гэтым файле X-Plane няма прывязак клавіятуры).
- Націсніце Імпартаваць зараз. Паглядзець мае сувязі адкрывае тое, што было імпартавана.


#Стварэнне і праверка сувязей
На старонцы Сувязі каманда або вось X-Plane у сувязі стаіць побач з той жа функцыяй у вашых іншых гульнях. Аб'яднайце іх з дапамогай працэсу сувязей, потым націсніце Праверыць зараз на старонцы «Экспарт» (праверка).
#Экспарт у X-Plane
- Закрыйце X-Plane. Ён перазапісвае свае налады, калі зачыняецца акно налад, і пры выхадзе. Абедзве версіі працуюць як
X-Plane.exe, таму JoyPro адмаўляецца запісваць, пакуль працуе любая з іх. - Адкрыйце Экспарт. Кожная ўсталяваная версія мае сваю картку.
- Пакіньце Замяніць на маіх прыладах разам з Ачысціць і іншыя мае прылады, калі вы наладжваеце свае прылады ў JoyPro. Націсніце Экспартаваць зараз на картцы.
Запусціце 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
Код: 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.