JoyPro2 Discord GitHub
Игры

FSX и Prepar3D

Показать:

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 шага

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

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

Затем: откройте настройки управления симулятора и проверьте назначения. Эта интеграция ещё не проверялась на реальной установке: пожалуйста, сообщите, что отличается.

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

#Что JoyPro делает для FSX и Prepar3D

  • Импорт: оси, кнопки и хатки ваших устройств попадают в ваш профиль вместе с чувствительностью и нулевой зоной каждой оси. Клавиши клавиатуры приходят, если вы о них просите.
  • Связки: одна связка — это одна функция во всех ваших играх («Gear» в FSX, MSFS и X-Plane на одной кнопке). Команды — это открытые названия событий симуляторов (GEAR_TOGGLE, AXIS_AILERONS_SET ...).
  • Экспорт: JoyPro записывает активный файл управления симулятора, в который вы экспортируете.

#Импорт ваших привязок

  1. Откройте Старт. Карточка вашего симулятора показывает его картинку. Если она просит список команд, нажмите Создать список: JoyPro объединяет свой список событий с событиями, которые называют ваши файлы управления (и собственные файлы-шаблоны симулятора).
  2. Нажмите Импорт на карточке. Выберите Добавить в мой профиль и отметьте Брать также клавиши клавиатуры, если вам нужны и клавиши.
  3. Нажмите Импортировать. Мои связки открывает то, что пришло.

#Создание и проверка связок

На странице Связки событие симулятора в связке стоит рядом с той же функцией ваших других игр. Объедините их с помощью работы со связками, затем нажмите Проверить на странице «Экспорт» (Проверка).

#Экспорт

  1. Закройте симулятор. Он перезаписывает файл при выходе; JoyPro отказывается работать, пока запущен fsx.exe или Prepar3D.exe.
  2. Откройте Экспорт и используйте карточку вашего симулятора.
  3. Оставьте Заменить на моих устройствах вместе с Очистить и другие мои устройства, если вы настраиваете устройства в JoyPro. Нажмите Экспортировать на карточке.
В игре: Что вы видите в FSX и Prepar3D

Запустите симулятор и откройте его настройки управления: там видны назначения ваших устройств, а чувствительность и нулевая зона каждой оси — на её странице калибровки. Точный путь в меню и то, как симуляторы показывают файл 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.