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 осей на joystick (за повідомленнями)
Список команд з
власний список подій JoyPro (публічні ідентифікатори SDK) + події з ваших файлів керування та шаблону встановлення
  • ✓ Імпорт
  • ✓ Експорт
  • ✓ Прив'язки клавіатури
  • ◐ МодифікаториFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без модифікатора на прив'язках joystick.
  • ✓ Список команд, створений на вашому ПК
  • ✓ Спостерігач за іграми
  • ✓ Криві осей і мертві зони
  • ✗ Налаштування керування гри
  • ✗ Налаштування Force Feedback у грі
  • ✗ Force Feedback з телеметрії
  • ✗ Запис телеметрії
  • ✓ Віртуальний joystick (vJoy)
  • ◐ Віртуальний геймпад Xbox
  • ✓ Віртуальні функції
  • ◐ Майстер налаштування / Auto Assign
  • ✓ Кабіни
  • ✓ Шпаргалки
  • ✗ Внутрішньоігровий тест
Microsoft Flight Simulator X: Steam Edition напряму (власні файли прив'язок)
Підтримка
напряму (власні файли прив'язок)
Команда рушія
engine fsxse
Файл прив'язок
%APPDATA%\Microsoft\FSX-SE\Controls\ (або тека FSX), XML
Входи, які читає гра
читає 32 кнопки, 8 осей на joystick (за повідомленнями)
Список команд з
як FSX
  • ✓ Імпорт
  • ✓ Експорт
  • ✓ Прив'язки клавіатури
  • ◐ МодифікаториFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без модифікатора на прив'язках joystick.
  • ✓ Список команд, створений на вашому ПК
  • ✓ Спостерігач за іграми
  • ✓ Криві осей і мертві зони
  • ✗ Налаштування керування гри
  • ✗ Налаштування Force Feedback у грі
  • ✗ Force Feedback з телеметрії
  • ✗ Запис телеметрії
  • ✓ Віртуальний joystick (vJoy)
  • ◐ Віртуальний геймпад Xbox
  • ✓ Віртуальні функції
  • ◐ Майстер налаштування / Auto Assign
  • ✗ Кабіни
  • ✓ Шпаргалки
  • ✗ Внутрішньоігровий тест
Prepar3D v4 напряму (власні файли прив'язок)
Підтримка
напряму (власні файли прив'язок)
Команда рушія
engine p3d4
Файл прив'язок
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml (XML)
Входи, які читає гра
читає 32 кнопки, 8 осей на joystick (за повідомленнями)
Список команд з
власний список подій JoyPro + ваші файли керування + Standard.xmlx зі встановлення
  • ✓ Імпорт
  • ✓ Експорт
  • ✓ Прив'язки клавіатури
  • ◐ МодифікаториFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без модифікатора на прив'язках joystick.
  • ✓ Список команд, створений на вашому ПК
  • ✓ Спостерігач за іграми
  • ✓ Криві осей і мертві зони
  • ✗ Налаштування керування гри
  • ✗ Налаштування Force Feedback у грі
  • ✗ Force Feedback з телеметрії
  • ✗ Запис телеметрії
  • ✓ Віртуальний joystick (vJoy)
  • ◐ Віртуальний геймпад Xbox
  • ✓ Віртуальні функції
  • ◐ Майстер налаштування / Auto Assign
  • ✗ Кабіни
  • ✓ Шпаргалки
  • ✗ Внутрішньоігровий тест
Prepar3D v5 напряму (власні файли прив'язок)
Підтримка
напряму (власні файли прив'язок)
Команда рушія
engine p3d5
Файл прив'язок
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml (XML)
Входи, які читає гра
читає 32 кнопки, 8 осей на joystick (за повідомленнями)
Список команд з
як Prepar3D v4
  • ✓ Імпорт
  • ✓ Експорт
  • ✓ Прив'язки клавіатури
  • ◐ МодифікаториFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без модифікатора на прив'язках joystick.
  • ✓ Список команд, створений на вашому ПК
  • ✓ Спостерігач за іграми
  • ✓ Криві осей і мертві зони
  • ✗ Налаштування керування гри
  • ✗ Налаштування Force Feedback у грі
  • ✗ Force Feedback з телеметрії
  • ✗ Запис телеметрії
  • ✓ Віртуальний joystick (vJoy)
  • ◐ Віртуальний геймпад Xbox
  • ✓ Віртуальні функції
  • ◐ Майстер налаштування / Auto Assign
  • ✓ Кабіни
  • ✓ Шпаргалки
  • ✗ Внутрішньоігровий тест
Prepar3D v6 напряму (власні файли прив'язок)
Підтримка
напряму (власні файли прив'язок)
Команда рушія
engine p3d6
Файл прив'язок
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml (XML)
Входи, які читає гра
читає 32 кнопки, 8 осей на joystick (за повідомленнями)
Список команд з
як Prepar3D v4
  • ✓ Імпорт
  • ✓ Експорт
  • ✓ Прив'язки клавіатури
  • ◐ МодифікаториFSX і Prepar3D: Ctrl/Shift/Alt на клавішах; без модифікатора на прив'язках joystick.
  • ✓ Список команд, створений на вашому ПК
  • ✓ Спостерігач за іграми
  • ✓ Криві осей і мертві зони
  • ✗ Налаштування керування гри
  • ✗ Налаштування Force Feedback у грі
  • ✗ Force Feedback з телеметрії
  • ✗ Запис телеметрії
  • ✓ Віртуальний joystick (vJoy)
  • ◐ Віртуальний геймпад Xbox
  • ✓ Віртуальні функції
  • ◐ Майстер налаштування / Auto Assign
  • ✗ Кабіни
  • ✓ Шпаргалки
  • ✗ Внутрішньоігровий тест

З матриці підтримки, створеної з коду рушія: усі ігри.

Для початківців

#Запуск за 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 знаходить його карту за назвою, якщо цю назву має рівно один підключений пристрій (з попередженням).
  • Бракує прив'язки joystick з модифікатором: формат не підтримує модифікаторів на кнопках joystick. Клавіші можуть мати 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, карти Prepar3D для окремих SimObject і карта клавіатури, якщо ви не експортуєте прив'язки клавіатури.
  • Комбінації з двох звичайних клавіш, коментарі, форматування й невідомі елементи.

#Криві й налаштування

  • Деталізація: глобальна, один файл для всіх літаків.
  • Налаштування осей (модель осей 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.