FSX, FSX: Steam Edition и Prepar3D v4, v5 и v6 хранят ваше управление в одном XML-файле в %APPDATA%: одна карта на устройство с его осями, кнопками и хаткой, плюс клавиатура. JoyPro читает этот файл в ваш профиль, объединяет его с другими вашими играми в связках и записывает обратно блок за блоком, не трогая форматирование, комментарии и другие карты. Каждый симулятор в JoyPro — отдельная игра, потому что у каждого свой файл.
Эта интеграция написана по открытым источникам и проверена только на синтетическом тестовом файле: ни один из этих симуляторов ещё не проверялся с JoyPro на реальной установке. После первого экспорта откройте управление симулятора, проверьте назначения и, пожалуйста, сообщите, что отличается.
Microsoft Flight Simulator X напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine fsx- Файл привязок
%APPDATA%\Microsoft\FSX\Controls\Standard.XML(XML)- Входы, которые читает игра
- читает 32 кнопки, 8 осей на джойстик (по сообщениям)
- Список команд из
- собственный список событий JoyPro (публичные идентификаторы SDK) + события из ваших файлов управления и шаблона установки
- ✓ Импорт
- ✓ Экспорт
- ✓ Привязки клавиатуры
- ◐ МодификаторыFSX и Prepar3D: Ctrl/Shift/Alt на клавишах; без модификатора на привязках джойстика.
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✓ Кривые осей и мёртвые зоны
- ✗ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ◐ Мастер настройки / Автоназначение
- ✓ Кабины
- ✓ Шпаргалки
- ✗ Внутриигровой тест
Microsoft Flight Simulator X: Steam Edition напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine fsxse- Файл привязок
%APPDATA%\Microsoft\FSX-SE\Controls\(или папка FSX), XML- Входы, которые читает игра
- читает 32 кнопки, 8 осей на джойстик (по сообщениям)
- Список команд из
- как FSX
- ✓ Импорт
- ✓ Экспорт
- ✓ Привязки клавиатуры
- ◐ МодификаторыFSX и Prepar3D: Ctrl/Shift/Alt на клавишах; без модификатора на привязках джойстика.
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✓ Кривые осей и мёртвые зоны
- ✗ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ◐ Мастер настройки / Автоназначение
- ✗ Кабины
- ✓ Шпаргалки
- ✗ Внутриигровой тест
Prepar3D v4 напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine p3d4- Файл привязок
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml(XML)- Входы, которые читает игра
- читает 32 кнопки, 8 осей на джойстик (по сообщениям)
- Список команд из
- собственный список событий JoyPro + ваши файлы управления +
Standard.xmlxиз установки
- ✓ Импорт
- ✓ Экспорт
- ✓ Привязки клавиатуры
- ◐ МодификаторыFSX и Prepar3D: Ctrl/Shift/Alt на клавишах; без модификатора на привязках джойстика.
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✓ Кривые осей и мёртвые зоны
- ✗ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ◐ Мастер настройки / Автоназначение
- ✗ Кабины
- ✓ Шпаргалки
- ✗ Внутриигровой тест
Prepar3D v5 напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine p3d5- Файл привязок
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml(XML)- Входы, которые читает игра
- читает 32 кнопки, 8 осей на джойстик (по сообщениям)
- Список команд из
- как Prepar3D v4
- ✓ Импорт
- ✓ Экспорт
- ✓ Привязки клавиатуры
- ◐ МодификаторыFSX и Prepar3D: Ctrl/Shift/Alt на клавишах; без модификатора на привязках джойстика.
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✓ Кривые осей и мёртвые зоны
- ✗ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ◐ Мастер настройки / Автоназначение
- ✓ Кабины
- ✓ Шпаргалки
- ✗ Внутриигровой тест
Prepar3D v6 напрямую (собственные файлы привязок)
- Поддержка
- напрямую (собственные файлы привязок)
- Команда движка
engine p3d6- Файл привязок
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml(XML)- Входы, которые читает игра
- читает 32 кнопки, 8 осей на джойстик (по сообщениям)
- Список команд из
- как Prepar3D v4
- ✓ Импорт
- ✓ Экспорт
- ✓ Привязки клавиатуры
- ◐ МодификаторыFSX и Prepar3D: Ctrl/Shift/Alt на клавишах; без модификатора на привязках джойстика.
- ✓ Список команд строится на вашем ПК
- ✓ Наблюдатель за играми
- ✓ Кривые осей и мёртвые зоны
- ✗ Настройки управления игры
- ✗ Настройки Force Feedback в игре
- ✗ Force Feedback из телеметрии
- ✗ Запись телеметрии
- ✓ Виртуальный джойстик (vJoy)
- ◐ Виртуальный геймпад Xbox
- ✓ Виртуальные функции
- ◐ Мастер настройки / Автоназначение
- ✗ Кабины
- ✓ Шпаргалки
- ✗ Внутриигровой тест
Из матрицы поддержки, созданной по коду движка: все игры.
#Запуск за 3 шага
- Настроить всё за меня
на странице «Старт» - Использовать эти кнопки
сначала посмотрите список - Записать в мою игру
симулятор должен быть закрыт
До: запустите симулятор один раз с подключёнными устройствами, затем закройте его.
Затем: откройте настройки управления симулятора и проверьте назначения. Эта интеграция ещё не проверялась на реальной установке: пожалуйста, сообщите, что отличается.
Вы уже назначали кнопки в симуляторе? Тогда страница «Старт» предложит Импортировать, затем заполнить пробелы. Ваши привязки останутся, а новые задачи получат только свободные кнопки. См. Быстрый старт: заставить ручку работать.
#Что JoyPro делает для FSX и Prepar3D
- Импорт: оси, кнопки и хатки ваших устройств попадают в ваш профиль вместе с чувствительностью и нулевой зоной каждой оси. Клавиши клавиатуры приходят, если вы о них просите.
- Связки: одна связка — это одна функция во всех ваших играх («Gear» в FSX, MSFS и X-Plane на одной кнопке). Команды — это открытые названия событий симуляторов (
GEAR_TOGGLE,AXIS_AILERONS_SET...). - Экспорт: JoyPro записывает активный файл управления симулятора, в который вы экспортируете.
#Импорт ваших привязок
- Откройте Старт. Карточка вашего симулятора показывает его картинку. Если она просит список команд, нажмите Создать список: JoyPro объединяет свой список событий с событиями, которые называют ваши файлы управления (и собственные файлы-шаблоны симулятора).
- Нажмите Импорт на карточке. Выберите Добавить в мой профиль и отметьте Брать также клавиши клавиатуры, если вам нужны и клавиши.
- Нажмите Импортировать. Мои связки открывает то, что пришло.
#Создание и проверка связок
На странице Связки событие симулятора в связке стоит рядом с той же функцией ваших других игр. Объедините их с помощью работы со связками, затем нажмите Проверить на странице «Экспорт» (Проверка).
#Экспорт
- Закройте симулятор. Он перезаписывает файл при выходе; JoyPro отказывается работать, пока запущен
fsx.exeилиPrepar3D.exe. - Откройте Экспорт и используйте карточку вашего симулятора.
- Оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете устройства в JoyPro. Нажмите Экспортировать на карточке.
Запустите симулятор и откройте его настройки управления: там видны назначения ваших устройств, а чувствительность и нулевая зона каждой оси — на её странице калибровки. Точный путь в меню и то, как симуляторы показывают файл JoyPro, пока не подтверждены.
#Что вы делаете сами в FSX и Prepar3D
- Запустите симулятор один раз с подключёнными устройствами, чтобы он записал свой файл управления.
- Проверьте результат после первого экспорта (см. выше). Это первая настоящая проверка этой интеграции на вашем ПК.
- Хатка назначается целиком и обычно служит для поворота обзора (
PAN_VIEW). Другие события на отдельных направлениях хатки не записываются; привяжите их в симуляторе.
#Частые ошибки
- «Симулятор работает»: закройте его и снова выполните экспорт.
- Устройство потеряло привязки после переподключения: Windows может выдать устройству новый GUID. Тогда JoyPro находит его карту по имени, если это имя есть ровно у одного подключённого устройства (с предупреждением).
- Не хватает привязки джойстика с модификатором: формат не поддерживает модификаторы на кнопках джойстика. У клавиш могут быть Ctrl, Shift и Alt.
#Файлы, которые JoyPro читает и записывает
| Симулятор | Файл управления |
|---|---|
| FSX (коробочная версия) | %APPDATA%\Microsoft\FSX\Controls\Standard.XML (активный файл из fsx.cfg [CONTROLS] Controls_Current) |
| FSX: Steam Edition | %APPDATA%\Microsoft\FSX-SE\Controls\ рядом с коробочной FSX, %APPDATA%\Microsoft\FSX\Controls\, если установлена одна |
| Prepar3D v4 / v5 / v6 | %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml (активный файл из Prepar3D.cfg [CONTROLS]) |
| все | <file>.joypro.json (входы, которые записал JoyPro), <file>.joypro-meta.json (имена, группы и настройка осей для следующего импорта) |
Standard.xmlx из Prepar3D (пресеты устройств) и шаблон FSX в папке установки читаются для списка команд и никогда не записываются.
#Режимы экспорта в FSX и Prepar3D
| Режим | Что происходит в симуляторе |
|---|---|
| Только добавить | Никогда не удаляет и не заменяет блок. Привязка на входе, у которого есть другое событие, не записывается и попадает в список. |
| Обновить, привязки игры сохранить | Заменяет событие на вашем входе (конфликт) и сохраняет всё остальное. |
| Обновить, мой профиль важнее | Также удаляет другие входы привязанных вами событий (подключённые устройства; клавиатура — только с параметром клавиатуры). |
| Заменить на моих устройствах | Основные карты записываемых устройств сохраняют только ваши привязки. |
| + Очистить и другие мои устройства | Основные карты других подключённых устройств очищаются (сами карты остаются). |
#Что никогда не затрагивается
- Карты неподключённых устройств, игнорируемые при импорте устройства и устройство vJoy, в которое передаёт JoyPro.
- Карты slew (
... SLEW {GUID}),Mouse Yoke,Mouse Look, карты отдельных SimObject в Prepar3D и карта клавиатуры, если вы не экспортируете привязки клавиатуры. - Сочетания из двух обычных клавиш, комментарии, форматирование и неизвестные элементы.
#Кривые и настройки
- Детализация: общая, один файл для всех ЛА.
- Настройки осей (модель осей
fsx): чувствительность (от 0 до 127) и нулевая зона (от 0 до 127) для каждой оси устройства, как на странице калибровки. Кривая по умолчанию подгоняется (мёртвая зона — к нулевой зоне, насыщение — к чувствительности); у формы кривой эквивалента нет. В режиме Update значения, заданные в симуляторе, остаются, если у JoyPro стоят обычные значения по умолчанию. - Инверсия: отрицательная чувствительность.
- Нет Force Feedback, настроек игры и телеметрии. Отслеживание замечает изменения после закрытия симулятора.
#Внутри интеграции FSX и Prepar3D
flowchart LR
P["Ваш профиль<br/>(связки + привязки)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
E --> X["Controls / Standard.XML:<br/>одна карта на устройство<br/>(имя устройства {GUID}),<br/>KEYBOARD_MAIN (только с параметром<br/>клавиатуры)"]
X --> G["Настройки управления симулятора"]
Код: engine\Games\FsxIntegration.cs (один класс, по одной игре на симулятор), engine\Games\FsxControlsFile.cs (текстовая правка целых блоков), engine\Games\FsxEvents.cs (список событий JoyPro).
- Формат:
<SimControls.Map>с<Name>,<Axis>(<Index>от 0 до 7 = X, Y, Z, Rx, Ry, Rz, Slider, второй ползунок;<AxEvent>,<AxScale>,<AxNull>),<Entry>(<Index>кнопки с отсчётом от 0,<Down>/<Up>,<DownRpt>1для повторяющихся событий) и<POV>(целая хатка). Заголовокencoding="Windows-1252". - Устройства: по карте на каждое устройство DirectInput с именем
<instance name>{<instance GUID>}; сопоставляется по GUID, иначе по имени, если оно есть ровно у одного подключённого устройства. Устройство, которого нет в файле, получает новую карту. Сообщается о 32 кнопках и 8 осях на устройство. - Сопоставление:
JOY_X..JOY_SLIDER2к<Index>от 0 до 7,JOY_BTN<n>к<Index>n-1, хатка — по её направлению вверх (JOY_BTN_POV1_U). - Список команд:
engine fsx refresh-db(а такжеfsxse,p3d4,p3d5,p3d6): около 150 событий с названиями JoyPro плюс все события, названные в ваших файлах управления и шаблонах симулятора; событияAXIS_*— это оси. - Импорт / экспорт:
engine fsx paths(сначала активный файл),engine fsx import,engine fsx scan,engine fsx export, и то же дляengine fsxse export,engine p3d4 export,engine p3d5 export,engine p3d6 export. Резервная копия перед первой записью.
#Известные ограничения
- Всё нужно проверить на настоящей установке: заголовок Prepar3D v4+ и содержит ли
<Name>по-прежнему GUID, точные байты, которые записывают симуляторы, имя оси второго ползунка и сохраняет ли симулятор новую карту, которую JoyPro добавляет для ещё не виденного им устройства. - Имя файла конфигурации FSX: Steam Edition выведено логически.
- Тесты:
engine\tests\smoke\fsx.ps1с синтетическим файлом, собранным по описанному формату.
Все технические заметки по этой игре (созданы из репозитория): fsx-p3d.md.