JoyPro2 Discord GitHub
Gry

Microsoft Flight Simulator 2024

Pokaż:

MSFS 2024 trzyma Twoje sterowanie w profilach, po jednym na urządzenie i kategorię (Airplanes i General), i pamięta dla każdego urządzenia i maszyny, którego profilu używa. JoyPro wczytuje te profile do jednego własnego profilu i zapisuje Twoje przypisania z powrotem dokładnie w tych profilach, których używa symulator, w wersji Steam i Microsoft Store. Dla maszyn, których symulator nie skonfigurował jeszcze dla danego urządzenia, JoyPro dodaje własne presety jako mały pakiet w folderze Community2024 symulatora, a tam, gdzie nie może zapisać profilu, zostawia Ci plik do zaimportowania w menu Controls symulatora.

Microsoft Flight Simulator 2024 natywnie (własne pliki przypisań)
Obsługa
natywnie (własne pliki przypisań)
Polecenie silnika
engine msfs2024
Plik przypisań
Twój własny profil, którego symulator używa dla każdego urządzenia i kategorii (XML Steam remote\inputprofile_* lub zapis z Microsoft Store, --user-profiles) + pakiet Community JoyPro (joypro-input-profiles, jeden XML presetu na urządzenie); pliki importu w Documents\JoyPro2\MSFS 2024 import files tam, gdzie nie da się zapisać Twojego profilu
Wejścia, które gra czyta
odczytuje 8 osi, 1 hat (4 kierunki) na joystick (udokumentowane)
Lista poleceń z
pliki presetów Asobo, zdarzenia lotu wymienione w fs-base\en-US.locPak, zainstalowane maszyny
Test w grze
26/26 kroków zaliczonych (2026-10-11)
  • ✓ Importuj
  • ✓ Eksportuj
  • ✗ Przypisania klawiatury
  • ◐ ModyfikatoryMSFS: tylko przyciski modyfikatorów z tego samego urządzenia.
  • ✓ Lista poleceń budowana na Twoim PC
  • ✓ Obserwator gier
  • ✓ Krzywe osi i martwe strefy
  • ✗ Ustawienia sterowania w grze
  • ✗ Ustawienia force feedback w grze
  • ✗ Force feedback z telemetrii
  • ✓ Nagrywanie telemetrii
  • ✓ Wirtualny joystick (vJoy)
  • ◐ Wirtualny pad Xbox
  • ✓ Funkcje wirtualne
  • ✓ Kreator konfiguracji / Autoprzypisanie
  • ✓ Kokpity
  • ✓ Ściągi
  • ✓ Test w grze

Z macierzy obsługi, wygenerowanej z kodu silnika: wszystkie gry.

Dla początkujących

#Uruchom to w 3 krokach

  1. Ustaw wszystko za mnie
    na stronie Start
  2. Użyj tych przycisków
    najpierw obejrzyj listę
  3. Zapisz w mojej grze
    symulator musi być zamknięty

Przed: podłącz raz każde urządzenie.

Potem: przeczytaj pole Twoje profile MSFS 2024. Wymienia plik importu? Wtedy zaimportuj ten plik w symulatorze (zobacz Co robisz sam poniżej).

Przypisywałeś już przyciski w MSFS 2024? Wtedy strona Start zaproponuje Importuj, potem wypełnij luki. Twoje przypisania zostają, a nowe zadania dostają tylko wolne przyciski. Zobacz Szybki start: niech mój drążek działa.

#Co JoyPro robi dla MSFS 2024

  • Importuj: profile, które zrobiłeś w menu Controls symulatora (Steam lub Microsoft Store), trafiają do Twojego profilu, przypisania lotu i przypisania General (kamery, widoki, aktywna pauza itd.), razem z ustawieniami osi ze strony Sensitivity. Urządzenie, którego nigdy nie zmieniałeś w symulatorze, przynosi preset dostarczany dla niego przez symulator, jeśli własne zapisy symulatora pokazują, że używa tego presetu.
  • Relacje: jedna relacja to jedna funkcja. W MSFS 2024 relacja może obowiązywać dla wszystkich maszyn (domyślnie) albo tylko dla maszyn, które zaznaczysz, jak w DCS.
  • Eksportuj: JoyPro zapisuje Twoje przypisania w profilu, którego symulator używa dla każdego urządzenia i kategorii, zapisuje swój pakiet presetów dla maszyn, których symulator jeszcze nie skonfigurował, i zapisuje plik importu tam, gdzie nie mógł zaktualizować Twojego profilu.

#Zaimportuj przypisania z MSFS 2024

  1. Otwórz Start i naciśnij Importuj na karcie Microsoft Flight Simulator 2024.
  2. Dla MSFS liczą się dwie opcje, obie wyłączone, dopóki ich nie zaznaczysz:
    • Importuj także urządzenia, które nie są podłączone: MSFS trzyma przypisania każdego urządzenia, jakie kiedykolwiek widział. Wyłączone: tylko urządzenia podłączone teraz.
    • Importuj także domyślne presety, których symulator może nie używać: dla urządzeń, przy których zapisy symulatora nie pokazują użycia dostarczonego presetu. Może to dodać przypisania, których symulator nie ma.
  3. Naciśnij Importuj teraz (albo Najpierw zobacz, żeby zobaczyć, co ma symulator, bez zmieniania Twojego profilu).

Zaimportowane relacje obowiązują dla wszystkich maszyn. Gdy przypisanie istnieje tylko w profilach niektórych maszyn, strona Relacje pokazuje po imporcie notatkę z opcjami Ogranicz do tych maszyn dla każdej relacji, Ogranicz wszystkie i Zachowaj dla wszystkich maszyn.

Strona Start z Twoimi gramiStrona Start z Twoimi grami
Strona Start z Twoimi grami (Obrazy pokazują aplikację po angielsku.)

#Buduj i sprawdzaj relacje

Na stronie Relacje akcja MSFS 2024 pokazuje maszyny symulatora z polami wyboru: zaznaczenie wszystkich maszyn oznacza wszystkie maszyny. Akcja, która istnieje tylko w niektórych dodatkowych maszynach, pokazuje „only for:” z tymi maszynami, a dodanie jej zaznacza tylko je. Zobacz przebieg relacji, potem uruchom sprawdzanie na stronie Eksport: znajdzie przycisk z dwiema funkcjami, zanim zrobi to symulator.

#Eksport do MSFS 2024

  1. Zamknij MSFS 2024. JoyPro odmawia zapisu, dopóki symulator działa (w wersji Microsoft Store także dopóki działa jego pomocnik uruchamiania).
  2. Otwórz Eksportuj. W Eksportuj do gier dwa pola wyboru dotyczą MSFS 2024:
    • MSFS 2024: zapisuj do moich profili MSFS (włączone): eksport aktualizuje profil, którego symulator używa dla każdego urządzenia i kategorii, po wcześniejszym zrobieniu kopii zapasowej.
    • MSFS 2024: pliki importu dla każdego urządzenia (wyłączone): plik importu dla każdego urządzenia i kategorii, nie tylko tam, gdzie JoyPro nie mógł zapisać Twojego profilu.
  3. Zostaw Zastąp na moich urządzeniach razem z Wyczyść też moje inne urządzenia, jeśli to w JoyPro konfigurujesz swoje urządzenia, i naciśnij Eksportuj teraz na karcie MSFS 2024.

Po eksporcie pole Twoje profile MSFS 2024 wymienia każdy profil zapisany przez JoyPro, z jego maszynami i liczbą przypisań. Gdy zapisano pliki importu, drugie pole wymienia je z przyciskiem Otwórz folder.

Strona EksportStrona Eksport
Strona Eksport
W grze: Co widzisz w MSFS 2024

Uruchom symulator i otwórz Settings > Controls, potem wybierz urządzenie i kategorię (Airplanes lub General). Twoje przypisania są w Twoim własnym profilu, pod nazwami akcji symulatora; strona urządzenia (Hardware Settings pod zębatką urządzenia) pokazuje krzywe osi zapisane przez JoyPro. W maszynie, której symulator nie skonfigurował jeszcze dla tego urządzenia, urządzenie startuje z presetem JoyPro.

#Co robisz sam w MSFS 2024

  • Nic dla każdego profilu, który jest wymieniony jako zaktualizowany w Twoje profile MSFS 2024.
  • Pliki importu: gdy eksport jakiś wymienia, otwórz Settings > Controls, wybierz urządzenie i kategorię (Airplanes lub General), kliknij zębatkę profilu (nie tę od presetu), wybierz Importuj i wskaż plik zapisany przez JoyPro dla tego urządzenia i kategorii. Symulator przyjmuje plik tylko dla tego samego urządzenia i kategorii. Gdy plik ma nazwę Twojego profilu, symulator zapyta, czy go nadpisać: potwierdź, a Twój profil będzie miał przypisania JoyPro. Importuj plik ponownie tylko wtedy, gdy eksport mówi, że jest nowy lub zmieniony.
  • Podłącz raz każde urządzenie przed pierwszym eksportem: JoyPro potrzebuje ID produktu urządzenia dla swojego presetu.
  • Jedna maszyna potrzebuje innych przypisań niż pozostałe: daj jej w symulatorze własny profil (Controls, z załadowaną tą maszyną: zduplikuj profil), potem wyeksportuj ponownie. Eksport wymienia każdą relację, której nie mógł umieścić.
  • Pytanie o chmurę Xbox: jeśli symulator lub aplikacja Xbox pyta, który zapis zachować, zachowaj ten z tego PC; drugi usuwa przypisania JoyPro (wtedy wyeksportuj ponownie).

#Częste pułapki

  • „MSFS 2024 działa”: zamknij symulator; w wersji Microsoft Store musi też zniknąć pomocnik uruchamiania symulatora (gamelaunchhelper.exe).
  • Brak przypisań w jednej maszynie: ta maszyna używa innego Twojego profilu. Sprawdź listę Twoje profile MSFS 2024; linia z „import file” oznacza, że importujesz ten plik w symulatorze.
  • Relacja nie została zapisana: jest ograniczona do niektórych maszyn, ale profil, którego symulator tam używa, jest wspólny z innymi maszynami. Ostrzeżenie wymienia profil i maszyny.
  • Urządzenie ma kilka profili: import bierze ten, który wskazują zapisy symulatora, a w przeciwnym razie najnowszy, i wymienia pozostałe. Wybierz inny w Profil gry w formularzu Inne gry na stronie Start.
  • „WRONG DEVICE” podczas przypisywania w symulatorze: urządzenie, które ciągle wysyła wartości (niektóre drążki z force feedback), przejmuje skanowanie symulatora. Dzieje się to przy przypisywaniu w samym symulatorze, nie w JoyPro.
  • Reset to Defaults w symulatorze resetuje presety każdego urządzenia i maszyny; JoyPro nigdy nie robi tego za Ciebie.
Zaawansowane

#Pliki, które JoyPro czyta i zapisuje

Plik Co to jest
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> Twój własny profil (Steam), zwykły XML bez rozszerzenia; zapisywany na miejscu, Steam Cloud wysyła go przy następnej synchronizacji
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ zapis wersji Microsoft Store (containers.index, container.<n>, jeden blob na profil); JoyPro zapisuje nowy blob, nowy plik kontenera i indeks
remote\profile_00 (Store: kontener profile_00) zapisy urządzeń symulatora: którego profilu lub presetu używa każde urządzenie dla każdej maszyny. Tylko odczyt, nigdy nie są zapisywane
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml Preset JoyPro dla urządzenia (akcje lotu), z layout.json i manifest.json
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml Preset JoyPro z przypisaniami General urządzenia
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml pliki importu, we własnym formacie profili symulatora
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak presety dostarczane przez Asobo i nazwy menu: tylko odczyt, na potrzeby listy poleceń i domyślnych presetów
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS dane o własności i kopie zapasowe JoyPro, nigdy w synchronizowanym folderze

<packages> to InstalledPackagesPath z %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Przed każdym zapisem cały folder zapisu wersji Store lub plik Steam trafia do zestawu kopii zapasowych, więc Cofnij ostatni eksport przywraca zapis.

#Tryby eksportu w MSFS 2024

Tryby działają dla każdego profilu (czyli dla każdej grupy maszyn) i tylko w zarządzanych kontekstach.

Tryb Co dzieje się w Twoich profilach MSFS 2024
Tylko dodaj Przypisanie jest zapisywane tylko tam, gdzie żadna inna akcja tego profilu nie używa tej kombinacji wejść; w przeciwnym razie jest wymieniane jako niezapisane. Nic nie jest usuwane.
Aktualizuj, zachowaj przypisania gry Inna akcja na Twojej kombinacji wejść ją traci; wszystko inne zostaje, także stara kombinacja akcji (akcja ma dwie: Primary i Secondary).
Aktualizuj, wygrywa mój profil Jak wyżej, a do tego każda akcja, którą przypisujesz, traci swoje inne kombinacje, także w profilach innych podłączonych urządzeń (te profile też są zapisywane).
Zastąp na moich urządzeniach Profile podłączonych urządzeń, które zapisuje JoyPro, zachowują tylko Twoje przypisania.
+ Wyczyść też moje inne urządzenia Nigdy nie czyści żadnego z Twoich własnych profili MSFS 2024.

Relacja dla wszystkich maszyn trafia do każdego profilu wymienionego w zapisach symulatora; relacja ograniczona do maszyn trafia tylko do profili, których wszystkie maszyny są zaznaczone. Ograniczone relacje nigdy nie trafiają do pakietu presetów ani do plików importu, bo te dotyczą każdej maszyny.

#Co nigdy nie jest ruszane

  • Konteksty menu, mapy świata i deweloperskie (MENU, MENU_*, WORLDMAP_*, DEBUG, DEVMODE*, EDITOR_*, MISSION_FLOW_TOOLS), w każdym trybie.
  • Profile klawiatury, myszy i gamepada (GUID="{0}"): w MSFS przypisania klawiatury nie są zapisywane.
  • profile_00, presety dostarczane przez Asobo, miejsca presetów dla konkretnych maszyn i każdy inny kontener zapisu wersji Store (dzienniki lotów, inne tytuły).
  • Urządzenia, które nie są podłączone, urządzenia ignorowane przy imporcie i urządzenie vJoy, do którego JoyPro przekazuje wejścia.

#Maszyny, krzywe, reszta

  • Szczegółowość: dla każdego urządzenia i kategorii (Airplanes, General) oraz dla każdego profilu; symulator wybiera profil dla każdego urządzenia i maszyny, a JoyPro podąża za tym wyborem.
  • Krzywe osi: strona Sensitivity urządzenia, jeden zestaw na fizyczną oś: Sensitivity + i -, Neutral, Dead zone, Extremity dead zone, Reactivity, flaga braku krzywej i odwrócenie. Relacja może dać jednej akcji własne wartości (nadpisanie dla pojedynczej akcji w MSFS 2024). Relacje na tej samej osi urządzenia dzielą jej stronę: eksport zapisuje wartości pierwszej relacji i ostrzega. Zobacz axis-curves.
  • Force feedback: MSFS nie ma własnego.
  • Nagrywanie telemetrii: przez SimConnect, tylko odczyt, z Twoim własnym SimConnect.dll (JoyPro go nie dostarcza): wersja Steam MSFS 2024 go nie ma, więc zainstaluj MSFS 2024 SDK albo miej zainstalowany MSFS 2020 (jego kopia też działa).
  • HUD: HUD znajduje symulator po jego procesie i pokazuje jego przypisania.
  • Obserwator: JoyPro obserwuje swój pakiet, profile Steam i containers.index zapisu wersji Store; po zamknięciu symulatora (zapis wersji Store czeka 10 s od ostatniego zapisu) pyta, czy przejąć Twoje zmiany z gry (obserwator).
  • Ponowny import: nazwy relacji, grupy i strojenie wracają przez metadane JoyPro obok plików (ponowny import).
  • Opcje dla ekspertów (Inne gry na stronie Start): Profil gry (wybierz jeden profil, gdy urządzenie ma kilka), Eksportuj maszynę (eksportuj też relacje ograniczone do jednej maszyny, dla każdej maszyny), Zapisuj do moich profili MSFS, Zapisuj także pliki importu MSFS dla każdego urządzenia, próba.
Szczegóły techniczne

#Wnętrze integracji MSFS 2024

flowchart LR
  P["Twój profil"] --> E["engine msfs2024 export"]
  E --> U["Twoje własne<br/>profile"]
  E --> K["Presety<br/>JoyPro"]
  E --> F["Pliki importu"]
  F --> I["Ty: koło zębate,<br/>Import"]
  U --> S["Settings ><br/>Controls"]
  K --> S
  I --> S
Twoje własne profile (Steam inputprofile_n lub zapis wersji Store) są zapisywane bezpośrednio. Presety JoyPro (Community2024 / joypro-input-profiles, jeden preset na urządzenie) obsługują maszyny, których symulator jeszcze nie skonfigurował. Pliki importu (Documents / JoyPro2) wczytujesz w symulatorze sam.

Kod: engine\Games\MsfsIntegration.cs (jedna klasa dla obu symulatorów), MsfsIntegration.UserProfiles.cs (bezpośredni zapis), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (odczyt Steam i Store), WgsContainers.cs (zapis wersji Store), MsfsSimProfile.cs (zapisy w profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (edytor działający na liniach), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.

  • Format: fragment XML (kilka elementów najwyższego poziomu): <Version>, <FriendlyName>, <Device DeviceName GUID ProductID CompositeID HWVer> z <Axes> i <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>. Profil 2024 wymienia każdą akcję swoich kontekstów, nieprzypisane jako puste <Action/>. Kody: przycisk N = N-1, hat 256-259, oś L X/Y/Z 1026/1042/1058, oś R 770/786/802, suwaki 514/530. Flagi: 2 cyfrowa, 4 oś, 128 odwrócenie, 1024 bez krzywej czułości, 4096 nadpisanie osi dla pojedynczej akcji. Ponownie renderowane są tylko zmienione elementy <Action>.
  • Urządzenia: profil nazywa swoje urządzenie po GUID instancji DirectInput (GUID), więc do jego odczytu nie trzeba podłączonego urządzenia. Symulator dopasowuje preset po ID produktu USB (hex): JoyPro używa tego, które symulator zapisał w profile_00, a w przeciwnym razie USB PID (vJoy ma ID produktu 0).
  • Który profil jest aktywny: dla każdego urządzenia i maszyny wpisy w profile_00 mają slot General i slot kategorii; własny profil ma tam nazwę inputprofile_<n>, która jest nazwą pliku w wersji Steam i nazwą kontenera w wersji Store.
  • Zapis w wersji Store: tylko wtedy, gdy indeks ma znany układ (wersja 14, bez flagi konfliktu, kontener wymieniony raz w znanym stanie); wtedy powstaje nowy blob container.<n+1>, indeks na końcu (plik tymczasowy i podmiana), odczyt kontrolny, a stara generacja zostaje usunięta. Każdy błąd przywraca wszystko; przy czymkolwiek nieznanym nic nie jest zapisywane, a przypisania niesie plik importu.
  • Lista poleceń: engine msfs2024 refresh-db czyta presety Asobo, każde zdarzenie lotu nazwane w en-US.locPak, Twoje profile General oraz rozpakowane pakiety dodatków (Community, Marketplace) z ich maszynami; lista maszyn pochodzi z listy zawartości symulatora. Przy świeżej instalacji lista powstaje przy pierwszym imporcie.
  • Polecenia: 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 i --import-files jako dwa pola wyboru strony Eksport); relacje dla poszczególnych maszyn przez engine relations aircraft set; cofanie przez engine backups restore; obserwator przez engine sync status i engine sync diff. Stara nazwa CLI engine msfs ... nadal oznacza MSFS 2024.

#Znane ograniczenia

  • Sloty presetów dla konkretnych maszyn nie są zapisywane (przychodzą tylko z własnym pakietem maszyny); JoyPro nigdy nie zapisuje profile_00 (plik kończy się sumą kontrolną).
  • Preset JoyPro dociera tylko do maszyn, których symulator jeszcze nie skonfigurował dla danego urządzenia; w pozostałych przypisania niesie Twój własny profil albo plik importu.
  • Najwyżej dwie kombinacje wejść na akcję; trzecia zostaje zgłoszona. Połówki osi, skosy hatów i drugi hat nie są odczytywane ani zapisywane. Modyfikatory: tylko przyciski tego samego urządzenia.
  • Spakowane pakiety dodatków (.fsarchive) są pomijane; ścieżki zapisu Store dłuższe niż 260 znaków nie są odczytywane.
  • Kopia w chmurze (Steam Cloud, chmura Xbox) może wygrać z zapisem JoyPro, gdy inny komputer zapisał później.
  • Testy: engine\tests\smoke\msfs.ps1, smoke\msfsuserprofiles.ps1, gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs (zapisy Steam i Store, profile dla poszczególnych maszyn, wycofanie), MsfsStoreWatcherEndToEndTests; w symulatorze tools\e2e\games\Msfs2024Settings.ps1 (presety, osie, przyciski i krzywa dla akcji w Controls).

Wszystkie notatki techniczne o tej grze (wygenerowane z repozytorium): msfs.md.