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 шага
- Настроить всё за меня
на странице «Старт» - Использовать эти кнопки
сначала посмотрите список - Записать в мою игру
держите 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
- Откройте Старт. Карточка 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 сам переворачивает РУД). - Настройки игры (Настройки > Настройки 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
Код: 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.