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 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
симулятор має бути закритий
До: один раз запустіть симулятор з підключеними пристроями, потім закрийте його.
Потім: відкрийте налаштування керування симулятора й перевірте призначення. Цю інтеграцію ще не перевіряли на справжній інсталяції: будь ласка, повідомте, що відрізняється.
Ви вже прив'язували кнопки в симуляторі? Тоді сторінка «Початок» запропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаться, а нові завдання отримають лише вільні кнопки. Див. Швидкий старт: як змусити ручку працювати.
#Що 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 знаходить його карту за назвою, якщо цю назву має рівно один підключений пристрій (з попередженням).
- Бракує прив'язки 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.