JoyPro2 Discord GitHub
Игры

X-Plane 12 / 11

Показать:

X-Plane хранит назначения всех ваших устройств в одном файле настроек внутри своей установки: «назначение» оси (тангаж, РУД, закрылки ...) для каждой аппаратной оси, команда для каждой кнопки и необязательные кривые отклика. 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 хатку на джойстик (проверено)
Список команд из
Resources\plugins\Commands.txt
Внутриигровой тест
33/33 шагов пройдено (2026-10-11)
  • ✓ Импорт
  • ✓ Экспорт
  • ✗ Привязки клавиатуры
  • ✗ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✓ Кривые осей и мёртвые зоны
  • ✓ Настройки управления игры
  • ◐ Настройки Force Feedback в игреX-Plane 12: только переключатель «control-loaded axes» для каждого устройства, для ручек с Force Feedback; собственных эффектов Force Feedback для ручки у симулятора нет (только плагины).
  • ✗ Force Feedback из телеметрии
  • ✓ Запись телеметрии
  • ✓ Виртуальный джойстик (vJoy)
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ✓ Мастер настройки / Автоназначение
  • ✓ Кабины
  • ✓ Шпаргалки
  • ✓ Внутриигровой тест
X-Plane 11 напрямую (собственные файлы привязок)
Поддержка
напрямую (собственные файлы привязок)
Команда движка
engine xplane11
Файл привязок
как X-Plane 12
Входы, которые читает игра
читает 160 кнопок, 25 осей, 1 хатку на джойстик (проверено)
Список команд из
Resources\plugins\Commands.txt
  • ✓ Импорт
  • ✓ Экспорт
  • ✗ Привязки клавиатуры
  • ✗ Модификаторы
  • ✓ Список команд строится на вашем ПК
  • ✓ Наблюдатель за играми
  • ✓ Кривые осей и мёртвые зоны
  • ✓ Настройки управления игры
  • ✗ Настройки Force Feedback в игре
  • ✗ Force Feedback из телеметрии
  • ✓ Запись телеметрии
  • ✓ Виртуальный джойстик (vJoy)
  • ◐ Виртуальный геймпад Xbox
  • ✓ Виртуальные функции
  • ✓ Мастер настройки / Автоназначение
  • ✓ Кабины
  • ✓ Шпаргалки
  • ✗ Внутриигровой тест

Из матрицы поддержки, созданной по коду движка: все игры.

Для начинающих

#Запуск за 3 шага

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

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

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

Вы уже назначали кнопки в X-Plane? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить мою ручку работать.

#Что JoyPro делает для X-Plane

  • Импорт: назначения осей, команды кнопок, флаги реверса и кривые отклика ваших устройств попадают в ваш профиль.
  • Связки: одна связка — это одна функция во всех ваших играх («Gear» в 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 сам переворачивает РУД).
  • Настройки игры (Настройки > Настройки FFB игр): отклик управления по тангажу, крену и рысканию; в X-Plane 12 также оси второго пилота и «control-loaded axes» для ручек с Force Feedback; в X-Plane 11 — система повышения устойчивости; в обеих — фиксированные положения закрылков. Меняются только строки, которые уже есть в файле.
  • Force Feedback: собственного у X-Plane нет; есть только переключатель control-loaded.
  • Запись телеметрии: из 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.