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 кроки
- Налаштувати все за мене
на сторінці «Початок» - Використати ці кнопки
спершу перегляньте список - Записати в мою гру
симулятор має бути закритий
До: один раз підключіть кожен пристрій.
Потім: прочитайте блок Ваші профілі MSFS 2024. Він називає файл імпорту? Тоді імпортуйте цей файл у симуляторі (див. Що ви робите самі нижче).
Ви вже прив'язували кнопки в MSFS 2024? Тоді сторінка «Початок» запропонує Імпортувати, потім заповнити прогалини. Ваші прив'язки залишаться, а нові завдання отримають лише вільні кнопки. Див. Швидкий старт: як змусити ручку працювати.
#Що JoyPro робить для MSFS 2024
- Імпорт: профілі, які ви створили в меню Controls симулятора (Steam або Microsoft Store), потрапляють у ваш профіль — льотні прив'язки й прив'язки General (камери, види, активна пауза тощо) разом із налаштуваннями осей зі сторінки Sensitivity. Пристрій, який ви ніколи не змінювали в симуляторі, приносить пресет, що постачається для нього із симулятором, якщо власні записи симулятора показують, що він цей пресет використовує.
- Зв'язки: один зв'язок — це одна функція. У MSFS 2024 зв'язок може бути для всіх літаків (за замовчуванням) або лише для позначених вами літаків, як у DCS.
- Експорт: JoyPro записує ваші прив'язки в профіль, який симулятор використовує для кожного пристрою й категорії, записує свій пакет пресетів для літаків, які симулятор ще не налаштував, і записує файл імпорту там, де не зміг оновити ваш профіль.
#Імпорт ваших прив'язок MSFS 2024
- Відкрийте Початок і натисніть Імпорт на картці Microsoft Flight Simulator 2024.
- Для MSFS важливі два параметри, обидва вимкнені, доки ви їх не позначите:
- Імпортувати й непідключені пристрої: MSFS зберігає прив'язки кожного пристрою, який будь-коли бачив. Вимкнено: лише пристрої, підключені зараз.
- Імпортувати й стандартні пресети, які симулятор може не використовувати: для пристроїв, для яких записи симулятора не показують використання стандартного пресета. Це може додати прив'язки, яких у симуляторі немає.
- Натисніть Імпортувати зараз (або Спершу переглянути, щоб побачити, що є в симуляторі, не змінюючи свій профіль).
Імпортовані зв'язки діють для всіх літаків. Коли прив'язка є лише в профілях деяких літаків, сторінка Зв'язки після імпорту показує примітку з кнопками Обмежити цими літаками для кожного зв'язку, Обмежити всі і Залишити для всіх літаків.


#Створення й перевірка зв'язків
На сторінці Зв'язки дія MSFS 2024 показує літаки симулятора з позначками: позначено всі літаки — означає всі літаки. Дія, яка є лише в деяких додаткових літаках, пише «лише для:» з цими літаками, і під час додавання позначаються тільки вони. Див. процес зв'язків, потім запустіть Перевірку на сторінці «Експорт»: вона знаходить кнопку з двома функціями раніше за симулятор.
#Експорт у MSFS 2024
- Закрийте MSFS 2024. JoyPro відмовляється записувати, поки симулятор працює (у версії Microsoft Store також поки працює його помічник запуску).
- Відкрийте Експорт. У розділі Експорт в ігри дві позначки стосуються MSFS 2024:
- MSFS 2024: записувати в мої профілі MSFS (увімкнено): експорт оновлює профіль, який симулятор використовує для кожного пристрою й категорії, спершу зробивши резервну копію.
- MSFS 2024: файли імпорту для кожного пристрою (вимкнено): файл імпорту для кожного пристрою й категорії, а не лише там, де JoyPro не зміг записати ваш профіль.
- Залиште Замінити на моїх пристроях разом з Очистити й інші мої пристрої, якщо ви налаштовуєте свої пристрої в JoyPro, і натисніть Експортувати зараз на картці MSFS 2024.
Після експорту блок Ваші профілі MSFS 2024 перелічує кожен профіль, який записав JoyPro, з його літаками й кількістю прив'язок. Якщо було записано файли імпорту, другий блок називає їх і має кнопку Відкрити папку.


Запустіть симулятор і відкрийте 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
Код: 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. Стара назва CLIengine 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.