JoyPro2 Discord GitHub
Games

Microsoft Flight Simulator 2024

Tonen:

MSFS 2024 bewaart je bediening in profielen, één per apparaat en categorie (Airplanes en General), en onthoudt voor elk apparaat en toestel welk profiel het gebruikt. JoyPro leest deze profielen in één eigen profiel en schrijft je toewijzingen terug in precies de profielen die de sim gebruikt, in de Steam- en de Microsoft Store-versie. Voor toestellen die de sim nog niet voor een apparaat heeft ingesteld, voegt JoyPro zijn eigen presets toe als een klein pakket in de map Community2024 van de sim, en waar het geen profiel kan schrijven, laat het een bestand achter dat je importeert in het menu Controls van de sim.

Microsoft Flight Simulator 2024 rechtstreeks (eigen toewijzingsbestanden)
Ondersteuning
rechtstreeks (eigen toewijzingsbestanden)
Engine-commando
engine msfs2024
Toewijzingsbestand
je eigen profiel dat de sim per apparaat en categorie gebruikt (Steam-XML remote\inputprofile_* of de save van de Microsoft Store, --user-profiles) + JoyPro's Community-pakket (joypro-input-profiles, één preset-XML per apparaat); importbestanden in Documents\JoyPro2\MSFS 2024 import files waar je profiel niet geschreven kan worden
Inputs die de game leest
leest 8 assen, 1 hat (4 richtingen) per joystick (gedocumenteerd)
Commandolijst uit
de presetbestanden van Asobo, de vluchtevents die fs-base\en-US.locPak noemt, de geïnstalleerde toestellen
In-game test
26/26 stappen geslaagd (2026-10-11)
  • ✓ Importeren
  • ✓ Exporteren
  • ✗ Toetsenbordtoewijzingen
  • ◐ ModifiersMSFS: alleen modifierknoppen van hetzelfde apparaat.
  • ✓ Commandolijst gemaakt op je pc
  • ✓ Gamebewaking
  • ✓ Ascurves en dode zones
  • ✗ Bedieningsinstellingen van de game
  • ✗ Force-feedbackinstellingen in de game
  • ✗ Force feedback uit telemetrie
  • ✓ Telemetrie-opname
  • ✓ Virtuele joystick (vJoy)
  • ◐ Virtuele Xbox-pad
  • ✓ Virtuele functies
  • ✓ Installatiewizard / Automatisch toewijzen
  • ✓ Cockpits
  • ✓ Spiekbrieven
  • ✓ In-game test

Uit de ondersteuningstabel, gegenereerd uit de code van de engine: alle games.

Voor beginners

#In 3 stappen aan de slag

  1. Alles voor me instellen
    op de startpagina
  2. Deze knoppen gebruiken
    bekijk eerst de lijst
  3. Naar mijn game schrijven
    houd de sim gesloten

Vooraf: sluit elk apparaat één keer aan.

Daarna: lees het vak Je MSFS 2024-profielen. Noemt het een importbestand? Importeer dat bestand dan in de sim (zie Wat je zelf doet hieronder).

Heb je eerder knoppen toegewezen in MSFS 2024? Dan biedt de startpagina Importeren, dan gaten vullen aan. Je toewijzingen blijven, en alleen vrije knoppen krijgen nieuwe taken. Zie Snelstart: mijn stick laten werken.

#Wat JoyPro doet voor MSFS 2024

  • Importeren: de profielen die je in het menu Controls van de sim hebt gemaakt (Steam of Microsoft Store) komen in je profiel, vliegtoewijzingen en General-toewijzingen (camera's, zichten, actieve pauze enzovoort), met de asinstellingen van de pagina Sensitivity. Een apparaat dat je in de sim nooit hebt gewijzigd, brengt de preset mee die de sim ervoor meelevert, als de eigen gegevens van de sim laten zien dat het die preset gebruikt.
  • Relaties: één relatie is één functie. In MSFS 2024 kan een relatie voor alle toestellen gelden (standaard) of alleen voor de toestellen die je aanvinkt, zoals in DCS.
  • Exporteren: JoyPro schrijft je toewijzingen in het profiel dat de sim voor elk apparaat en elke categorie gebruikt, schrijft zijn presetpakket voor toestellen die de sim nog niet heeft ingesteld, en schrijft een importbestand waar het je profiel niet kon bijwerken.

#Je MSFS 2024-toewijzingen importeren

  1. Open Start en druk op Importeren op de kaart van Microsoft Flight Simulator 2024.
  2. Twee opties zijn belangrijk voor MSFS, allebei uit tenzij je ze aanvinkt:
    • Ook apparaten importeren die niet aangesloten zijn: MSFS bewaart de toewijzingen van elk apparaat dat het ooit zag. Uit: alleen de apparaten die nu zijn aangesloten.
    • Ook standaardpresets importeren die de sim misschien niet gebruikt: voor apparaten waarvan de gegevens van de sim niet laten zien dat ze een meegeleverde preset gebruiken. Dit kan toewijzingen toevoegen die de sim niet heeft.
  3. Druk op Nu importeren (of op Eerst bekijken om te zien wat de sim heeft zonder je profiel te wijzigen).

Geïmporteerde relaties gelden voor alle toestellen. Bestaat een toewijzing alleen in de profielen van sommige toestellen, dan toont de pagina Relaties na de import een melding met Tot deze toestellen beperken per relatie, Alles beperken en Voor alle toestellen behouden.

De startpagina met je gamesDe startpagina met je games
De startpagina met je games (De afbeeldingen tonen de app in het Engels.)

#Relaties maken en controleren

Op de pagina Relaties toont een MSFS 2024-actie de toestellen van de sim met vinkjes: alle toestellen aangevinkt betekent alle toestellen. Een actie die alleen in sommige add-on-toestellen bestaat, zegt "alleen voor:" met die toestellen, en als je haar toevoegt, worden alleen die aangevinkt. Zie de werkwijze voor relaties en voer dan de controle uit op de pagina Exporteren: die vindt een knop met twee functies, nog voordat de sim dat doet.

#Exporteren naar MSFS 2024

  1. Sluit MSFS 2024. JoyPro weigert te schrijven zolang de sim draait (in de Microsoft Store-versie ook zolang zijn starthulp draait).
  2. Open Exporteren. Onder Naar games exporteren zijn twee vinkjes voor MSFS 2024:
    • MSFS 2024: in mijn MSFS-profielen schrijven (aan): de export werkt het profiel bij dat de sim voor elk apparaat en elke categorie gebruikt, met eerst een back-up.
    • MSFS 2024: importbestanden voor elk apparaat (uit): een importbestand voor elk apparaat en elke categorie, niet alleen waar JoyPro je profiel niet kon schrijven.
  3. Laat Vervangen op mijn apparaten met Ook mijn andere apparaten wissen staan als je je apparaten in JoyPro instelt, en druk op Nu exporteren op de kaart van MSFS 2024.

Na de export toont het vak Je MSFS 2024-profielen elk profiel dat JoyPro schreef, met de toestellen en het aantal toewijzingen. Zijn er importbestanden geschreven, dan noemt een tweede vak ze, met Map openen.

De pagina ExporterenDe pagina Exporteren
De pagina Exporteren
In de game: Wat je ziet in MSFS 2024

Start de sim, open Settings > Controls en kies dan je apparaat en de categorie (Airplanes of General). Je toewijzingen staan in je eigen profiel, onder de actienamen van de sim; de apparaatpagina (Hardware Settings onder het tandwiel van het apparaat) toont de ascurves die JoyPro schreef. In een toestel dat de sim nog niet voor dat apparaat heeft ingesteld, begint het apparaat met de preset van JoyPro.

#Wat je zelf doet in MSFS 2024

  • Niets, voor elk profiel dat in Je MSFS 2024-profielen als bijgewerkt staat.
  • Importbestanden: noemt de export er een, open dan Settings > Controls, kies het apparaat en de categorie (Airplanes of General), klik op het tandwiel van het profiel (niet dat van de preset), kies Import en selecteer het bestand dat JoyPro voor dat apparaat en die categorie schreef. De sim accepteert een bestand alleen voor hetzelfde apparaat en dezelfde categorie. Draagt het bestand de naam van je profiel, dan vraagt de sim of het moet worden overschreven: bevestig, en je profiel heeft de toewijzingen van JoyPro. Importeer een bestand alleen opnieuw als de export zegt dat het nieuw of gewijzigd is.
  • Sluit elk apparaat één keer aan vóór de eerste export: JoyPro heeft de product-ID van het apparaat nodig voor zijn preset.
  • Eén toestel heeft andere toewijzingen nodig dan de rest: geef het een eigen profiel in de sim (Controls, met dat toestel geladen: dupliceer het profiel) en exporteer dan opnieuw. De export noemt elke relatie die het niet kon plaatsen.
  • Xbox-cloudvraag: vraagt de sim of de Xbox-app welke opslag je wilt houden, kies dan die van deze pc; de andere laat de toewijzingen van JoyPro vallen (exporteer dan opnieuw).

#Veelgemaakte fouten

  • "MSFS 2024 draait": sluit de sim; in de Microsoft Store-versie moet ook de starthulp van de sim (gamelaunchhelper.exe) weg zijn.
  • Toewijzingen ontbreken in één toestel: dat toestel gebruikt een ander profiel van je. Bekijk de lijst Je MSFS 2024-profielen; een regel met "importbestand" betekent dat je dat bestand in de sim importeert.
  • Een relatie werd niet geschreven: ze is beperkt tot sommige toestellen, maar het profiel dat de sim daar gebruikt, wordt gedeeld met andere toestellen. De waarschuwing noemt het profiel en de toestellen.
  • Een apparaat heeft meerdere profielen: de import neemt het profiel dat de gegevens van de sim noemen, anders het nieuwste, en noemt de andere. Kies een ander met Gameprofiel in het formulier Andere games op de startpagina.
  • "WRONG DEVICE" bij het toewijzen in de sim: een apparaat dat steeds waarden blijft sturen (sommige force-feedbacksticks) neemt de scan van de sim over. Dit gebeurt bij het toewijzen in de sim zelf, niet in JoyPro.
  • Reset to Defaults in de sim zet de presets van elk apparaat en toestel terug; JoyPro doet dat nooit voor je.
Geavanceerd

#Bestanden die JoyPro leest en schrijft

Bestand Wat het is
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> je eigen profiel (Steam), gewone XML zonder extensie; ter plekke geschreven, Steam Cloud uploadt het bij de volgende synchronisatie
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ de save van de Microsoft Store (containers.index, container.<n>, één blob per profiel); JoyPro schrijft een nieuwe blob, een nieuw containerbestand en de index
remote\profile_00 (Store: de container profile_00) de apparaatgegevens van de sim: welk profiel of welke preset elk apparaat per toestel gebruikt. Alleen lezen, nooit geschreven
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml de preset van JoyPro voor een apparaat (vluchtacties), met layout.json en manifest.json
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml de preset van JoyPro voor de General-toewijzingen van een apparaat
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml de importbestanden, in het eigen profielformaat van de sim
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak de presets die Asobo meelevert en de menunamen: alleen lezen, voor de commandolijst en de standaardpresets
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS de eigendomsgegevens en back-ups van JoyPro, nooit in een gesynchroniseerde map

<packages> is InstalledPackagesPath uit %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Vóór elke keer schrijven gaat de hele savemap van de Store of het Steam-bestand in de back-upset, dus Laatste export ongedaan maken zet de save terug.

#De exportmodi in MSFS 2024

De modi werken per profiel (dus per toestelgroep) en alleen in de beheerde contexten.

Modus Wat er in je MSFS 2024-profielen gebeurt
Alleen toevoegen Een toewijzing wordt alleen geschreven waar geen andere actie van dat profiel de inputcombinatie gebruikt; anders wordt hij als niet geschreven vermeld. Er wordt niets verwijderd.
Bijwerken, toewijzingen van game behouden De andere actie op jouw inputcombinatie verliest die; al het andere blijft, ook de oude combinatie van een actie (een actie heeft er twee: Primary en Secondary).
Bijwerken, mijn profiel wint Zoals hierboven, en elke actie die je toewijst, verliest haar andere combinaties, ook in de profielen van andere aangesloten apparaten (die profielen worden ook geschreven).
Vervangen op mijn apparaten De profielen van de aangesloten apparaten die JoyPro schrijft, houden alleen jouw toewijzingen.
+ Ook mijn andere apparaten wissen Maakt nooit een van je eigen MSFS 2024-profielen leeg.

Een relatie voor alle toestellen gaat naar elk profiel dat de gegevens van de sim noemen; een relatie die beperkt is tot bepaalde toestellen, gaat alleen naar profielen waarvan alle toestellen zijn aangevinkt. Beperkte relaties gaan nooit naar het presetpakket of de importbestanden, omdat die voor elk toestel gelden.

#Wat nooit wordt aangeraakt

  • De contexten voor menu, wereldkaart en ontwikkelaars (MENU, MENU_*, WORLDMAP_*, DEBUG, DEVMODE*, EDITOR_*, MISSION_FLOW_TOOLS), in elke modus.
  • Profielen van toetsenbord, muis en gamepad (GUID="{0}"): toetsenbordtoewijzingen worden in MSFS niet geschreven.
  • profile_00, de presets die Asobo meelevert, toestelspecifieke presetplekken en elke andere container van de Store-save (logboeken, andere titels).
  • Apparaten die niet zijn aangesloten, de genegeerde apparaten van de import en het vJoy-apparaat waar JoyPro doorheen tunnelt.

#Toestellen, curves, de rest

  • Granulariteit: per apparaat en categorie (Airplanes, General) en per profiel; de sim kiest het profiel per apparaat en toestel, JoyPro volgt die keuze.
  • As-curves: de pagina Sensitivity van het apparaat, één set per fysieke as: Sensitivity + en -, Neutral, Dead zone, Extremity dead zone, Reactivity, de vlag voor geen curve en omkeren. Een relatie kan één actie eigen waarden geven (de afwijking per actie van MSFS 2024). Relaties op dezelfde apparaatas delen de pagina ervan: de export schrijft de waarden van de eerste relatie en waarschuwt. Zie axis-curves.
  • Force feedback: MSFS heeft geen eigen force feedback.
  • Telemetrie-opname: via SimConnect, alleen lezen, met je eigen SimConnect.dll (JoyPro levert er geen mee): de Steam-versie van MSFS 2024 heeft er geen, dus installeer de MSFS 2024 SDK of zorg dat MSFS 2020 geïnstalleerd is (die kopie werkt ook).
  • HUD: de HUD vindt de sim aan zijn proces en toont de toewijzingen ervan.
  • Bewaking: JoyPro bewaakt zijn pakket, de Steam-profielen en containers.index van de Store-save; nadat de sim is afgesloten (de Store-save wacht 10 s na de laatste keer schrijven), vraagt het of je je wijzigingen uit de game wilt overnemen (de gamebewaking).
  • Opnieuw importeren: namen van relaties, groepen en afstemming komen terug via de metagegevens van JoyPro naast de bestanden (opnieuw importeren).
  • Opties voor experts (Andere games op de Startpagina): Gameprofiel (kies één profiel als een apparaat er meerdere heeft), Toestel exporteren (ook de relaties die tot één toestel beperkt zijn exporteren, voor elk toestel), In mijn MSFS-profielen schrijven, Ook MSFS-importbestanden schrijven voor elk apparaat, een proefrun.
Technische details

#Binnen in de MSFS 2024-koppeling

flowchart LR
  P["Je profiel"] --> E["engine msfs2024 export"]
  E --> U["Je eigen<br/>profielen"]
  E --> K["Presets van<br/>JoyPro"]
  E --> F["Importbestanden"]
  F --> I["Jij: tandwiel,<br/>Import"]
  U --> S["Settings ><br/>Controls"]
  K --> S
  I --> S
Je eigen profielen (Steam inputprofile_n of de Store-save) worden direct geschreven. De presets van JoyPro (Community2024 / joypro-input-profiles, een preset per apparaat) dienen voor toestellen die de sim nog niet heeft ingesteld. Importbestanden (Documents / JoyPro2) laad je zelf in de sim.

Code: engine\Games\MsfsIntegration.cs (één klasse voor beide sims), MsfsIntegration.UserProfiles.cs (het directe schrijven), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (lezen van Steam en Store), WgsContainers.cs (de Store-save), MsfsSimProfile.cs (de gegevens in profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (de regelgebaseerde editor), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.

  • Formaat: een XML-fragment (meerdere elementen op het hoogste niveau): <Version>, <FriendlyName>, <Device DeviceName GUID ProductID CompositeID HWVer> met <Axes> en <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>. Een 2024-profiel bevat elke actie van zijn contexten, niet-toegewezen acties als lege <Action/>. Codes: knop N = N-1, hat 256-259, L-as X/Y/Z 1026/1042/1058, R-as 770/786/802, schuifregelaars 514/530. Vlaggen: 2 digitaal, 4 as, 128 omkeren, 1024 geen gevoeligheidscurve, 4096 asafwijking per actie. Alleen gewijzigde <Action>-elementen worden opnieuw opgebouwd.
  • Apparaten: een profiel noemt zijn apparaat met de DirectInput-instance-GUID (GUID), dus om het te lezen hoeft er geen apparaat aangesloten te zijn. De sim koppelt een preset aan het USB-product-ID (hex): JoyPro gebruikt het ID dat de sim in profile_00 heeft genoteerd, anders de USB-PID (vJoy verschijnt als product-ID 0).
  • Welk profiel actief is: per apparaat en toestel hebben de records in profile_00 een General-slot en een categorieslot; een eigen profiel heet daar inputprofile_<n>, en dat is de Steam-bestandsnaam en de naam van de Store-container.
  • Store-opslag: wordt alleen geschreven als de index de bekende opbouw heeft (versie 14, geen conflictvlag, de container één keer vermeld in een bekende toestand); dan een nieuwe blob, container.<n+1>, de index als laatste (tijdelijk bestand en vervangen), teruglezen, en de oude generatie verwijderen. Bij elke fout wordt alles teruggezet; bij iets onbekends wordt niets geschreven en draagt het importbestand de toewijzingen.
  • Commandolijst: engine msfs2024 refresh-db leest de presets van Asobo, elk vluchtevent dat en-US.locPak noemt, je General-profielen en uitgepakte add-on-pakketten (Community, Marketplace) met hun toestellen; de toestellenlijst komt uit de inhoudslijst van de sim. Bij een nieuwe installatie wordt de lijst bij de eerste import gebouwd.
  • Commando's: 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 en --import-files als de twee vinkjes op de pagina Exporteren); relaties per toestel met engine relations aircraft set; ongedaan maken met engine backups restore; de gamebewaking met engine sync status en engine sync diff. De oude CLI-naam engine msfs ... betekent nog steeds MSFS 2024.

#Bekende beperkingen

  • Presetslots voor een specifiek toestel worden niet geschreven (die komen alleen met het eigen pakket van een toestel); JoyPro schrijft nooit profile_00 (het bestand eindigt met een checksum).
  • De preset van JoyPro bereikt alleen toestellen die de sim nog niet voor een apparaat heeft ingesteld; elders dragen je eigen profiel of een importbestand de toewijzingen.
  • Hoogstens twee inputcombinaties per actie; een derde wordt gemeld. Halve assen, diagonalen van een hat en een tweede hat worden niet gelezen of geschreven. Modifiers: alleen knoppen van hetzelfde apparaat.
  • Ingepakte add-on-pakketten (.fsarchive) worden overgeslagen; Store-opslagpaden langer dan 260 tekens worden niet gelezen.
  • Een cloudkopie (Steam Cloud, Xbox-cloud) kan het winnen van wat JoyPro schreef als een andere pc later heeft opgeslagen.
  • Tests: engine\tests\smoke\msfs.ps1, smoke\msfsuserprofiles.ps1, gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs (Steam- en Store-opslag, profielen per toestel, terugdraaien), MsfsStoreWatcherEndToEndTests; in de sim tools\e2e\games\Msfs2024Settings.ps1 (presets, assen, knoppen en de curve per actie in Controls).

Alle technische notities over deze game (gegenereerd uit de repository): msfs.md.