JoyPro2 Discord GitHub
Igre

Microsoft Flight Simulator 2024

Prikaži:

MSFS 2024 hrani vaše kontrole v profilih, enega na napravo in kategorijo (Airplanes in General), in si za vsako napravo in letalo zapomni, kateri profil uporablja. JoyPro te profile prebere v en lasten profil in vaše vezave zapiše nazaj natanko v profile, ki jih simulator uporablja, v različici Steam in Microsoft Store. Za letala, ki jih simulator za napravo še ni nastavil, JoyPro doda svoje prednastavitve kot majhen paket v mapi simulatorja Community2024, kjer pa profila ne more zapisati, vam pusti datoteko za uvoz v meniju Controls simulatorja.

Microsoft Flight Simulator 2024 neposredno (lastne datoteke vezav)
Podpora
neposredno (lastne datoteke vezav)
Ukaz pogona
engine msfs2024
Datoteka vezav
vaš lastni profil, ki ga simulator uporablja za vsako napravo in kategorijo (XML Steam remote\inputprofile_* ali shranjeni podatki iz Microsoft Store, --user-profiles) + JoyProjev paket Community (joypro-input-profiles, en XML prednastavitve na napravo); datoteke za uvoz v Documents\JoyPro2\MSFS 2024 import files, kjer vašega profila ni mogoče zapisati
Vhodi, ki jih igra bere
bere 8 osi, 1 Hat (4 smeri) na joystick (dokumentirano)
Seznam ukazov iz
Asobove datoteke prednastavitev, dogodki letenja, ki jih navaja fs-base\en-US.locPak, nameščena letala
Preizkus v igri
26/26 korakov opravljenih (2026-10-11)
  • ✓ Uvozi
  • ✓ Izvozi
  • ✗ Vezave tipkovnice
  • ◐ ModifikatorjiMSFS: samo gumbi modifikatorjev iste naprave.
  • ✓ Seznam ukazov, zgrajen na vašem PC-ju
  • ✓ Spremljevalec iger
  • ✓ Krivulje osi in mrtve cone
  • ✗ Nastavitve kontrol igre
  • ✗ Nastavitve povratne sile v igri
  • ✗ Povratna sila iz telemetrije
  • ✓ Snemanje telemetrije
  • ✓ Virtualni joystick (vJoy)
  • ◐ Virtualni Xbox pad
  • ✓ Virtualne funkcije
  • ✓ Čarovnik za nastavitev / Samodejna dodelitev
  • ✓ Kokpiti
  • ✓ Pregledni listi
  • ✓ Preizkus v igri

Iz matrike podpore, ustvarjene iz kode pogona: vse igre.

Za začetnike

#Do delovanja v 3 korakih

  1. Nastavi vse namesto mene
    na strani Začetek
  2. Uporabi te gumbe
    najprej poglejte seznam
  3. Zapiši v mojo igro
    simulator naj ostane zaprt

Prej: vsako napravo enkrat priključite.

Nato: preberite polje Vaši profili MSFS 2024. Ali navaja uvozno datoteko? Potem to datoteko uvozite v simulatorju (glejte Kaj naredite sami spodaj).

Ste v MSFS 2024 že prej vezali gumbe? Potem vam stran Začetek ponudi Uvozi, nato zapolni vrzeli. Vaše vezave ostanejo, nove naloge dobijo samo prosti gumbi. Glejte Hiter začetek: naj moja palica deluje.

#Kaj JoyPro naredi za MSFS 2024

  • Uvozi: profili, ki ste jih naredili v meniju Controls simulatorja (Steam ali Microsoft Store), pridejo v vaš profil, letalske vezave in vezave General (kamere, pogledi, aktivni premor in podobno), z nastavitvami osi s strani Sensitivity. Naprava, ki je v simulatorju niste nikoli spremenili, prinese prednastavitev, ki jo simulator priloži zanjo, če lastni zapisi simulatorja kažejo, da to prednastavitev uporablja.
  • Relacije: ena relacija je ena funkcija. V MSFS 2024 je relacija lahko za vsa letala (privzeto) ali samo za letala, ki jih odkljukate, kot v DCS.
  • Izvozi: JoyPro zapiše vaše vezave v profil, ki ga simulator uporablja za vsako napravo in kategorijo, zapiše svoj paket prednastavitev za letala, ki jih simulator še ni nastavil, in zapiše uvozno datoteko tam, kjer vašega profila ni mogel posodobiti.

#Uvozite svoje vezave iz MSFS 2024

  1. Odprite Začni in na kartici Microsoft Flight Simulator 2024 pritisnite Uvozi.
  2. Za MSFS sta pomembni dve možnosti, obe izklopljeni, razen če ju odkljukate:
    • Uvozi tudi naprave, ki niso priključene: MSFS hrani vezave vseh naprav, ki jih je kdaj videl. Izklopljeno: samo trenutno priključene naprave.
    • Uvozi tudi privzete prednastavitve, ki jih simulator morda ne uporablja: za naprave, pri katerih zapisi simulatorja ne kažejo uporabe priložene prednastavitve. To lahko doda vezave, ki jih simulator nima.
  3. Pritisnite Uvozi zdaj (ali Najprej poglej, da vidite, kaj ima simulator, ne da bi spremenili svoj profil).

Uvožene relacije veljajo za vsa letala. Ko vezava obstaja samo v profilih nekaterih letal, stran Relacije po uvozu pokaže opombo z Omeji na ta letala za vsako relacijo, Omeji vse in Ohrani za vsa letala.

Stran Začetek z vašimi igramiStran Začetek z vašimi igrami
Stran Začetek z vašimi igrami (Slike prikazujejo aplikacijo v angleščini.)

#Zgradite in preverite relacije

Na strani Relacije dejanje MSFS 2024 prikaže letala simulatorja s kljukicami: odkljukana vsa letala pomenijo vsa letala. Dejanje, ki obstaja samo v nekaterih dodatnih letalih, napiše "samo za:" s temi letali, in ko ga dodate, se odkljukajo samo ta. Glejte potek relacij, nato na strani Izvoz zaženite preverjanje: najde gumb z dvema funkcijama, preden ga najde simulator.

#Izvoz v MSFS 2024

  1. Zaprite MSFS 2024. JoyPro noče pisati, medtem ko simulator teče (v različici Microsoft Store tudi, medtem ko teče njegov pomočnik za zagon).
  2. Odprite Izvozi. Pod Izvozi v igre sta dve kljukici za MSFS 2024:
    • MSFS 2024: zapiši v moje profile MSFS (vklopljeno): izvoz posodobi profil, ki ga simulator uporablja za vsako napravo in kategorijo, pred tem pa naredi varnostno kopijo.
    • MSFS 2024: uvozne datoteke za vsako napravo (izklopljeno): uvozna datoteka za vsako napravo in kategorijo, ne samo tam, kjer JoyPro vašega profila ni mogel zapisati.
  3. Pustite Zamenjaj na mojih napravah z Počisti tudi moje druge naprave, če naprave nastavljate v JoyPro, in na kartici MSFS 2024 pritisnite Izvozi zdaj.

Po izvozu polje Vaši profili MSFS 2024 navede vsak profil, ki ga je zapisal JoyPro, z njegovimi letali in številom vezav. Če so bile zapisane uvozne datoteke, jih drugo polje navede z Odpri mapo.

Stran IzvozStran Izvoz
Stran Izvoz
V igri: Kaj vidite v MSFS 2024

Zaženite simulator in odprite Settings > Controls, nato izberite svojo napravo in kategorijo (Airplanes ali General). Vaše vezave so v vašem lastnem profilu, pod imeni dejanj simulatorja; stran naprave (Hardware Settings na zobniku naprave) pokaže krivulje osi, ki jih je zapisal JoyPro. V letalu, ki ga simulator za to napravo še ni nastavil, naprava začne s prednastavitvijo JoyPro.

#Kaj naredite sami v MSFS 2024

  • Nič, za vsak profil, ki je v Vaši profili MSFS 2024 naveden kot posodobljen.
  • Uvozne datoteke: ko izvoz katero navede, odprite Settings > Controls, izberite napravo in kategorijo (Airplanes ali General), kliknite zobnik profila (ne tistega pri prednastavitvi), izberite Uvozi in izberite datoteko, ki jo je JoyPro zapisal za to napravo in kategorijo. Simulator sprejme datoteko samo za isto napravo in kategorijo. Ko datoteka nosi ime vašega profila, simulator vpraša, ali naj ga prepiše: potrdite in vaš profil ima vezave JoyPro. Datoteko znova uvozite samo, ko izvoz pove, da je nova ali spremenjena.
  • Pred prvim izvozom vsako napravo enkrat priključite: JoyPro za svojo prednastavitev potrebuje ID izdelka naprave.
  • Eno letalo potrebuje drugačne vezave kot druga: v simulatorju mu dajte lasten profil (Controls, z naloženim tem letalom: podvojite profil), nato znova izvozite. Izvoz navede vsako relacijo, ki je ni mogel postaviti.
  • Vprašanje o oblaku Xbox: če simulator ali aplikacija Xbox vpraša, katero shranjeno stanje naj obdrži, obdržite tisto s tega PC-ja; drugo izgubi vezave JoyPro (potem znova izvozite).

#Pogoste pasti

  • "MSFS 2024 teče": zaprite simulator; v različici Microsoft Store mora izginiti tudi pomočnik za zagon simulatorja (gamelaunchhelper.exe).
  • Vezave manjkajo v enem letalu: to letalo uporablja drug vaš profil. Preverite seznam Vaši profili MSFS 2024; vrstica z "uvozna datoteka" pomeni, da to datoteko uvozite v simulatorju.
  • Relacija ni bila zapisana: omejena je na nekatera letala, vendar si profil, ki ga simulator tam uporablja, deli z drugimi letali. Opozorilo navede profil in letala.
  • Naprava ima več profilov: uvoz vzame tistega, ki ga navajajo zapisi simulatorja, sicer najnovejšega, in navede druge. Drugega izberite s Profil igre v obrazcu Druge igre na strani Začetek.
  • "WRONG DEVICE" med vezanjem v simulatorju: naprava, ki ves čas pošilja vrednosti (nekatere palice s povratno silo), prevzame iskanje simulatorja. To se zgodi pri lastnem vezanju simulatorja, ne v JoyPro.
  • Reset to Defaults v simulatorju ponastavi prednastavitve vseh naprav in letal; JoyPro tega nikoli ne naredi namesto vas.
Napredno

#Datoteke, ki jih JoyPro bere in piše

Datoteka Kaj je to
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> vaš lastni profil (Steam), navaden XML brez končnice; zapisan na mestu, Steam Cloud ga naloži ob naslednji sinhronizaciji
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ shranjeni podatki iz Microsoft Store (containers.index, container.<n>, en blob na profil); JoyPro zapiše nov blob, novo datoteko vsebnika in indeks
remote\profile_00 (Store: vsebnik profile_00) zapisi naprav v simulatorju: kateri profil ali prednastavitev uporablja posamezna naprava za vsako letalo. Samo branje, nikoli zapisani
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml prednastavitev JoyPro za napravo (dejanja letenja), z layout.json in manifest.json
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml prednastavitev JoyPro za vezave General naprave
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml uvozne datoteke, v lastnem formatu profilov simulatorja
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak prednastavitve, ki jih priloži Asobo, in imena menijev: samo branje, za seznam ukazov in privzete prednastavitve
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS podatki JoyPro o lastništvu in varnostne kopije, nikoli v sinhronizirani mapi

<packages> je InstalledPackagesPath iz %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Pred vsakim zapisom gre celotna mapa shranjevanja Store ali datoteka Steam v nabor varnostnih kopij, zato Razveljavi zadnji izvoz vrne shranjene podatke.

#Načini izvoza v MSFS 2024

Načini delujejo za vsak profil (torej za vsako skupino letal) in samo v upravljanih kontekstih.

Način Kaj se zgodi v vaših profilih MSFS 2024
Samo dodaj Vezava se zapiše samo tam, kjer kombinacije vhodov ne uporablja nobeno drugo dejanje tega profila; sicer je navedena kot nezapisana. Nič se ne odstrani.
Posodobi, ohrani vezave igre Drugo dejanje na vaši kombinaciji vhodov jo izgubi; vse drugo ostane, tudi stara kombinacija dejanja (dejanje ima dve: Primary in Secondary).
Posodobi, moj profil prevlada Kot zgoraj, poleg tega vsako dejanje, ki ga vežete, izgubi svoje druge kombinacije, tudi v profilih drugih povezanih naprav (tudi ti profili se zapišejo).
Zamenjaj na mojih napravah Profili povezanih naprav, ki jih JoyPro zapiše, obdržijo samo vaše vezave.
+ Počisti tudi moje druge naprave Nikoli ne izprazni nobenega od vaših lastnih profilov MSFS 2024.

Relacija za vsa letala gre v vsak profil, ki ga navajajo zapisi simulatorja; relacija, omejena na letala, gre samo v profile, katerih letala so vsa odkljukana. Omejene relacije nikoli ne gredo v paket prednastavitev ali v uvozne datoteke, ker ti veljajo za vsa letala.

#Česa se nikoli ne dotakne

  • Konteksti menija, zemljevida sveta in razvijalcev (MENU, MENU_*, WORLDMAP_*, DEBUG, DEVMODE*, EDITOR_*, MISSION_FLOW_TOOLS), v vsakem načinu.
  • Profili tipkovnice, miške in igralnega pada (GUID="{0}"): vezave tipkovnice se v MSFS ne zapisujejo.
  • profile_00, prednastavitve, ki jih priloži Asobo, mesta prednastavitev za posamezna letala in vsak drug vsebnik v shranjenih podatkih Store (dnevniki letenja, drugi naslovi).
  • Naprave, ki niso povezane, naprave, ki jih uvoz prezre, in naprava vJoy, v katero JoyPro preusmerja.

#Letala, krivulje, ostalo

  • Podrobnost: za vsako napravo in kategorijo (Airplanes, General) in za vsak profil; simulator izbere profil za vsako napravo in letalo, JoyPro sledi tej izbiri.
  • Krivulje osi: stran Sensitivity naprave, en nabor na fizično os: Sensitivity + in -, Neutral, Dead zone, Extremity dead zone, Reactivity, zastavica brez krivulje in obračanje. Relacija lahko enemu dejanju da lastne vrednosti (preglasitev za posamezno dejanje v MSFS 2024). Relacije na isti osi naprave si delijo njeno stran: izvoz zapiše vrednosti prve relacije in opozori. Glejte axis-curves.
  • Povratna sila: MSFS nima lastne.
  • Snemanje telemetrije: prek SimConnect, samo branje, z vašo lastno datoteko SimConnect.dll (JoyPro je ne priloži): različica Steam za MSFS 2024 je nima, zato namestite MSFS 2024 SDK ali imejte nameščen MSFS 2020 (deluje tudi njegova kopija).
  • HUD: HUD najde simulator po njegovem procesu in pokaže njegove vezave.
  • Spremljanje: JoyPro spremlja svoj paket, profile Steam in containers.index shranjenih podatkov Store; ko se simulator zapre (shranjeni podatki Store počakajo 10 s po zadnjem zapisu), vpraša, ali naj prevzame vaše spremembe iz igre (spremljanje).
  • Ponovni uvoz: imena relacij, skupine in nastavitve osi se vrnejo prek metapodatkov JoyPro poleg datotek (ponovni uvoz).
  • Možnosti za strokovnjake (Druge igre na strani Začetek): Profil igre (izberite en profil, ko ima naprava več profilov), Izvozi letalo (izvozi tudi relacije, omejene na eno letalo, za vsa letala), Zapiši v moje profile MSFS, Zapiši tudi uvozne datoteke MSFS za vsako napravo, poskusni zagon.
Tehnične podrobnosti

#V notranjosti integracije MSFS 2024

flowchart LR
  P["Vaš profil"] --> E["engine msfs2024 export"]
  E --> U["Vaši lastni<br/>profili"]
  E --> K["Prednastavitve<br/>JoyPro"]
  E --> F["Datoteke za uvoz"]
  F --> I["Vi: zobnik,<br/>Import"]
  U --> S["Settings ><br/>Controls"]
  K --> S
  I --> S
Vaši lastni profili (Steam inputprofile_n ali shranjeni podatki Store) se zapišejo neposredno. Prednastavitve JoyPro (Community2024 / joypro-input-profiles, ena prednastavitev na napravo) služijo letalom, ki jih simulator še ni nastavil. Datoteke za uvoz (Documents / JoyPro2) v simulatorju naložite sami.

Koda: engine\Games\MsfsIntegration.cs (en razred za oba simulatorja), MsfsIntegration.UserProfiles.cs (neposredni zapis), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (branje Steam in Store), WgsContainers.cs (shranjeni podatki Store), MsfsSimProfile.cs (zapisi v profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (urejevalnik po vrsticah), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.

  • Format: fragment XML (več elementov na najvišji ravni): <Version>, <FriendlyName>, <Device DeviceName GUID ProductID CompositeID HWVer> z <Axes> in <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>. Profil 2024 navaja vsa dejanja svojih kontekstov, nevezana kot prazen <Action/>. Kode: gumb N = N-1, Hat 256-259, os L X/Y/Z 1026/1042/1058, os R 770/786/802, drsniki 514/530. Zastavice: 2 digitalno, 4 os, 128 obrnjeno, 1024 brez krivulje občutljivosti, 4096 preglasitev osi za posamezno dejanje. Znova se izrišejo samo spremenjeni elementi <Action>.
  • Naprave: profil svojo napravo imenuje po GUID-u primerka DirectInput (GUID), zato za branje ni potrebna nobena priključena naprava. Simulator prednastavitev poveže po ID-ju izdelka USB (hex): JoyPro uporabi tistega, ki ga je simulator zabeležil v profile_00, sicer USB PID (vJoy se prikaže z ID-jem izdelka 0).
  • Kateri profil je dejaven: za vsako napravo in letalo zapisi v profile_00 hranijo mesto General in mesto kategorije; lasten profil je tam inputprofile_<n>, kar je ime datoteke v Steamu in ime vsebnika v Store.
  • Shranjevanje v Store: zapiše se samo, ko ima indeks znano postavitev (različica 14, brez zastavice konflikta, vsebnik naveden enkrat v znanem stanju); nato nov blob, container.<n+1>, indeks na koncu (začasna datoteka in zamenjava), ponovno branje in odstranitev stare generacije. Vsaka napaka vse vrne nazaj; pri čemer koli neznanem se ne zapiše nič in vezave nosi uvozna datoteka.
  • Seznam ukazov: engine msfs2024 refresh-db prebere Asobove prednastavitve, vsak dogodek leta, ki ga imenuje en-US.locPak, vaše profile General in razpakirane pakete dodatkov (Community, Marketplace) z njihovimi letali; seznam letal pride iz simulatorjevega seznama vsebin. Sveža namestitev zgradi seznam ob prvem uvozu.
  • Ukazi: 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 in --import-files kot kljukici na strani Izvoz); relacije za posamezno letalo z engine relations aircraft set; razveljavitev z engine backups restore; spremljevalec z engine sync status in engine sync diff. Staro ime CLI engine msfs ... še vedno pomeni MSFS 2024.

#Znane omejitve

  • Mesta prednastavitev za posamezna letala se ne zapišejo (pridejo samo z lastnim paketom letala); JoyPro nikoli ne piše v profile_00 (datoteka se konča s kontrolno vsoto).
  • Prednastavitev JoyPro doseže samo letala, ki jih simulator za napravo še ni nastavil; drugje vezave nosi vaš lasten profil ali uvozna datoteka.
  • Največ dve kombinaciji vhodov na dejanje; tretja se sporoči. Polovične osi, diagonale hata in drugi hat se ne berejo in ne zapišejo. Modifikatorji: samo gumbi iste naprave.
  • Zapakirani paketi dodatkov (.fsarchive) se preskočijo; poti shranjevanja v Store, daljše od 260 znakov, se ne preberejo.
  • Kopija v oblaku (Steam Cloud, oblak Xbox) lahko prevlada nad zapisom JoyPro, če je drug računalnik shranjeval pozneje.
  • Testi: engine\tests\smoke\msfs.ps1, smoke\msfsuserprofiles.ps1, gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs (shranjevanja Steam in Store, profili za posamezna letala, povrnitev), MsfsStoreWatcherEndToEndTests; v simulatorju tools\e2e\games\Msfs2024Settings.ps1 (prednastavitve, osi, gumbi in krivulja za posamezno dejanje v Controls).

Vse tehnične opombe o tej igri (ustvarjene iz repozitorija): msfs.md.