JoyPro2 Discord GitHub
Ігри

Microsoft Flight Simulator 2024

Показати:

MSFS 2024 зберігає ваше керування в профілях, по одному на пристрій і категорію (Airplanes і General), і пам'ятає для кожного пристрою й літака, який профіль він використовує. JoyPro читає ці профілі в один власний профіль і записує ваші прив'язки назад саме в ті профілі, які використовує симулятор, у версіях Steam і Microsoft Store. Для літаків, які симулятор ще не налаштував для пристрою, JoyPro додає власні пресети невеликим пакетом у теці симулятора Community2024, а там, де не може записати профіль, залишає вам файл для імпорту в меню Controls симулятора.

Microsoft Flight Simulator 2024 напряму (власні файли прив'язок)
Підтримка
напряму (власні файли прив'язок)
Команда рушія
engine msfs2024
Файл прив'язок
ваш власний профіль, який симулятор використовує для кожного пристрою й категорії (XML Steam remote\inputprofile_* або збереження Microsoft Store, --user-profiles) + пакет Community від JoyPro (joypro-input-profiles, один XML пресета на пристрій); файли імпорту в Documents\JoyPro2\MSFS 2024 import files, де ваш профіль не можна записати
Входи, які читає гра
читає 8 осей, 1 хет (4 напрямки) на joystick (задокументовано)
Список команд з
файли пресетів Asobo, польотні події, які називає fs-base\en-US.locPak, встановлені літаки
Внутрішньоігровий тест
26/26 кроків пройдено (2026-10-11)
  • ✓ Імпорт
  • ✓ Експорт
  • ✗ Прив'язки клавіатури
  • ◐ МодифікаториMSFS: лише кнопки-модифікатори того самого пристрою.
  • ✓ Список команд, створений на вашому ПК
  • ✓ Спостерігач за іграми
  • ✓ Криві осей і мертві зони
  • ✗ Налаштування керування гри
  • ✗ Налаштування Force Feedback у грі
  • ✗ Force Feedback з телеметрії
  • ✓ Запис телеметрії
  • ✓ Віртуальний joystick (vJoy)
  • ◐ Віртуальний геймпад Xbox
  • ✓ Віртуальні функції
  • ✓ Майстер налаштування / Auto Assign
  • ✓ Кабіни
  • ✓ Шпаргалки
  • ✓ Внутрішньоігровий тест

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

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

#Запуск за 3 кроки

  1. Налаштувати все за мене
    на сторінці «Початок»
  2. Використати ці кнопки
    спершу перегляньте список
  3. Записати в мою гру
    симулятор має бути закритий

До: один раз підключіть кожен пристрій.

Потім: прочитайте блок Ваші профілі MSFS 2024. Він називає файл імпорту? Тоді імпортуйте цей файл у симуляторі (див. Що ви робите самі нижче).

Ви вже прив'язували кнопки в MSFS 2024? Тоді сторінка «Початок» запропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаться, а нові завдання отримають лише вільні кнопки. Див. Швидкий старт: як змусити ручку працювати.

#Що JoyPro робить для MSFS 2024

  • Імпорт: профілі, які ви створили в меню Controls симулятора (Steam або Microsoft Store), потрапляють у ваш профіль — льотні прив'язки й прив'язки General (камери, види, активна пауза тощо) разом із налаштуваннями осей зі сторінки Sensitivity. Пристрій, який ви ніколи не змінювали в симуляторі, приносить пресет, що постачається для нього із симулятором, якщо власні записи симулятора показують, що він цей пресет використовує.
  • Зв'язки: один зв'язок — це одна функція. У MSFS 2024 зв'язок може бути для всіх літаків (за замовчуванням) або лише для позначених вами літаків, як у DCS.
  • Експорт: JoyPro записує ваші прив'язки в профіль, який симулятор використовує для кожного пристрою й категорії, записує свій пакет пресетів для літаків, які симулятор ще не налаштував, і записує файл імпорту там, де не зміг оновити ваш профіль.

#Імпорт ваших прив'язок MSFS 2024

  1. Відкрийте Початок і натисніть Імпорт на картці Microsoft Flight Simulator 2024.
  2. Для MSFS важливі два параметри, обидва вимкнені, доки ви їх не позначите:
    • Імпортувати й непідключені пристрої: MSFS зберігає прив'язки кожного пристрою, який будь-коли бачив. Вимкнено: лише пристрої, підключені зараз.
    • Імпортувати й стандартні пресети, які симулятор може не використовувати: для пристроїв, для яких записи симулятора не показують використання стандартного пресета. Це може додати прив'язки, яких у симуляторі немає.
  3. Натисніть Імпортувати зараз (або Спершу переглянути, щоб побачити, що є в симуляторі, не змінюючи свій профіль).

Імпортовані зв'язки діють для всіх літаків. Коли прив'язка є лише в профілях деяких літаків, сторінка Зв'язки після імпорту показує примітку з кнопками Обмежити цими літаками для кожного зв'язку, Обмежити всі і Залишити для всіх літаків.

Сторінка «Початок» з вашими іграмиСторінка «Початок» з вашими іграми
Сторінка «Початок» з вашими іграми (Зображення показують застосунок англійською.)

#Створення й перевірка зв'язків

На сторінці Зв'язки дія MSFS 2024 показує літаки симулятора з позначками: позначено всі літаки — означає всі літаки. Дія, яка є лише в деяких додаткових літаках, пише «лише для:» з цими літаками, і під час додавання позначаються тільки вони. Див. процес зв'язків, потім запустіть Перевірку на сторінці «Експорт»: вона знаходить кнопку з двома функціями раніше за симулятор.

#Експорт у MSFS 2024

  1. Закрийте MSFS 2024. JoyPro відмовляється записувати, поки симулятор працює (у версії Microsoft Store також поки працює його помічник запуску).
  2. Відкрийте Експорт. У розділі Експорт в ігри дві позначки стосуються MSFS 2024:
    • MSFS 2024: записувати в мої профілі MSFS (увімкнено): експорт оновлює профіль, який симулятор використовує для кожного пристрою й категорії, спершу зробивши резервну копію.
    • MSFS 2024: файли імпорту для кожного пристрою (вимкнено): файл імпорту для кожного пристрою й категорії, а не лише там, де JoyPro не зміг записати ваш профіль.
  3. Залиште Замінити на моїх пристроях разом з Очистити й інші мої пристрої, якщо ви налаштовуєте свої пристрої в JoyPro, і натисніть Експортувати зараз на картці MSFS 2024.

Після експорту блок Ваші профілі MSFS 2024 перелічує кожен профіль, який записав JoyPro, з його літаками й кількістю прив'язок. Якщо було записано файли імпорту, другий блок називає їх і має кнопку Відкрити папку.

Сторінка «Експорт»Сторінка «Експорт»
Сторінка «Експорт»
У грі: Що ви бачите в MSFS 2024

Запустіть симулятор і відкрийте Settings > Controls, потім виберіть свій пристрій і категорію (Airplanes або General). Ваші прив'язки є у вашому власному профілі під назвами дій симулятора; сторінка пристрою (Hardware Settings під шестернею пристрою) показує криві осей, які записав JoyPro. У літаку, який симулятор ще не налаштував для цього пристрою, пристрій починає з пресета JoyPro.

#Що ви робите самі в MSFS 2024

  • Нічого — для кожного профілю, позначеного як оновлений у Ваші профілі MSFS 2024.
  • Файли імпорту: коли експорт перелічує такий файл, відкрийте Settings > Controls, виберіть пристрій і категорію (Airplanes або General), клацніть шестерню профілю (не пресета), виберіть Імпорт і вкажіть файл, який JoyPro записав для цього пристрою й категорії. Симулятор приймає файл лише для того самого пристрою й категорії. Коли файл має назву вашого профілю, симулятор запитує, чи перезаписати його: підтвердьте, і ваш профіль отримає прив'язки JoyPro. Імпортуйте файл знову лише тоді, коли експорт пише, що він новий або змінений.
  • Перед першим експортом один раз підключіть кожен пристрій: JoyPro потрібен ID продукту пристрою для його пресета.
  • Одному літаку потрібні інші прив'язки, ніж іншим: дайте йому власний профіль у симуляторі (Controls, із завантаженим цим літаком: продублюйте профіль), потім експортуйте знову. Експорт називає кожен зв'язок, який не вдалося розмістити.
  • Запитання про хмару Xbox: якщо симулятор або застосунок Xbox запитує, яке збереження залишити, залиште збереження цього ПК; інше втрачає прив'язки JoyPro (тоді експортуйте знову).

#Типові помилки

  • «MSFS 2024 запущено»: закрийте симулятор; у версії Microsoft Store також має зникнути помічник запуску симулятора (gamelaunchhelper.exe).
  • Бракує прив'язок в одному літаку: цей літак використовує інший ваш профіль. Перевірте список Ваші профілі MSFS 2024; рядок з «файл імпорту» означає, що цей файл треба імпортувати в симуляторі.
  • Зв'язок не записано: він обмежений деякими літаками, але профіль, який симулятор там використовує, спільний з іншими літаками. Попередження називає профіль і літаки.
  • Пристрій має кілька профілів: імпорт бере той, що названо в записах симулятора, інакше найновіший, і називає інші. Інший можна вибрати в Профіль гри у формі Інші ігри на сторінці «Початок».
  • «WRONG DEVICE» під час прив'язування в симуляторі: пристрій, який постійно надсилає значення (деякі ручки з Force Feedback), перехоплює сканування симулятора. Це відбувається під час прив'язування в самому симуляторі, а не в JoyPro.
  • Reset to Defaults у симуляторі скидає пресети кожного пристрою й літака; JoyPro ніколи не робить цього за вас.
Розширені

#Файли, які JoyPro читає й записує

Файл Що це
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> ваш власний профіль (Steam), звичайний XML без розширення; записується на місці, Steam Cloud вивантажує його під час наступної синхронізації
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ збереження Microsoft Store (containers.index, container.<n>, один blob на профіль); JoyPro записує новий blob, новий файл контейнера й індекс
remote\profile_00 (Store: контейнер profile_00) записи пристроїв симулятора: який профіль чи пресет використовує кожен пристрій для кожного літака. Лише читання, ніколи не записуються
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml пресет JoyPro для пристрою (польотні дії), з layout.json і manifest.json
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml пресет JoyPro для прив'язок General пристрою
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml файли імпорту, у власному форматі профілів симулятора
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak пресети, які постачає Asobo, і назви меню: лише читання, для списку команд і типових пресетів
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS дані JoyPro про належність і резервні копії, ніколи не в синхронізованій папці

<packages> — це InstalledPackagesPath з %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Перед кожним записом уся папка збережень Store або файл Steam потрапляє до набору резервних копій, тож Скасувати останній експорт повертає збереження.

#Режими експорту в MSFS 2024

Режими працюють для кожного профілю (тобто для кожної групи літаків) і лише в керованих контекстах.

Режим Що відбувається у ваших профілях MSFS 2024
Лише додати Прив'язка записується лише там, де жодна інша дія цього профілю не використовує цю комбінацію входів; інакше вона потрапляє до списку незаписаних. Нічого не видаляється.
Оновити, зберегти прив'язки гри Інша дія на вашій комбінації входів її втрачає; усе інше залишається, також стара комбінація дії (дія має дві: Primary і Secondary).
Оновити, мій профіль головніший Як вище, і кожна дія, яку ви прив'язуєте, втрачає свої інші комбінації, також у профілях інших підключених пристроїв (ці профілі теж записуються).
Замінити на моїх пристроях Профілі підключених пристроїв, у які записує JoyPro, зберігають лише ваші прив'язки.
+ Очистити й інші мої пристрої Ніколи не очищає жодного з ваших власних профілів MSFS 2024.

Зв'язок для всіх літаків іде в кожен профіль, який називають записи симулятора; зв'язок, обмежений літаками, іде лише в профілі, усі літаки яких позначено. Обмежені зв'язки ніколи не потрапляють у пакет пресетів чи файли імпорту, бо ті діють для всіх літаків.

#Що ніколи не змінюється

  • Контексти меню, мапи світу й розробника (MENU, MENU_*, WORLDMAP_*, DEBUG, DEVMODE*, EDITOR_*, MISSION_FLOW_TOOLS) у кожному режимі.
  • Профілі клавіатури, миші й геймпада (GUID="{0}"): прив'язки клавіатури в MSFS не записуються.
  • profile_00, пресети, які постачає Asobo, слоти пресетів для конкретних літаків і кожен інший контейнер збереження Store (бортові журнали, інші ігри).
  • Пристрої, які не підключено, пристрої, ігноровані під час імпорту, і пристрій vJoy, у який передає JoyPro.

#Літаки, криві, решта

  • Деталізація: для кожного пристрою й категорії (Airplanes, General) і для кожного профілю; симулятор вибирає профіль для кожного пристрою й літака, JoyPro дотримується цього вибору.
  • Криві осей: сторінка Sensitivity пристрою, один набір на фізичну вісь: Sensitivity + і -, Neutral, Dead zone, Extremity dead zone, Reactivity, позначка «без кривої» та інверсія. Зв'язок може дати одній дії власні значення (перевизначення для окремої дії в MSFS 2024). Зв'язки на тій самій осі пристрою ділять її сторінку: експорт записує значення першого зв'язку й попереджає. Див. axis-curves.
  • Force Feedback: власного в MSFS немає.
  • Запис телеметрії: через SimConnect, лише читання, з вашим власним SimConnect.dll (JoyPro його не постачає): у версії Steam MSFS 2024 його немає, тож установіть MSFS 2024 SDK або майте встановлений MSFS 2020 (його копія теж працює).
  • HUD: HUD знаходить симулятор за його процесом і показує його прив'язки.
  • Спостерігач: JoyPro стежить за своїм пакетом, профілями Steam і containers.index збереження Store; після закриття симулятора (збереження Store чекає 10 с після останнього запису) він питає, чи перенести ваші зміни з гри (спостерігач).
  • Повторний імпорт: назви зв'язків, групи й налаштування осей повертаються через метадані JoyPro поруч із файлами (повторний імпорт).
  • Експертні параметри (Інші ігри на сторінці «Початок»): Профіль гри (вибрати один профіль, коли пристрій має кілька), Експорт літака (експортувати також зв'язки, обмежені одним літаком, для всіх літаків), Записувати в мої профілі MSFS, Також записувати файли імпорту MSFS для кожного пристрою, пробний запуск.
Технічні подробиці

#Усередині інтеграції MSFS 2024

flowchart LR
  P["Ваш профіль"] --> E["engine msfs2024 export"]
  E --> U["Ваші власні<br/>профілі"]
  E --> K["Пресети<br/>JoyPro"]
  E --> F["Файли імпорту"]
  F --> I["Ви: шестерня,<br/>Import"]
  U --> S["Settings ><br/>Controls"]
  K --> S
  I --> S
Ваші власні профілі (Steam inputprofile_n або збереження Store) записуються напряму. Пресети JoyPro (Community2024 / joypro-input-profiles, по пресету на пристрій) обслуговують літаки, які симулятор ще не налаштував. Файли імпорту (Documents / JoyPro2) ви завантажуєте в симуляторі самі.

Код: engine\Games\MsfsIntegration.cs (один клас для обох симуляторів), MsfsIntegration.UserProfiles.cs (прямий запис), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (читання Steam і Store), WgsContainers.cs (збереження Store), MsfsSimProfile.cs (записи в profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (порядковий редактор), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.

  • Формат: фрагмент XML (кілька елементів верхнього рівня): <Version>, <FriendlyName>, <Device DeviceName GUID ProductID CompositeID HWVer> з <Axes> і <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>. Профіль 2024 перелічує кожну дію своїх контекстів, неприв'язані — як порожні <Action/>. Коди: кнопка N = N-1, хет 256-259, L-вісь X/Y/Z 1026/1042/1058, R-вісь 770/786/802, повзунки 514/530. Позначки: 2 цифрова, 4 вісь, 128 інверсія, 1024 без кривої чутливості, 4096 перевизначення осі для окремої дії. Повторно формуються лише змінені елементи <Action>.
  • Пристрої: профіль називає свій пристрій за GUID екземпляра DirectInput (GUID), тож для його читання не потрібен підключений пристрій. Симулятор зіставляє пресет за USB product ID (hex): JoyPro використовує той, що симулятор записав у profile_00, інакше USB PID (vJoy показується з product ID 0).
  • Який профіль активний: для кожного пристрою й літака записи в profile_00 містять слот General і слот категорії; власний профіль там — це inputprofile_<n>, тобто ім'я файлу в Steam і ім'я контейнера в Store.
  • Збереження Store: записується лише тоді, коли індекс має відому структуру (версія 14, без прапорця конфлікту, контейнер указано один раз у відомому стані); тоді новий blob, container.<n+1>, індекс останнім (тимчасовий файл і заміна), перевірне читання, а старе покоління видаляється. Будь-яка помилка повертає все назад; за чогось невідомого нічого не записується, а прив'язки переносить файл імпорту.
  • Список команд: engine msfs2024 refresh-db читає пресети Asobo, кожну подію польоту, названу в en-US.locPak, ваші профілі General і розпаковані пакети доповнень (Community, Marketplace) з їхніми літаками; список літаків береться зі списку вмісту симулятора. Свіжа інсталяція будує список під час першого імпорту.
  • Команди: engine msfs2024 paths, engine msfs2024 catalog, engine msfs2024 scan, engine msfs2024 import (--game-profile, --include-disconnected, --include-sim-defaults, --limit-to-profile-aircraft, --replace), engine msfs2024 export (--mode, --nuke-untouched-devices, --dry-run, --aircraft <key>; --user-profiles false і --import-files як дві позначки сторінки «Експорт»); зв'язки для окремих літаків через engine relations aircraft set; скасування через engine backups restore; спостерігач через engine sync status і engine sync diff. Стара назва CLI engine msfs ... і далі означає MSFS 2024.

#Відомі обмеження

  • Слоти пресетів для окремих літаків не записуються (вони з'являються лише з власним пакетом літака); JoyPro ніколи не записує profile_00 (файл закінчується контрольною сумою).
  • Пресет JoyPro діє лише на літаки, які симулятор ще не налаштував для пристрою; в інших випадках прив'язки переносить ваш власний профіль або файл імпорту.
  • Щонайбільше дві комбінації входів на дію; про третю повідомляється. Половини осей, діагоналі хета й другий хет не читаються й не записуються. Модифікатори: лише кнопки того самого пристрою.
  • Запаковані пакети доповнень (.fsarchive) пропускаються; шляхи збережень Store довші за 260 символів не читаються.
  • Хмарна копія (Steam Cloud, хмара Xbox) може перемогти запис JoyPro, якщо інший ПК зберіг пізніше.
  • Тести: engine\tests\smoke\msfs.ps1, smoke\msfsuserprofiles.ps1, gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs (збереження Steam і Store, профілі для окремих літаків, відкат), MsfsStoreWatcherEndToEndTests; у симуляторі tools\e2e\games\Msfs2024Settings.ps1 (пресети, осі, кнопки й крива для кожної дії в Controls).

Усі технічні примітки до цієї гри (створено з репозиторію): msfs.md.