X-Plane зберігає призначення всіх ваших пристроїв в одному файлі налаштувань усередині своєї інсталяції: «use» осі (тангаж, газ, закрилки ...) для кожної апаратної осі, команду для кожної кнопки й необов'язкові криві відгуку. 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 хет на joystick (перевірено)
- Список команд з
Resources\plugins\Commands.txt- Внутрішньоігровий тест
- 33/33 кроків пройдено (2026-10-11)
- ✓ Імпорт
- ✓ Експорт
- ✗ Прив'язки клавіатури
- ✗ Модифікатори
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✓ Криві осей і мертві зони
- ✓ Налаштування керування гри
- ◐ Налаштування Force Feedback у гріX-Plane 12: лише перемикач «control-loaded axes» для кожного пристрою, для ручок із Force Feedback; власних ефектів Force Feedback для ручки симулятор не має (лише плагіни).
- ✗ Force Feedback з телеметрії
- ✓ Запис телеметрії
- ✓ Віртуальний joystick (vJoy)
- ◐ Віртуальний геймпад Xbox
- ✓ Віртуальні функції
- ✓ Майстер налаштування / Auto Assign
- ✓ Кабіни
- ✓ Шпаргалки
- ✓ Внутрішньоігровий тест
X-Plane 11 напряму (власні файли прив'язок)
- Підтримка
- напряму (власні файли прив'язок)
- Команда рушія
engine xplane11- Файл прив'язок
- як X-Plane 12
- Входи, які читає гра
- читає 160 кнопок, 25 осей, 1 хет на joystick (перевірено)
- Список команд з
Resources\plugins\Commands.txt
- ✓ Імпорт
- ✓ Експорт
- ✗ Прив'язки клавіатури
- ✗ Модифікатори
- ✓ Список команд, створений на вашому ПК
- ✓ Спостерігач за іграми
- ✓ Криві осей і мертві зони
- ✓ Налаштування керування гри
- ✗ Налаштування Force Feedback у грі
- ✗ Force Feedback з телеметрії
- ✓ Запис телеметрії
- ✓ Віртуальний 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 сам реверсує газ). - Налаштування гри (Налаштування > Налаштування force feedback ігор): відгук керування для тангажу, крену й рискання; X-Plane 12 також осі другого пілота й «осі з навантаженням керування» для ручок з Force Feedback; X-Plane 11 — підсилення стійкості; обидві — фіксатори закрилків. Змінюються лише рядки, які вже є у файлі.
- Force Feedback: X-Plane не має власного; лише перемикач навантаження керування.
- Запис телеметрії: з виводу даних UDP X-Plane (порт 49000), з положенням, тож можливий трек Tacview.
- Спостерігач: зміни в налаштуваннях помічено після закриття 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>. Кнопки — це кнопки пристрою, потім перший хет як 8 кнопок за годинниковою стрілкою від верху; інші хети не зіставляються. Читає 160 кнопок і 25 осей на пристрій. - Коди призначень: від 0 до 66 в обох версіях; X-Plane 12 додає газ 9, тангаж/крен/рискання/гальма/кермо переднього колеса другого пілота й обидва гальма коліс. Коди від 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.