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 Hat (4 кірункі) на joystick (задакументавана)
Спіс каманд з
файлы прэсэтаў Asobo, палётныя падзеі, якія называе fs-base\en-US.locPak, усталяваныя лятальныя апараты
Праверка ў гульні
26/26 крокаў пройдзена (2026-10-11)
  • ✓ Імпарт
  • ✓ Экспарт
  • ✗ Прывязкі клавіятуры
  • ◐ МадыфікатарыMSFS: толькі кнопкі-мадыфікатары той самай прылады.
  • ✓ Спіс каманд, пабудаваны на вашым ПК
  • ✓ Назіральнік за гульнямі
  • ✓ Крывыя восяў і мёртвыя зоны
  • ✗ Налады кіравання ў гульні
  • ✗ Налады зваротнай сувязі па сіле ў гульні
  • ✗ Зваротная сувязь па сіле з тэлеметрыі
  • ✓ Запіс тэлеметрыі
  • ✓ Віртуальны 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» падчас прывязкі ў сімулятары: прылада, якая ўвесь час пасылае значэнні (некаторыя ручкі са зваротнай сувяззю па сіле), перахоплівае сканаванне сімулятара. Гэта адбываецца пры прывязцы ў самім сімулятары, а не ў 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
Вашы ўласныя профілі (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, 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. Старая назва CLI engine 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.