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 Hat (4 кірункі) на joystick (задакументавана)
- Спіс каманд з
- файлы прэсэтаў Asobo, палётныя падзеі, якія называе
fs-base\en-US.locPak, усталяваныя лятальныя апараты - Праверка ў гульні
- 26/26 крокаў пройдзена (2026-10-11)
- ✓ Імпарт
- ✓ Экспарт
- ✗ Прывязкі клавіятуры
- ◐ МадыфікатарыMSFS: толькі кнопкі-мадыфікатары той самай прылады.
- ✓ Спіс каманд, пабудаваны на вашым ПК
- ✓ Назіральнік за гульнямі
- ✓ Крывыя восяў і мёртвыя зоны
- ✗ Налады кіравання ў гульні
- ✗ Налады зваротнай сувязі па сіле ў гульні
- ✗ Зваротная сувязь па сіле з тэлеметрыі
- ✓ Запіс тэлеметрыі
- ✓ Віртуальны 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» падчас прывязкі ў сімулятары: прылада, якая ўвесь час пасылае значэнні (некаторыя ручкі са зваротнай сувяззю па сіле), перахоплівае сканаванне сімулятара. Гэта адбываецца пры прывязцы ў самім сімулятары, а не ў 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>, адзін блоб на профіль); JoyPro запісвае новы блоб, новы файл кантэйнера і індэкс |
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
Рэжымы працуюць для кожнага профілю (значыць, для кожнай групы лятальных апаратаў) і толькі ў кантэкстах, якімі кіруе JoyPro.
| Рэжым | Што адбываецца ў вашых профілях 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.
- Зваротная сувязь па сіле: уласнай у 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, Hat 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 (hex): JoyPro бярэ той, які сімулятар адзначыў уprofile_00, інакш USB PID (vJoy паказваецца з ідэнтыфікатарам прадукту 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 трапляе толькі ў тыя лятальныя апараты, якія сімулятар яшчэ не наладзіў для прылады; у астатніх прывязкі нясе ваш уласны профіль або файл імпарту.
- Не больш за дзве камбінацыі ўваходаў на дзеянне; пра трэцюю паведамляецца. Паўвосі, дыяганалі Hat і другі Hat не чытаюцца і не запісваюцца. Мадыфікатары: толькі кнопкі той жа прылады.
- Спакаваныя пакеты дапаўненняў (
.fsarchive) прапускаюцца; шляхі захавання Store даўжэйшыя за 260 сімвалаў не чытаюцца. - Воблачная копія (Steam Cloud, Xbox cloud) можа перамагчы запіс 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.