JoyPro2 Discord GitHub
Hry

Microsoft Flight Simulator 2024

Zobrazit:

MSFS 2024 drží vaše ovládání v profilech, jeden na zařízení a kategorii (Airplanes a General), a pro každé zařízení a letoun si pamatuje, který profil používá. JoyPro tyto profily načte do jednoho vlastního profilu a zapíše vaše přiřazení zpět přesně do těch profilů, které simulátor používá, ve Steam verzi i ve verzi z Microsoft Store. Pro letouny, které simulátor pro dané zařízení ještě nenastavil, přidá JoyPro vlastní předvolby jako malý balíček ve složce simulátoru Community2024, a kde profil zapsat nemůže, nechá vám soubor k importu v menu Controls simulátoru.

Microsoft Flight Simulator 2024 nativně (vlastní soubory přiřazení)
Podpora
nativně (vlastní soubory přiřazení)
Příkaz enginu
engine msfs2024
Soubor přiřazení
váš vlastní profil, který simulátor používá pro každé zařízení a kategorii (XML Steam remote\inputprofile_* nebo uložená data z Microsoft Store, --user-profiles) + balíček Community od JoyPro (joypro-input-profiles, jeden XML presetu na zařízení); soubory pro import v Documents\JoyPro2\MSFS 2024 import files tam, kde váš profil nelze zapsat
Vstupy, které hra čte
čte 8 os, 1 hat (4 směry) na joystick (zdokumentováno)
Seznam příkazů z
soubory presetů od Asobo, letové události uvedené v fs-base\en-US.locPak, nainstalované letouny
Herní test
26/26 kroků splněno (2026-10-11)
  • ✓ Importovat
  • ✓ Export
  • ✗ Přiřazení klávesnice
  • ◐ ModifikátoryMSFS: jen tlačítka modifikátorů ze stejného zařízení.
  • ✓ Seznam příkazů sestavený na vašem PC
  • ✓ Sledování her
  • ✓ Křivky os a mrtvé zóny
  • ✗ Nastavení ovládání hry
  • ✗ Herní nastavení zpětné vazby síly
  • ✗ Zpětná vazba síly z telemetrie
  • ✓ Záznam telemetrie
  • ✓ Virtuální joystick (vJoy)
  • ◐ Virtuální gamepad Xbox
  • ✓ Virtuální funkce
  • ✓ Průvodce nastavením / Automatické přiřazení
  • ✓ Kokpity
  • ✓ Taháky
  • ✓ Herní test

Z matice podpory, vygenerované z kódu enginu: všechny hry.

Pro začátečníky

#Zprovozněte to ve 3 krocích

  1. Nastavit vše za mě
    na stránce Start
  2. Použít tato tlačítka
    nejdřív se podívejte na seznam
  3. Zapsat do mé hry
    simulátor nechte zavřený

Před: jednou připojte každé zařízení.

Pak: přečtěte si rámeček Vaše profily MSFS 2024. Uvádí soubor pro import? Pak ten soubor importujte v simulátoru (viz Co uděláte sami níže).

Přiřazovali jste už dřív tlačítka v MSFS 2024? Pak stránka Start nabídne Importovat, pak doplnit mezery. Vaše přiřazení zůstanou a nové úkoly dostanou jen volná tlačítka. Viz Rychlý start: zprovozněte můj ovladač.

#Co JoyPro dělá pro MSFS 2024

  • Importovat: profily, které jste vytvořili v menu Controls simulátoru (Steam nebo Microsoft Store), přijdou do vašeho profilu, letová přiřazení i přiřazení General (kamery, pohledy, aktivní pauza a tak dále), s nastavením os ze stránky Sensitivity. Zařízení, které jste v simulátoru nikdy neměnili, přinese předvolbu, kterou pro něj simulátor dodává, když vlastní záznamy simulátoru ukazují, že tu předvolbu používá.
  • Relace: jedna relace je jedna funkce. V MSFS 2024 může relace platit pro všechny letouny (výchozí) nebo jen pro letouny, které zaškrtnete, jako v DCS.
  • Export: JoyPro zapíše vaše přiřazení do profilu, který simulátor používá pro každé zařízení a kategorii, zapíše svůj balíček předvoleb pro letouny, které simulátor ještě nenastavil, a zapíše soubor pro import tam, kde váš profil aktualizovat nemohl.

#Import přiřazení z MSFS 2024

  1. Otevřete Start a na kartě Microsoft Flight Simulator 2024 stiskněte Importovat.
  2. Pro MSFS jsou důležité dvě možnosti, obě vypnuté, pokud je nezaškrtnete:
    • Importovat i zařízení, která nejsou připojena: MSFS uchovává přiřazení každého zařízení, které kdy viděl. Vypnuto: jen zařízení připojená teď.
    • Importovat i výchozí předvolby, které simulátor možná nepoužívá: pro zařízení, u kterých záznamy simulátoru neukazují, že používají dodanou předvolbu. Může to přidat přiřazení, která simulátor nemá.
  3. Stiskněte Importovat nyní (nebo Nejprve se podívat, abyste viděli, co simulátor má, aniž by se změnil váš profil).

Importované relace platí pro všechny letouny. Když přiřazení existuje jen v profilech některých letounů, stránka Relace po importu ukáže poznámku s volbami Omezit na tyto letouny u každé relace, Omezit vše a Ponechat pro všechny letouny.

Stránka Start s vašimi hramiStránka Start s vašimi hrami
Stránka Start s vašimi hrami (Obrázky ukazují aplikaci v angličtině.)

#Vytvořte a zkontrolujte relace

Na stránce Relace ukazuje akce MSFS 2024 letouny simulátoru se zaškrtnutím: zaškrtnuté všechny letouny znamenají všechny letouny. Akce, která existuje jen v některých přídavných letounech, píše „jen pro:“ s těmi letouny a její přidání zaškrtne jen je. Viz postup relací a pak na stránce Export spusťte Kontrolu: najde tlačítko se dvěma funkcemi dřív než simulátor.

#Export do MSFS 2024

  1. Zavřete MSFS 2024. JoyPro odmítne zapisovat, dokud simulátor běží (ve verzi z Microsoft Store také dokud běží jeho pomocník spouštění).
  2. Otevřete Export. V části Exportovat do her jsou dvě zaškrtávací políčka pro MSFS 2024:
    • MSFS 2024: zapisovat do mých profilů MSFS (zapnuto): export aktualizuje profil, který simulátor používá pro každé zařízení a kategorii, předtím ho zálohuje.
    • MSFS 2024: soubory pro import pro každé zařízení (vypnuto): soubor pro import pro každé zařízení a kategorii, nejen tam, kde JoyPro nemohl váš profil zapsat.
  3. Ponechte Nahradit na mých zařízeních s Vymazat i má ostatní zařízení, pokud svá zařízení nastavujete v JoyPro, a stiskněte Exportovat nyní na kartě MSFS 2024.

Po exportu uvádí rámeček Vaše profily MSFS 2024 každý profil, který JoyPro zapsal, s jeho letouny a počtem přiřazení. Když se zapsaly soubory pro import, druhý rámeček je uvede s tlačítkem Otevřít složku.

Stránka ExportStránka Export
Stránka Export
Ve hře: Co uvidíte v MSFS 2024

Spusťte simulátor, otevřete Settings > Controls a pak vyberte své zařízení a kategorii (Airplanes nebo General). Vaše přiřazení jsou ve vašem vlastním profilu pod názvy akcí simulátoru; stránka zařízení (Hardware Settings na ozubeném kole zařízení) ukazuje křivky os, které JoyPro zapsal. V letounu, který simulátor pro to zařízení ještě nenastavil, začne zařízení s předvolbou JoyPro.

#Co uděláte sami v MSFS 2024

  • Nic, u každého profilu, který je v Vaše profily MSFS 2024 uvedený jako aktualizovaný.
  • Soubory pro import: když export nějaký uvede, otevřete Settings > Controls, vyberte zařízení a kategorii (Airplanes nebo General), klikněte na ozubené kolo profilu (ne předvolby), zvolte Import a vyberte soubor, který JoyPro pro to zařízení a kategorii zapsal. Simulátor soubor přijme jen pro stejné zařízení a kategorii. Když soubor nese název vašeho profilu, simulátor se zeptá, zda ho přepsat: potvrďte a váš profil má přiřazení JoyPro. Soubor importujte znovu, jen když export řekne, že je nový nebo změněný.
  • Před prvním exportem jednou připojte každé zařízení: JoyPro pro svou předvolbu potřebuje ID produktu zařízení.
  • Jeden letoun potřebuje jiná přiřazení než ostatní: dejte mu v simulátoru vlastní profil (Controls, s načteným tím letounem: zduplikujte profil) a pak exportujte znovu. Export uvede každou relaci, kterou nemohl umístit.
  • Dotaz Xbox cloudu: pokud se simulátor nebo aplikace Xbox zeptá, které uložení ponechat, ponechte to z tohoto PC; to druhé přiřazení JoyPro zahodí (pak exportujte znovu).

#Časté chyby

  • „MSFS 2024 běží“: zavřete simulátor; ve verzi z Microsoft Store musí zmizet i pomocník spouštění simulátoru (gamelaunchhelper.exe).
  • V jednom letounu chybí přiřazení: ten letoun používá jiný z vašich profilů. Zkontrolujte seznam Vaše profily MSFS 2024; řádek s „import file“ znamená, že ten soubor importujete v simulátoru.
  • Relace se nezapsala: je omezená na některé letouny, ale profil, který tam simulátor používá, je sdílený s jinými letouny. Varování uvede profil i letouny.
  • Zařízení má několik profilů: import vezme ten, který uvádějí záznamy simulátoru, jinak nejnovější, a ostatní vyjmenuje. Jiný vyberete pomocí Profil hry ve formuláři Další hry na stránce Start.
  • „WRONG DEVICE“ při přiřazování v simulátoru: zařízení, které stále posílá hodnoty (některé ovladače se zpětnou vazbou síly), převezme skenování simulátoru. Děje se to při vlastním přiřazování v simulátoru, ne v JoyPro.
  • Reset to Defaults v simulátoru obnoví předvolby každého zařízení a letounu; JoyPro to za vás nikdy neudělá.
Pokročilé

#Soubory, které JoyPro čte a zapisuje

Soubor Co to je
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> váš vlastní profil (Steam), obyčejné XML bez přípony; zapisuje se na místě, Steam Cloud ho nahraje při příští synchronizaci
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ uložení z Microsoft Store (containers.index, container.<n>, jeden blob na profil); JoyPro zapíše nový blob, nový soubor kontejneru a index
remote\profile_00 (Store: kontejner profile_00) záznamy zařízení v simulátoru: který profil nebo předvolbu každé zařízení používá pro jednotlivé letouny. Jen pro čtení, nikdy se nezapisuje
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml předvolba JoyPro pro zařízení (letové akce), s layout.json a manifest.json
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml předvolba JoyPro pro obecná přiřazení (General) zařízení
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml soubory pro import, ve vlastním formátu profilů simulátoru
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak předvolby dodávané Asobem a názvy menu: jen pro čtení, pro seznam příkazů a výchozí předvolby
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS data o vlastnictví a zálohy JoyPro, nikdy v synchronizované složce

<packages> je InstalledPackagesPath z %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Před každým zápisem jde celá složka uložení ze Store nebo soubor Steamu do sady záloh, takže Vrátit poslední export uložení vrátí zpět.

#Režimy exportu v MSFS 2024

Režimy pracují pro každý profil zvlášť (tedy pro každou skupinu letounů) a jen ve spravovaných kontextech.

Režim Co se stane ve vašich profilech MSFS 2024
Pouze přidat Přiřazení se zapíše jen tam, kde kombinaci vstupů nepoužívá žádná jiná akce toho profilu; jinak se uvede jako nezapsané. Nic se neodstraní.
Aktualizovat, ponechat přiřazení hry Jiná akce na vaší kombinaci vstupů o ni přijde; vše ostatní zůstane, i stará kombinace akce (akce má dvě: Primary a Secondary).
Aktualizovat, vyhraje můj profil Jako výše a navíc každá akce, kterou přiřazujete, přijde o své další kombinace, i v profilech ostatních připojených zařízení (tyto profily se také zapíšou).
Nahradit na mých zařízeních Profily připojených zařízení, která JoyPro zapisuje, si ponechají jen vaše přiřazení.
+ Vymazat i má ostatní zařízení Nikdy nevymaže žádný z vašich vlastních profilů MSFS 2024.

Relace pro všechny letouny jde do každého profilu, který uvádějí záznamy simulátoru; relace omezená na letouny jde jen do profilů, jejichž letouny jsou všechny zaškrtnuté. Omezené relace nikdy nejdou do balíčku předvoleb ani do souborů pro import, protože ty platí pro všechny letouny.

#Čeho se nikdy nedotkne

  • Kontexty menu, mapy světa a vývojáře (MENU, MENU_*, WORLDMAP_*, DEBUG, DEVMODE*, EDITOR_*, MISSION_FLOW_TOOLS), v každém režimu.
  • Profily klávesnice, myši a gamepadu (GUID="{0}"): přiřazení klávesnice se v MSFS nezapisují.
  • profile_00, předvolby dodávané Asobem, sloty předvoleb pro konkrétní letouny a každý další kontejner uložení ze Store (deníky, jiné tituly).
  • Zařízení, která nejsou připojená, zařízení ignorovaná při importu a zařízení vJoy, do kterého JoyPro posílá.

#Letouny, křivky, ostatní

  • Granularita: pro každé zařízení a kategorii (Airplanes, General) a pro každý profil; simulátor volí profil pro každé zařízení a letoun, JoyPro se touto volbou řídí.
  • Křivky os: stránka Sensitivity zařízení, jedna sada na fyzickou osu: Sensitivity + a -, Neutral, Dead zone, Extremity dead zone, Reactivity, příznak bez křivky a invertování. Relace může dát jedné akci vlastní hodnoty (přepsání pro jednotlivé akce v MSFS 2024). Relace na stejné ose zařízení sdílejí její stránku: export zapíše hodnoty první relace a upozorní. Viz axis-curves.
  • Force feedback (zpětná vazba síly): MSFS žádnou vlastní nemá.
  • Záznam telemetrie: přes SimConnect, jen pro čtení, s vlastní SimConnect.dll (JoyPro žádnou nedodává): verze MSFS 2024 ze Steamu žádnou nemá, proto nainstalujte MSFS 2024 SDK nebo mějte nainstalovaný MSFS 2020 (jeho kopie funguje také).
  • HUD: HUD najde simulátor podle jeho procesu a ukáže jeho přiřazení.
  • Sledování: JoyPro sleduje svůj balíček, profily Steamu a containers.index uložení ze Store; po zavření simulátoru (uložení ze Store čeká 10 s po svém posledním zápisu) se zeptá, zda převzít vaše změny ze hry (sledování her).
  • Opětovný import: názvy relací, skupiny a ladění se vrátí přes metadata JoyPro vedle souborů (opětovný import).
  • Volby pro experty (Další hry na stránce Start): Profil hry (vyberte jeden profil, když má zařízení několik), Exportovat letoun (exportovat i relace omezené na jeden letoun, a to pro všechny letouny), Zapisovat do mých profilů MSFS, Zapisovat i soubory pro import MSFS pro každé zařízení, zkušební běh.
Technické podrobnosti

#Uvnitř integrace MSFS 2024

flowchart LR
  P["Váš profil"] --> E["engine msfs2024 export"]
  E --> U["Vaše vlastní<br/>profily"]
  E --> K["Předvolby<br/>JoyPro"]
  E --> F["Soubory pro import"]
  F --> I["Vy: ozubené kolo,<br/>Import"]
  U --> S["Settings ><br/>Controls"]
  K --> S
  I --> S
Vaše vlastní profily (Steam inputprofile_n nebo uložená data verze ze Store) se zapisují přímo. Předvolby JoyPro (Community2024 / joypro-input-profiles, jedna předvolba na zařízení) slouží letounům, které simulátor ještě nenastavil. Soubory pro import (Documents / JoyPro2) si v simulátoru načtete sami.

Kód: engine\Games\MsfsIntegration.cs (jedna třída pro oba simulátory), MsfsIntegration.UserProfiles.cs (přímý zápis), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (čtení ze Steamu a Store), WgsContainers.cs (uložení ze Store), MsfsSimProfile.cs (záznamy v profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (editor po řádcích), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.

  • Formát: fragment XML (několik prvků na nejvyšší úrovni): <Version>, <FriendlyName>, <Device DeviceName GUID ProductID CompositeID HWVer> s <Axes> a <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>. Profil 2024 uvádí každou akci svých kontextů, nepřiřazené jako prázdné <Action/>. Kódy: tlačítko N = N-1, hat 256-259, osy L X/Y/Z 1026/1042/1058, osy R 770/786/802, posuvníky 514/530. Příznaky: 2 digitální, 4 osa, 128 invertování, 1024 bez křivky citlivosti, 4096 přepsání osy pro jednotlivé akce. Znovu se vykreslí jen změněné prvky <Action>.
  • Zařízení: profil označuje své zařízení podle instančního GUID DirectInput (GUID), takže ke čtení není potřeba žádné připojené zařízení. Simulátor přiřazuje předvolbu podle ID produktu USB (hex): JoyPro použije to, které si simulátor poznamenal v profile_00, jinak USB PID (vJoy se ukazuje jako ID produktu 0).
  • Který profil je aktivní: pro každé zařízení a letoun obsahují záznamy v profile_00 slot General a slot kategorie; vlastní profil je tam inputprofile_<n>, což je název souboru ve verzi Steam a název kontejneru ve verzi Store.
  • Uložení ve verzi Store: zapisuje se jen tehdy, když má index známou strukturu (verze 14, žádný příznak konfliktu, kontejner uvedený jednou ve známém stavu); pak nový blob, container.<n+1>, index jako poslední (dočasný soubor a nahrazení), zpětné načtení a odstranění staré generace. Jakákoli chyba vše vrátí zpět; při čemkoli neznámém se nic nezapíše a přiřazení nese importní soubor.
  • Seznam příkazů: engine msfs2024 refresh-db načte předvolby od Asobo, každou letovou událost, kterou pojmenovává en-US.locPak, vaše profily General a rozbalené balíčky doplňků (Community, Marketplace) s jejich letouny; seznam letounů pochází ze seznamu obsahu simulátoru. Nová instalace sestaví seznam při prvním importu.
  • Příkazy: 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 a --import-files jako dvě zaškrtávací políčka stránky Export); relace pro jednotlivé letouny pomocí engine relations aircraft set; Zpět pomocí engine backups restore; sledování pomocí engine sync status a engine sync diff. Starý název CLI engine msfs ... stále znamená MSFS 2024.

#Známá omezení

  • Sloty předvoleb pro konkrétní letouny se nezapisují (přicházejí jen s vlastním balíčkem letounu); JoyPro nikdy nezapisuje profile_00 (soubor končí kontrolním součtem).
  • Předvolba JoyPro se dostane jen k letounům, které simulátor pro dané zařízení ještě nenastavil; jinde přiřazení nese váš vlastní profil nebo importní soubor.
  • Nejvýše dvě kombinace vstupů na akci; třetí se nahlásí. Poloviční osy, diagonály hatu a druhý hat se nečtou ani nezapisují. Modifikátory: jen tlačítka téhož zařízení.
  • Zabalené balíčky doplňků (.fsarchive) se přeskakují; cesty k uloženým datům verze Store delší než 260 znaků se nečtou.
  • Cloudová kopie (Steam Cloud, cloud Xbox) může přebít zápis JoyPro, když jiné PC uložilo později.
  • Testy: engine\tests\smoke\msfs.ps1, smoke\msfsuserprofiles.ps1, gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs (uložená data Steam a Store, profily jednotlivých letounů, vrácení zpět), MsfsStoreWatcherEndToEndTests; v simulátoru tools\e2e\games\Msfs2024Settings.ps1 (předvolby, osy, tlačítka a křivka pro jednotlivé akce v Controls).

Všechny technické poznámky k této hře (vygenerované z repozitáře): msfs.md.