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 посоки) на джойстик (документирано)
Списък с команди от
файловете с пресети на Asobo, полетните събития, посочени в fs-base\en-US.locPak, инсталираните самолети
Тест в играта
26/26 успешни стъпки (2026-10-11)
  • ✓ Импортиране
  • ✓ Експортиране
  • ✗ Назначения на клавиатурата
  • ◐ МодификаториMSFS: само бутони-модификатори от същото устройство.
  • ✓ Списък с команди, изграден на вашия PC
  • ✓ Следене на игри
  • ✓ Криви на осите и мъртви зони
  • ✗ Настройки за управление в играта
  • ✗ Настройки за обратна сила в играта
  • ✗ Обратна сила от телеметрия
  • ✓ Запис на телеметрия
  • ✓ Виртуален joystick (vJoy)
  • ◐ Виртуален Xbox геймпад
  • ✓ Виртуални функции
  • ✓ Съветник за настройка / Авто назначаване
  • ✓ Кабини
  • ✓ Бележници
  • ✓ Тест в играта

От матрицата за поддръжка, генерирана от кода на ядрото: всички игри.

За начинаещи

#Подкарайте го в 3 стъпки

  1. Настрой всичко вместо мен
    на страницата Начало
  2. Използвай тези бутони
    първо разгледайте списъка
  3. Запиши в моята игра
    симулаторът трябва да е затворен

Преди: свържете всяко устройство веднъж.

После: прочетете полето Вашите профили в MSFS 2024. Назовава ли файл за импортиране? Тогава импортирайте този файл в симулатора (вижте Какво правите сами по-долу).

Назначавали ли сте бутони в MSFS 2024 преди? Тогава страницата Начало предлага Импортиране, после запълване на празнините. Вашите назначения остават и само свободните бутони получават нови задачи. Вижте Бърз старт: да заработи ръчката ми.

#Какво прави JoyPro за MSFS 2024

  • Импортиране: профилите, които сте създали в менюто Controls на симулатора (Steam или Microsoft Store), влизат във вашия профил — назначения за полет и общи назначения (камери, изгледи, активна пауза и т.н.), заедно с настройките на осите от страницата 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 попита кой запис да запази, запазете този от този PC; другият премахва назначенията на 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>, по един 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 за общите назначения на едно устройство
%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.
  • Обратна сила: MSFS няма собствена.
  • Запис на телеметрия: чрез SimConnect, само за четене, с ваш собствен SimConnect.dll (JoyPro не идва с такъв): версията на MSFS 2024 от Steam няма такъв, затова инсталирайте MSFS 2024 SDK или имайте инсталиран MSFS 2020 (неговото копие също работи).
  • HUD: HUD намира симулатора по процеса му и показва назначенията му.
  • Наблюдател: JoyPro следи своя пакет, профилите в Steam и containers.index на записа от Store; след затваряне на симулатора (записът от Store изчаква 10 s след последното си записване) пита дали да приеме промените ви от играта (наблюдателят).
  • Повторно импортиране: имената на връзките, групите и настройките на осите се връщат чрез метаданните на 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 идентификатора на продукта (шестнадесетичен): 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 достига само самолети, които симулаторът още не е настроил за дадено устройство; на други места назначенията се носят от вашия собствен профил или от файл за импортиране.
  • Най-много две комбинации от входове на действие; трета се докладва. Половини от оси, диагонали на хата и втори хат не се четат и не се записват. Модификатори: само бутони от същото устройство.
  • Пакетираните пакети с добавки (.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.