JoyPro2 Discord GitHub
Ігри

X-Plane 12 / 11

Показати:

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 кроки

  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 сам реверсує газ).
  • Налаштування гри (Налаштування > Налаштування 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
Кожна версія 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>. Кнопки — це кнопки пристрою, потім перший хет як 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.