JoyPro2 Discord GitHub
Games

Microsoft Flight Simulator 2020

Tonen:

MSFS 2020 bewaart één bedieningsprofiel per apparaat, dat voor elk toestel wordt gebruikt. In de Steam-versie is elk profiel een klein XML-bestand in de map remote van de sim bij Steam; JoyPro leest deze bestanden in je profiel en schrijft je toewijzingen ter plekke terug. De profielen van de Microsoft Store-versie worden geïmporteerd, niet geschreven. Anders dan bij MSFS 2024 is er geen presetpakket, geen importbestand en geen profiel per toestel.

Microsoft Flight Simulator 2020 rechtstreeks (eigen toewijzingsbestanden)
Ondersteuning
rechtstreeks (eigen toewijzingsbestanden)
Engine-commando
engine msfs2020
Toewijzingsbestand
Steam userdata\<id>\1250410\remote\inputprofile_* (XML-fragment per apparaat)
Inputs die de game leest
leest 8 assen, 1 hat (4 richtingen) per joystick (gedocumenteerd)
Commandolijst uit
zoals MSFS 2024
In-game test
41/41 stappen geslaagd (2026-10-10)
  • ✓ 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: maak in de sim één keer een profiel voor elk apparaat (Settings > Controls). JoyPro schrijft alleen de Steam-versie; de Microsoft Store-versie kan alleen worden geïmporteerd.

Daarna: start de sim. Je toewijzingen staan in Settings > Controls, in elk toestel.

Heb je eerder knoppen toegewezen in MSFS 2020? 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 2020

  • Importeren: het profiel van elk aangesloten apparaat (Steam of Microsoft Store) komt in je profiel: vliegtoewijzingen, General-toewijzingen (camera's, zichten, pauze) en de asinstellingen van de pagina Sensitivity.
  • Relaties: één relatie is één functie. Een relatie geldt voor elk toestel, omdat MSFS 2020 één profiel per apparaat heeft.
  • Exporteren: JoyPro bewerkt de apparaatprofielen in de map remote van de Steam-versie. De sim leest ze bij de volgende start.

#Je MSFS 2020-toewijzingen importeren

  1. Open Start en druk op Importeren op de kaart van Microsoft Flight Simulator 2020.
  2. Ook apparaten importeren die niet aangesloten zijn (uit): MSFS bewaart de profielen van elk apparaat dat het ooit zag; uit betekent alleen de apparaten die nu zijn aangesloten. Ook standaardpresets importeren die de sim misschien niet gebruikt (uit) voegt de preset toe die de sim meelevert voor een apparaat zonder eigen profiel, ook als niet bekend is of de sim die gebruikt.
  3. Druk op Nu importeren, of op Eerst bekijken om te zien wat de sim heeft zonder je profiel te wijzigen.

#Relaties maken en controleren

Maak relaties op de pagina Relaties zoals voor elke game (zie de werkwijze voor relaties) en voer dan de controle uit op de pagina Exporteren. De controle meldt de throttle van een vliegtuig en de collective van een helikopter op één as hier niet als fout: MSFS 2020 heeft geen aparte toestellenlijsten.

#Exporteren naar MSFS 2020

  1. Sluit MSFS 2020. JoyPro weigert te schrijven zolang de sim draait.
  2. Open Exporteren, 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 2020.
  3. Start de sim. De map remote is een Steam Cloud-map, dus Steam synchroniseert de gewijzigde bestanden.
De pagina ExporterenDe pagina Exporteren
De pagina Exporteren (De afbeeldingen tonen de app in het Engels.)
In de game: Wat je ziet in MSFS 2020

Open Settings > Controls en kies je apparaat: je toewijzingen staan in het profiel van het apparaat onder de actienamen van de sim, en de pagina Sensitivity van het apparaat toont de ascurves die JoyPro schreef. Hetzelfde profiel wordt in elk toestel gebruikt.

#Wat je zelf doet in MSFS 2020

  • Maak in de sim één keer een profiel voor elk apparaat (Settings > Controls). JoyPro bewerkt alleen bestaande profielen; voor een apparaat zonder profiel zegt de export "maak er eerst een in de sim".
  • Microsoft Store-versie: JoyPro importeert je profielen, maar kan ze niet schrijven. Gebruik de Steam-versie voor de export, of stel de toewijzingen in de sim in.
  • Relaties beperkt tot toestellen: MSFS 2020 kan ze niet uit elkaar houden. In het formulier Andere games op de startpagina exporteert Toestel exporteren ook de relaties die tot één toestel zijn beperkt, voor elk toestel.

#Veelgemaakte fouten

  • "MSFS 2020 draait": sluit de sim en exporteer opnieuw.
  • De sim toont je oude toewijzingen: Steam Cloud heeft een oudere kopie teruggezet. Sluit de sim en exporteer opnieuw.
  • Een apparaat heeft meerdere profielen: JoyPro gebruikt het profiel dat met Gameprofiel in het formulier Andere games is gekozen, of het enige; anders wordt het apparaat overgeslagen met een waarschuwing die de namen noemt.
  • Een toewijzing ontbreekt: een actie bewaart hoogstens twee inputcombinaties (Primary en Secondary); een derde wordt gemeld en weggelaten.
Geavanceerd

#Bestanden die JoyPro leest en schrijft

Bestand Wat het is
<Steam>\userdata\<id>\1250410\remote\inputprofile_<n> één apparaatprofiel, XML zonder extensie; ter plekke geschreven (eerst back-up .jpbak)
<Steam>\userdata\<id>\1250410\remote\profile_00 de binaire index van de apparaatprofielen van de sim: alleen lezen, nooit geschreven
%LOCALAPPDATA%\Packages\Microsoft.FlightSimulator_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ de save van de Microsoft Store: alleen lezen (importeren en scannen)
<install>\Input\*.xml, de fs-base\en-US.locPak de presets die de sim meelevert en de menunamen: alleen lezen
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS de eigendomsgegevens en back-ups van JoyPro, nooit in de Steam-map

De Steam-map remote is een Steam Cloud-map. Alleen bestaande inputprofile_*-bestanden worden bewerkt: profile_00 van de sim noemt specifieke bestanden, dus een nieuw bestand zou niet worden opgepikt.

#De exportmodi in MSFS 2020

Modus Wat er in de apparaatprofielen gebeurt
Alleen toevoegen Een toewijzing wordt alleen geschreven waar het profiel geen andere actie op die inputcombinatie heeft; anders wordt hij vermeld onder "Binds Not Written, Button Taken In The Game". Er wordt niets verwijderd.
Bijwerken, toewijzingen van game behouden De andere actie op jouw combinatie verliest die; al het andere blijft, ook de oude combinatie van een actie.
Bijwerken, mijn profiel wint Zoals hierboven, en elke actie die je toewijst, verliest haar andere combinaties in de profielen van aangesloten apparaten.
Vervangen op mijn apparaten De profielen van de aangesloten apparaten die JoyPro toewijst, houden alleen jouw toewijzingen.
+ Ook mijn andere apparaten wissen De profielen van aangesloten apparaten zonder toewijzing in je profiel worden leeggemaakt.

#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.
  • Profielen van apparaten die niet zijn aangesloten, profile_00, de Store-save, de genegeerde apparaten van de import en het vJoy-apparaat waar JoyPro doorheen tunnelt.

#Curves en de rest

  • Granulariteit: één profiel per apparaat, voor elk toestel.
  • 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. MSFS 2020 heeft geen afwijking per actie: een relatie die er een vraagt, krijgt de apparaatpagina en een waarschuwing. Het curvevoorbeeld komt overeen met de sim (gemeten in MSFS 2020). Het afstembereik family:msfs geldt voor beide sims; zie axis-curves.
  • Force feedback: MSFS heeft geen eigen force feedback.
  • Telemetrie-opname: via SimConnect, alleen lezen, met de SimConnect.dll in de installatiemap van de sim (of die van de MSFS SDK; JoyPro levert er geen mee).
  • HUD: de HUD vindt de sim aan zijn proces (FlightSimulator) en toont de toewijzingen ervan.
  • Bewaking: JoyPro bewaakt de inputprofile_*-bestanden en containers.index van de Store-save en vraagt het nadat de sim is afgesloten (de gamebewaking).

#Wat anders is dan bij MSFS 2024

MSFS 2020 MSFS 2024
Exportdoel de Steam-profielen ter plekke je eigen profielen (Steam en Store), het presetpakket van JoyPro, importbestanden
Microsoft Store-versie alleen geïmporteerd geïmporteerd en geschreven
Profielen één per apparaat per apparaat en categorie, gekozen per toestel
Relaties beperkt tot toestellen alleen met Toestel exporteren (dan voor alle toestellen) geschreven in de profielen van die toestellen
Actielijst in een profiel alleen toegewezen acties elke actie van zijn contexten
Asafwijking per actie nee ja
Technische details

#Binnen in de MSFS 2020-koppeling

flowchart LR
  P["Je profiel<br/>(relaties + toewijzingen)"] --> E["engine msfs2020 export"]
  E --> R["Steam remote /<br/>inputprofile_n<br/>(één per apparaat)"]
  R --> C["Steam Cloud<br/>(volgende synchronisatie)"]
  R --> G["MSFS 2020:<br/>Settings > Controls"]
De Steam-versie. De Microsoft Store-versie: alleen importeren.

Code: engine\Games\MsfsIntegration.cs (één klasse voor beide sims, sim == 2020), MsfsProfileFile.cs (de regelgebaseerde editor), MsfsUserProfiles.cs (lezen van Steam en Store), MsfsSimDefaults.cs, MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.

  • Formaat: een XML-fragment (gelezen met fragment conformance): <Version>, <FriendlyName>, <Device DeviceName GUID ProductID>, <Axes> met <Axis AxisName AxisSensitivy AxisDeadZone ...> (de verkeerd gespelde attribuutnamen komen van de sim), <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>. Een vrijgegeven actie wordt verwijderd; een nieuwe actie gaat naar de context die ze in de andere profielen van de map heeft, anders naar haar catalogus-context, anders naar PLANE (met een waarschuwing).
  • Apparaten: GUID is de DirectInput-instance-GUID, dus voor het lezen is geen aangesloten apparaat nodig; ProductID is de decimale USB-product-ID. Codes: knop N = N-1, hat 256-259, assen 1026/1042/1058, 770/786/802, schuifregelaars 514/530; de laatste KEY van een combinatie is de hoofdinput, andere knoppen van hetzelfde apparaat zijn modifiers.
  • Commandolijst: engine msfs2020 refresh-db leest de presets van de sim (<install>\Input, de officiële pakketten) en elk vluchtevent dat en-US.locPak noemt; de lijst begint hetzelfde als die van MSFS 2024.
  • Commando's: engine msfs2020 paths, engine msfs2020 catalog, engine msfs2020 scan, engine msfs2020 import (--game-profile, --include-disconnected, --include-sim-defaults), engine msfs2020 export (--mode, --nuke-untouched-devices, --dry-run, --aircraft <key>); ongedaan maken met engine backups restore.
  • Oude profielen: profielen die zijn opgeslagen toen JoyPro één MSFS-game had (MSFS:<action>), krijgen bij het laden een node voor elke sim.

#Bekende beperkingen

  • De Microsoft Store-versie is alleen-lezen; een export met de savemap als pad wordt geweigerd.
  • Nieuwe inputprofile_*-bestanden worden niet aangemaakt; een apparaat heeft een profiel nodig dat in de sim is gemaakt.
  • Steam Cloud kan een ouder profiel terugzetten.
  • Halve assen, diagonalen van hats en een tweede hat worden niet gelezen of geschreven; maximaal twee combinaties per actie.
  • De meegeleverde presets van MSFS 2020 zijn niet op een echte installatie gecontroleerd, dus een 2020-preset moet ook de naam van het apparaat bevatten om als standaard te worden genomen.
  • Tests: engine\tests\smoke\msfs.ps1 (pagina Sensitivity, afwijkingen, vlaggen, conflicten, samenvoegen); in de sim tools\e2e\games\MsfsCurves.ps1 (toewijzingen, de pagina Sensitivity, knoppen en as-curves tijdens een vlucht, teruggelezen via SimConnect).

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