MSFS 2024 salva i tuoi comandi in profili, uno per dispositivo e categoria (Airplanes e General), e ricorda per ogni dispositivo e velivolo quale profilo usa. JoyPro legge questi profili in un suo unico profilo e riscrive le tue assegnazioni esattamente nei profili che il simulatore usa, nella versione Steam e in quella Microsoft Store. Per i velivoli che il simulatore non ha ancora configurato per un dispositivo, JoyPro aggiunge i suoi preset come piccolo pacchetto nella cartella Community2024 del simulatore, e dove non può scrivere un profilo ti lascia un file da importare nel menu Controls del simulatore.
Microsoft Flight Simulator 2024 nativo (i suoi file di assegnazioni)
- Supporto
- nativo (i suoi file di assegnazioni)
- Comando del motore
engine msfs2024- File di assegnazioni
- il tuo profilo che il simulatore usa per dispositivo e categoria (XML Steam
remote\inputprofile_*o il salvataggio del Microsoft Store,--user-profiles) + il pacchetto Community di JoyPro (joypro-input-profiles, un XML di preset per dispositivo); file di importazione inDocuments\JoyPro2\MSFS 2024 import filesdove il tuo profilo non può essere scritto - Input che il gioco legge
- legge 8 assi, 1 hat (4 direzioni) per joystick (documentato)
- Elenco comandi da
- i file di preset di Asobo, gli eventi di volo nominati da
fs-base\en-US.locPak, i velivoli installati - Test nel gioco
- 26/26 passi superati (2026-10-11)
- ✓ Importa
- ✓ Esporta
- ✗ Assegnazioni da tastiera
- ◐ ModificatoriMSFS: solo pulsanti modificatori dello stesso dispositivo.
- ✓ Elenco comandi creato sul tuo PC
- ✓ Monitoraggio giochi
- ✓ Curve degli assi e zone morte
- ✗ Impostazioni dei comandi del gioco
- ✗ Impostazioni del force feedback nel gioco
- ✗ Force feedback dalla telemetria
- ✓ Registrazione della telemetria
- ✓ Joystick virtuale (vJoy)
- ◐ Pad Xbox virtuale
- ✓ Funzioni virtuali
- ✓ Configurazione guidata / Assegnazione automatica
- ✓ Cockpits
- ✓ Schede riepilogo
- ✓ Test nel gioco
Dalla matrice di supporto, generata dal codice del motore: tutti i giochi.
#Funziona in 3 passi
- Configura tutto per me
nella pagina Start - Usa questi pulsanti
prima guarda l'elenco - Scrivi nel mio gioco
tieni chiuso il simulatore
Prima: collega ogni dispositivo una volta.
Poi: leggi il riquadro I tuoi profili MSFS 2024. Nomina un file di importazione? Allora importa quel file nel simulatore (vedi Cosa fai tu qui sotto).
Avevi già assegnato dei pulsanti in MSFS 2024? Allora la pagina Start ti offre Importa, poi riempi i vuoti. Le tue assegnazioni restano, e solo i pulsanti liberi ricevono nuovi compiti. Vedi Avvio rapido: far funzionare la mia cloche.
#Cosa fa JoyPro per MSFS 2024
- Importa: i profili che hai creato nel menu Controls del simulatore (Steam o Microsoft Store) entrano nel tuo profilo, assegnazioni di volo e assegnazioni General (telecamere, visuali, pausa attiva e così via), con le impostazioni degli assi della pagina Sensitivity. Un dispositivo che non hai mai cambiato nel simulatore porta il preset che il simulatore fornisce per esso, quando i registri del simulatore mostrano che usa quel preset.
- Relazioni: una relazione è una funzione. In MSFS 2024 una relazione può valere per tutti i velivoli (l'impostazione predefinita) o solo per i velivoli che spunti, come in DCS.
- Esporta: JoyPro scrive le tue assegnazioni nel profilo che il simulatore usa per ogni dispositivo e categoria, scrive il suo pacchetto di preset per i velivoli che il simulatore non ha ancora configurato, e scrive un file di importazione dove non ha potuto aggiornare il tuo profilo.
#Importa le tue assegnazioni di MSFS 2024
- Apri Avvia e premi Importa sulla scheda di Microsoft Flight Simulator 2024.
- Per MSFS contano due opzioni, entrambe disattivate se non le spunti:
- Importa anche i dispositivi non collegati: MSFS tiene le assegnazioni di ogni dispositivo che ha mai visto. Disattivato: solo i dispositivi collegati ora.
- Importa anche i preset predefiniti che il simulatore potrebbe non usare: per i dispositivi per cui i registri del simulatore non mostrano l'uso di un preset fornito. Questo può aggiungere assegnazioni che il simulatore non ha.
- Premi Importa ora (oppure Guarda prima per vedere cosa ha il simulatore senza cambiare il tuo profilo).
Le relazioni importate valgono per tutti i velivoli. Quando un'assegnazione esiste solo nei profili di alcuni velivoli, dopo l'importazione la pagina Relazioni mostra una nota con Limita a questi velivoli per ogni relazione, Limita tutte e Mantieni per tutti i velivoli.


#Crea e verifica le relazioni
Nella pagina Relazioni un'azione di MSFS 2024 mostra i velivoli del simulatore con le spunte: tutti i velivoli spuntati significa tutti i velivoli. Un'azione che esiste solo in alcuni velivoli add-on dice "solo per:" con quei velivoli, e aggiungerla spunta solo quelli. Vedi il flusso delle relazioni, poi esegui la Verifica nella pagina Esporta: trova un pulsante con due funzioni prima che lo faccia il simulatore.
#Esportare in MSFS 2024
- Chiudi MSFS 2024. JoyPro si rifiuta di scrivere mentre il simulatore è in esecuzione (nella versione Microsoft Store anche mentre è in esecuzione il suo aiutante di avvio).
- Apri Esporta. In Esporta nei giochi due spunte sono per MSFS 2024:
- MSFS 2024: scrivi nei miei profili MSFS (attivato): l'esportazione aggiorna il profilo che il simulatore usa per ogni dispositivo e categoria, dopo averne fatto il backup.
- MSFS 2024: file di importazione per ogni dispositivo (disattivato): un file di importazione per ogni dispositivo e categoria, non solo dove JoyPro non ha potuto scrivere il tuo profilo.
- Lascia Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi se configuri i tuoi dispositivi in JoyPro, e premi Esporta ora sulla scheda di MSFS 2024.
Dopo l'esportazione il riquadro I tuoi profili MSFS 2024 elenca ogni profilo scritto da JoyPro, con i suoi velivoli e il numero di assegnazioni. Se sono stati scritti file di importazione, un secondo riquadro li nomina con Apri cartella.


Avvia il simulatore e apri Settings > Controls, poi scegli il tuo dispositivo e la categoria (Airplanes o General). Le tue assegnazioni sono nel tuo profilo, sotto i nomi delle azioni del simulatore; la pagina del dispositivo (Hardware Settings nell'ingranaggio del dispositivo) mostra le curve degli assi scritte da JoyPro. In un velivolo che il simulatore non ha ancora configurato per quel dispositivo, il dispositivo parte con il preset di JoyPro.
#Cosa fai tu in MSFS 2024
- Niente, per ogni profilo elencato come aggiornato in I tuoi profili MSFS 2024.
- File di importazione: quando l'esportazione ne elenca uno, apri Settings > Controls, scegli il dispositivo e la categoria (Airplanes o General), fai clic sull'ingranaggio del profilo (non su quello del preset), scegli Import e seleziona il file che JoyPro ha scritto per quel dispositivo e quella categoria. Il simulatore accetta un file solo per lo stesso dispositivo e la stessa categoria. Quando il file porta il nome del tuo profilo, il simulatore chiede se sovrascriverlo: conferma, e il tuo profilo ha le assegnazioni di JoyPro. Importa di nuovo un file solo quando l'esportazione dice che è nuovo o cambiato.
- Collega ogni dispositivo una volta prima della prima esportazione: JoyPro ha bisogno del product ID del dispositivo per il suo preset.
- Un velivolo ha bisogno di assegnazioni diverse dagli altri: dagli un suo profilo nel simulatore (Controls, con quel velivolo caricato: duplica il profilo), poi esporta di nuovo. L'esportazione nomina ogni relazione che non ha potuto collocare.
- Domanda sul cloud Xbox: se il simulatore o l'app Xbox chiede quale salvataggio tenere, tieni quello di questo PC; l'altro perde le assegnazioni di JoyPro (in quel caso esporta di nuovo).
#Errori frequenti
- "MSFS 2024 è in esecuzione": chiudi il simulatore; nella versione Microsoft Store deve essere chiuso anche l'aiutante di avvio del simulatore (
gamelaunchhelper.exe). - Mancano assegnazioni in un velivolo: quel velivolo usa un altro dei tuoi profili. Controlla l'elenco I tuoi profili MSFS 2024; una riga con "file di importazione" significa che devi importare quel file nel simulatore.
- Una relazione non è stata scritta: è limitata ad alcuni velivoli, ma il profilo che il simulatore usa lì è condiviso con altri velivoli. L'avviso nomina il profilo e i velivoli.
- Un dispositivo ha più profili: l'importazione prende quello nominato nei registri del simulatore, altrimenti il più recente, e nomina gli altri. Scegline un altro con Profilo del gioco nel modulo Altri giochi della pagina Start.
- "WRONG DEVICE" mentre assegni nel simulatore: un dispositivo che continua a inviare valori (alcune cloche force feedback) si prende la scansione del simulatore. Succede nell'assegnazione del simulatore stesso, non in JoyPro.
- Reset to Defaults nel simulatore ripristina i preset di ogni dispositivo e velivolo; JoyPro non lo fa mai al posto tuo.
#File che JoyPro legge e scrive
| File | Di cosa si tratta |
|---|---|
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> |
il tuo profilo (Steam), XML semplice senza estensione; scritto sul posto, Steam Cloud lo carica alla prossima sincronizzazione |
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ |
il salvataggio Microsoft Store (containers.index, container.<n>, un blob per profilo); JoyPro scrive un nuovo blob, un nuovo file container e l'indice |
remote\profile_00 (Store: il container profile_00) |
i record dei dispositivi del simulatore: quale profilo o preset usa ogni dispositivo per ogni velivolo. Solo lettura, mai scritti |
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml |
Il preset di JoyPro per un dispositivo (azioni di volo), con layout.json e manifest.json |
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml |
Il preset di JoyPro per le assegnazioni General di un dispositivo |
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml |
i file di importazione, nel formato di profilo del simulatore stesso |
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak |
i preset forniti da Asobo e i nomi dei menu: solo lettura, per l'elenco comandi e i preset predefiniti |
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS |
i dati di proprietà e i backup di JoyPro, mai in una cartella sincronizzata |
<packages> è InstalledPackagesPath di %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Prima di ogni scrittura l'intera cartella di salvataggio dello Store o il file Steam finisce nel set di backup, così Annulla ultima esportazione rimette a posto il salvataggio.
#Le modalità di esportazione in MSFS 2024
Le modalità lavorano per profilo (quindi per gruppo di velivoli) e solo nei contesti gestiti.
| Modalità | Cosa succede nei tuoi profili MSFS 2024 |
|---|---|
| Aggiungi soltanto | Un'assegnazione viene scritta solo dove nessun'altra azione di quel profilo usa la combinazione di input; altrimenti viene elencata come non scritta. Non viene rimosso nulla. |
| Aggiorna, mantieni le assegnazioni del gioco | L'altra azione sulla tua combinazione di input la perde; tutto il resto rimane, anche la vecchia combinazione di un'azione (un'azione ne ha due: Primary e Secondary). |
| Aggiorna, prevale il mio profilo | Come sopra, e ogni azione che assegni perde le sue altre combinazioni, anche nei profili di altri dispositivi collegati (vengono scritti anche quei profili). |
| Sostituisci sui miei dispositivi | I profili dei dispositivi collegati che JoyPro scrive mantengono solo le tue assegnazioni. |
| + Cancella anche gli altri miei dispositivi | Non svuota mai uno dei tuoi profili MSFS 2024. |
Una relazione per tutti i velivoli va in ogni profilo nominato dai record del simulatore; una relazione limitata a certi velivoli va solo nei profili i cui velivoli sono tutti spuntati. Le relazioni limitate non vanno mai nel pacchetto di preset né nei file di importazione, perché questi valgono per tutti i velivoli.
#Cosa non viene mai toccato
- I contesti di menu, mappa del mondo e sviluppatore (
MENU,MENU_*,WORLDMAP_*,DEBUG,DEVMODE*,EDITOR_*,MISSION_FLOW_TOOLS), in ogni modalità. - Profili di tastiera, mouse e gamepad (
GUID="{0}"): in MSFS le assegnazioni da tastiera non vengono scritte. profile_00, i preset forniti da Asobo, gli slot di preset specifici per velivolo e ogni altro container del salvataggio dello Store (diari di volo, altri titoli).- Dispositivi non collegati, i dispositivi ignorati dall'importazione e il dispositivo vJoy in cui JoyPro inoltra i comandi.
#Velivoli, curve, il resto
- Granularità: per dispositivo e categoria (Airplanes, General) e per profilo; il simulatore sceglie il profilo per dispositivo e velivolo, JoyPro segue quella scelta.
- Curve degli assi: la pagina Sensitivity del dispositivo, un insieme per asse fisico: Sensitivity + e -, Neutral, Dead zone, Extremity dead zone, Reactivity, il flag senza curva e l'inversione. Una relazione può dare a un'azione i propri valori (la sostituzione per azione di MSFS 2024). Le relazioni sullo stesso asse del dispositivo condividono la sua pagina: l'esportazione scrive i valori della prima relazione e avvisa. Vedi axis-curves.
- Force feedback: MSFS non ne ha uno proprio.
- Registrazione della telemetria: tramite SimConnect, in sola lettura, con una tua
SimConnect.dll(JoyPro non ne include nessuna): la versione Steam di MSFS 2024 non ne ha, quindi installa l'SDK di MSFS 2024 oppure tieni installato MSFS 2020 (funziona anche la sua copia). - HUD: l'HUD trova il simulatore dal suo processo e mostra le sue assegnazioni.
- Monitoraggio: JoyPro monitora il suo pacchetto, i profili Steam e il
containers.indexdel salvataggio dello Store; dopo la chiusura del simulatore (il salvataggio dello Store attende 10 s dopo la sua ultima scrittura) chiede se riprendere le modifiche che hai fatto nel gioco (il monitoraggio). - Reimportazione: nomi delle relazioni, gruppi e regolazioni tornano tramite i metadati di JoyPro accanto ai file (reimportazione).
- Opzioni per esperti (Altri giochi nella pagina Start): Profilo del gioco (scegli un profilo quando un dispositivo ne ha diversi), Velivolo da esportare (esporta anche le relazioni limitate a un velivolo, per tutti i velivoli), Scrivi nei miei profili MSFS, Scrivi anche file di importazione MSFS per ogni dispositivo, una prova senza scrittura.
#Dentro l'integrazione di MSFS 2024
flowchart LR P["Il tuo profilo"] --> E["engine msfs2024 export"] E --> U["I tuoi<br/>profili"] E --> K["Preset di<br/>JoyPro"] E --> F["File di importazione"] F --> I["Tu: ingranaggio,<br/>Import"] U --> S["Settings ><br/>Controls"] K --> S I --> S
Codice: engine\Games\MsfsIntegration.cs (una classe per entrambi i simulatori), MsfsIntegration.UserProfiles.cs (la scrittura diretta), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (lettura di Steam e Store), WgsContainers.cs (il salvataggio dello Store), MsfsSimProfile.cs (i record in profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (l'editor a righe), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.
- Formato: un frammento XML (più elementi di primo livello):
<Version>,<FriendlyName>,<Device DeviceName GUID ProductID CompositeID HWVer>con<Axes>e<Context ContextName>/<Action ActionName Flag>/<Primary>/<Secondary>/<KEY Information>code</KEY>. Un profilo 2024 elenca ogni azione dei suoi contesti, quelle non assegnate come<Action/>vuoti. Codici: pulsante N = N-1, hat 256-259, asse L X/Y/Z 1026/1042/1058, asse R 770/786/802, slider 514/530. Flag: 2 digitale, 4 asse, 128 inversione, 1024 senza curva di sensibilità, 4096 sostituzione dell'asse per azione. Solo gli elementi<Action>cambiati vengono generati di nuovo. - Dispositivi: un profilo indica il suo dispositivo con il GUID d'istanza DirectInput (
GUID), quindi per leggerlo non serve nessun dispositivo collegato. Il simulatore abbina un preset tramite l'ID prodotto USB (esadecimale): JoyPro usa quello che il simulatore ha annotato inprofile_00, altrimenti il PID USB (vJoy appare con ID prodotto 0). - Quale profilo è attivo: per ogni dispositivo e velivolo i record in
profile_00contengono uno slot General e uno slot di categoria; un profilo tuo lì èinputprofile_<n>, che è il nome del file Steam e il nome del contenitore Store. - Salvataggio Store: scritto solo quando l'indice ha il layout noto (versione 14, nessun flag di conflitto, il contenitore elencato una sola volta in uno stato noto); poi un nuovo blob,
container.<n+1>, l'indice per ultimo (file temporaneo e sostituzione), riletto, e la vecchia generazione rimossa. Qualsiasi errore rimette tutto com'era; qualsiasi cosa sconosciuta non scrive niente e il file di importazione porta le assegnazioni. - Elenco comandi:
engine msfs2024 refresh-dblegge i preset di Asobo, ogni flight event nominato daen-US.locPak, i tuoi profili General e i pacchetti add-on non compressi (Community, Marketplace) con i loro velivoli; l'elenco dei velivoli viene dall'elenco dei contenuti del simulatore. Un'installazione nuova crea l'elenco alla prima importazione. - Comandi:
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 falsee--import-filescome le due spunte della pagina Esporta); relazioni per velivolo conengine relations aircraft set; Annulla conengine backups restore; il monitoraggio conengine sync statuseengine sync diff. Il vecchio nome CLIengine msfs ...indica ancora MSFS 2024.
#Limiti noti
- Gli slot dei preset specifici per velivolo non vengono scritti (arrivano solo con il pacchetto del velivolo stesso); JoyPro non scrive mai
profile_00(il file finisce con un checksum). - Il preset di JoyPro raggiunge solo i velivoli che il simulatore non ha ancora configurato per un dispositivo; altrove il tuo profilo o un file di importazione porta le assegnazioni.
- Al massimo due combinazioni di input per azione; una terza viene segnalata. Mezzi assi, diagonali degli hat e un secondo hat non vengono letti né scritti. Modificatori: solo pulsanti dello stesso dispositivo.
- I pacchetti add-on compressi (
.fsarchive) vengono saltati; i percorsi di salvataggio Store oltre i 260 caratteri non vengono letti. - Una copia nel cloud (Steam Cloud, cloud Xbox) può prevalere sulla scrittura di JoyPro se un altro PC ha salvato dopo.
- Test:
engine\tests\smoke\msfs.ps1,smoke\msfsuserprofiles.ps1,gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs(salvataggi Steam e Store, profili per velivolo, ripristino),MsfsStoreWatcherEndToEndTests; nel simulatoretools\e2e\games\Msfs2024Settings.ps1(preset, assi, pulsanti e la curva per azione in Controls).
Tutte le note tecniche su questo gioco (generate dal repository): msfs.md.