O MSFS 2024 guarda os seus controlos em perfis, um por dispositivo e categoria (Airplanes e General), e lembra-se, para cada dispositivo e aeronave, de que perfil usa. O JoyPro lê estes perfis para um perfil próprio e escreve as suas atribuições de volta exatamente nos perfis que o simulador usa, na versão Steam e na versão Microsoft Store. Para aeronaves que o simulador ainda não configurou para um dispositivo, o JoyPro adiciona as suas próprias predefinições como um pequeno pacote na pasta Community2024 do simulador, e onde não consegue escrever um perfil deixa-lhe um ficheiro para importar no menu Controls do simulador.
Microsoft Flight Simulator 2024 nativo (os seus próprios ficheiros de atribuições)
- Suporte
- nativo (os seus próprios ficheiros de atribuições)
- Comando do motor
engine msfs2024- Ficheiro de atribuições
- o seu próprio perfil que o simulador usa por dispositivo e categoria (XML Steam
remote\inputprofile_*ou o save da Microsoft Store,--user-profiles) + o pacote Community do JoyPro (joypro-input-profiles, um XML de preset por dispositivo); ficheiros de importação emDocuments\JoyPro2\MSFS 2024 import filesonde o seu perfil não pode ser escrito - Entradas que o jogo lê
- lê 8 eixos, 1 hat (4 direções) por joystick (documentado)
- Lista de comandos a partir de
- os ficheiros de preset da Asobo, os eventos de voo que
fs-base\en-US.locPaknomeia, as aeronaves instaladas - Teste no jogo
- 26/26 passos concluídos (2026-10-11)
- ✓ Importar
- ✓ Exportar
- ✗ Atribuições de teclado
- ◐ ModificadoresMSFS: só botões modificadores do mesmo dispositivo.
- ✓ Lista de comandos criada no seu PC
- ✓ Monitor de jogos
- ✓ Curvas de eixo e zonas mortas
- ✗ Configurações de controlo do jogo
- ✗ Configurações de force feedback no jogo
- ✗ Force feedback a partir da telemetria
- ✓ Gravação de telemetria
- ✓ Joystick virtual (vJoy)
- ◐ Comando Xbox virtual
- ✓ Funções virtuais
- ✓ Assistente de configuração / Atribuição automática
- ✓ Cockpits
- ✓ Folhas de referência
- ✓ Teste no jogo
Da matriz de suporte, gerada a partir do código do motor: todos os jogos.
#Pôr a funcionar em 3 passos
- Configurar tudo por mim
na página Início - Usar estes botões
veja primeiro a lista - Escrever no meu jogo
com o simulador fechado
Antes: ligue cada dispositivo uma vez.
Depois: leia a caixa Os seus perfis do MSFS 2024. Nomeia um ficheiro de importação? Então importe esse ficheiro no simulador (veja O que faz você mesmo abaixo).
Já atribuiu botões no MSFS 2024 antes? Então a página Início oferece Importar e depois preencher lacunas. As suas atribuições ficam, e só os botões livres recebem novas funções. Veja Início rápido: pôr o meu manche a funcionar.
#O que o JoyPro faz pelo MSFS 2024
- Importar: os perfis que criou no menu Controls do simulador (Steam ou Microsoft Store) entram no seu perfil, atribuições de voo e atribuições General (câmaras, vistas, pausa ativa e assim por diante), com as configurações de eixo da página Sensitivity. Um dispositivo que nunca alterou no simulador traz a predefinição que o simulador inclui para ele, quando os próprios registos do simulador mostram que usa essa predefinição.
- Relações: uma relação é uma função. No MSFS 2024, uma relação pode ser para todas as aeronaves (a predefinição) ou só para as aeronaves que marcar, como no DCS.
- Exportar: o JoyPro escreve as suas atribuições no perfil que o simulador usa para cada dispositivo e categoria, escreve o seu pacote de predefinições para as aeronaves que o simulador ainda não configurou, e escreve um ficheiro de importação onde não conseguiu atualizar o seu perfil.
#Importar as suas atribuições do MSFS 2024
- Abra Iniciar e prima Importar no cartão do Microsoft Flight Simulator 2024.
- Duas opções contam para o MSFS, ambas desligadas a não ser que as marque:
- Importar também dispositivos que não estão ligados: o MSFS guarda as atribuições de todos os dispositivos que alguma vez viu. Desligado: só os dispositivos ligados agora.
- Importar também predefinições padrão que o simulador pode não usar: para dispositivos em que os registos do simulador não mostram o uso de uma predefinição incluída. Isto pode adicionar atribuições que o simulador não tem.
- Prima Importar agora (ou Ver primeiro para ver o que o simulador tem sem alterar o seu perfil).
As relações importadas aplicam-se a todas as aeronaves. Quando uma atribuição só existe nos perfis de algumas aeronaves, a página Relações mostra uma nota depois da importação com Limitar a estas aeronaves por relação, Limitar todas e Manter para todas as aeronaves.


#Criar e verificar relações
Na página Relações, uma ação do MSFS 2024 mostra as aeronaves do simulador com marcas de verificação: todas as aeronaves marcadas significa todas as aeronaves. Uma ação que só existe em algumas aeronaves add-on diz "só para:" com essas aeronaves, e adicioná-la marca só essas. Veja o fluxo das relações e depois execute a Verificação na página Exportar: encontra um botão com duas funções antes de o simulador o fazer.
#Exportar para o MSFS 2024
- Feche o MSFS 2024. O JoyPro recusa escrever enquanto o simulador está a correr (na versão Microsoft Store, também enquanto o seu auxiliar de arranque estiver a correr).
- Abra Exportar. Em Exportar para os jogos, duas caixas são para o MSFS 2024:
- MSFS 2024: escrever nos meus perfis do MSFS (ligado): a exportação atualiza o perfil que o simulador usa para cada dispositivo e categoria, com backup primeiro.
- MSFS 2024: ficheiros de importação para cada dispositivo (desligado): um ficheiro de importação para cada dispositivo e categoria, não só onde o JoyPro não conseguiu escrever o seu perfil.
- Mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus dispositivos, e prima Exportar agora no cartão do MSFS 2024.
Depois da exportação, a caixa Os seus perfis do MSFS 2024 lista todos os perfis que o JoyPro escreveu, com as suas aeronaves e o número de atribuições. Quando foram escritos ficheiros de importação, uma segunda caixa nomeia-os com Abrir pasta.


Inicie o simulador e abra Settings > Controls, depois escolha o seu dispositivo e a categoria (Airplanes ou General). As suas atribuições estão no seu próprio perfil, com os nomes de ações do simulador; a página do dispositivo (Hardware Settings na roda dentada do dispositivo) mostra as curvas de eixo que o JoyPro escreveu. Numa aeronave que o simulador ainda não configurou para esse dispositivo, o dispositivo começa com a predefinição do JoyPro.
#O que faz você mesmo no MSFS 2024
- Nada, para cada perfil listado como atualizado em Os seus perfis do MSFS 2024.
- Ficheiros de importação: quando a exportação listar um, abra Settings > Controls, escolha o dispositivo e a categoria (Airplanes ou General), clique na roda dentada do perfil (não na da predefinição), escolha Import e selecione o ficheiro que o JoyPro escreveu para esse dispositivo e categoria. O simulador só aceita um ficheiro para o mesmo dispositivo e categoria. Quando o ficheiro tem o nome do seu perfil, o simulador pergunta se o deve sobrescrever: confirme, e o seu perfil fica com as atribuições do JoyPro. Importe um ficheiro outra vez só quando a exportação disser que é novo ou foi alterado.
- Ligue cada dispositivo uma vez antes da primeira exportação: o JoyPro precisa do ID de produto do dispositivo para a sua predefinição.
- Uma aeronave precisa de atribuições diferentes das outras: dê-lhe um perfil próprio no simulador (Controls, com essa aeronave carregada: duplique o perfil) e depois exporte outra vez. A exportação nomeia cada relação que não conseguiu colocar.
- Pergunta da nuvem Xbox: se o simulador ou a app Xbox perguntar que gravação manter, mantenha a deste PC; a outra descarta as atribuições do JoyPro (nesse caso, exporte outra vez).
#Erros comuns
- "O MSFS 2024 está a correr": feche o simulador; na versão Microsoft Store, o auxiliar de arranque do simulador (
gamelaunchhelper.exe) também tem de ter terminado. - Faltam atribuições numa aeronave: essa aeronave usa outro perfil seu. Verifique a lista Os seus perfis do MSFS 2024; uma linha com "ficheiro de importação" significa que importa esse ficheiro no simulador.
- Uma relação não foi escrita: está limitada a algumas aeronaves, mas o perfil que o simulador usa aí é partilhado com outras aeronaves. O aviso nomeia o perfil e as aeronaves.
- Um dispositivo tem vários perfis: a importação usa o que os registos do simulador nomeiam, senão o mais recente, e nomeia os outros. Escolha outro com Perfil do jogo no formulário Outros jogos da página Início.
- "WRONG DEVICE" ao atribuir no simulador: um dispositivo que envia valores sem parar (alguns manches com force feedback) fica com a deteção do simulador. Isto acontece na atribuição do próprio simulador, não no JoyPro.
- Reset to Defaults no simulador repõe as predefinições de todos os dispositivos e aeronaves; o JoyPro nunca o faz por si.
#Ficheiros que o JoyPro lê e escreve
| Ficheiro | O que é |
|---|---|
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> |
o seu próprio perfil (Steam), XML simples sem extensão; escrito no próprio sítio, a Steam Cloud carrega-o na próxima sincronização |
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ |
a gravação da Microsoft Store (containers.index, container.<n>, um blob por perfil); o JoyPro escreve um blob novo, um ficheiro de contentor novo e o índice |
remote\profile_00 (Store: o contentor profile_00) |
os registos de dispositivos do simulador: que perfil ou predefinição cada dispositivo usa por aeronave. Só leitura, nunca escritos |
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml |
A predefinição do JoyPro para um dispositivo (ações de voo), com layout.json e manifest.json |
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml |
A predefinição do JoyPro para as atribuições General de um dispositivo |
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml |
os ficheiros de importação, no próprio formato de perfil do simulador |
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak |
as predefinições que a Asobo inclui e os nomes de menu: só leitura, para a lista de comandos e as predefinições padrão |
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS |
os dados de propriedade e os backups do JoyPro, nunca numa pasta sincronizada |
<packages> é o InstalledPackagesPath de %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Antes de cada escrita, toda a pasta de gravação da Store ou o ficheiro Steam vai para o conjunto de backups, por isso Desfazer última exportação repõe a gravação.
#Os modos de exportação no MSFS 2024
Os modos trabalham por perfil (portanto por grupo de aeronaves) e só nos contextos geridos.
| Modo | O que acontece nos seus perfis do MSFS 2024 |
|---|---|
| Só adicionar | Uma atribuição só é escrita onde nenhuma outra ação desse perfil usa a combinação de entradas; caso contrário é listada como não escrita. Nada é removido. |
| Atualizar, manter atribuições do jogo | A outra ação na sua combinação de entradas perde-a; tudo o resto fica, também a combinação antiga de uma ação (uma ação tem duas: Primary e Secondary). |
| Atualizar, o meu perfil ganha | Como acima, e cada ação que atribui perde as suas outras combinações, também nos perfis de outros dispositivos ligados (esses perfis também são escritos). |
| Substituir nos meus dispositivos | Os perfis dos dispositivos ligados que o JoyPro escreve ficam só com as suas atribuições. |
| + Limpar também os meus outros dispositivos | Nunca limpa um dos seus próprios perfis do MSFS 2024. |
Uma relação para todas as aeronaves vai para todos os perfis que os registos do simulador nomeiam; uma relação limitada a aeronaves só vai para os perfis cujas aeronaves estão todas marcadas. As relações limitadas nunca vão para o pacote de predefinições nem para os ficheiros de importação, porque esses se aplicam a todas as aeronaves.
#O que nunca é tocado
- Os contextos de menu, mapa do mundo e programador (
MENU,MENU_*,WORLDMAP_*,DEBUG,DEVMODE*,EDITOR_*,MISSION_FLOW_TOOLS), em todos os modos. - Os perfis de teclado, rato e comando (
GUID="{0}"): as atribuições de teclado não são escritas no MSFS. - O
profile_00, as predefinições que a Asobo inclui, as posições de predefinição específicas de aeronaves e todos os outros contentores da gravação da Store (diários de bordo, outros títulos). - Os dispositivos que não estão ligados, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
#Aeronaves, curvas, o resto
- Granularidade: por dispositivo e categoria (Airplanes, General) e por perfil; o simulador escolhe o perfil por dispositivo e aeronave, e o JoyPro segue essa escolha.
- Curvas de eixo: a página Sensitivity do dispositivo, um conjunto por eixo físico: Sensitivity + e -, Neutral, Dead zone, Extremity dead zone, Reactivity, a opção sem curva e a inversão. Uma relação pode dar a uma ação os seus próprios valores (a substituição por ação do MSFS 2024). As relações no mesmo eixo de dispositivo partilham a sua página: a exportação escreve os valores da primeira relação e avisa. Veja axis-curves.
- Force feedback: o MSFS não tem nenhum próprio.
- Gravação de telemetria: através do SimConnect, só leitura, com o seu próprio
SimConnect.dll(o JoyPro não traz nenhum): a versão Steam do MSFS 2024 não tem nenhum, por isso instale o MSFS 2024 SDK ou tenha o MSFS 2020 instalado (a cópia dele também funciona). - HUD: o HUD encontra o simulador pelo seu processo e mostra as suas atribuições.
- Monitor de jogos: o JoyPro monitoriza o seu pacote, os perfis da Steam e o
containers.indexda gravação da Store; depois de o simulador fechar (a gravação da Store espera 10 s após a sua última escrita), pergunta se deve adotar as alterações que fez no jogo (o monitor de jogos). - Reimportação: os nomes das relações, os grupos e os ajustes voltam através dos metadados do JoyPro ao lado dos ficheiros (reimportação).
- Opções avançadas (Outros jogos na página Início): Perfil do jogo (escolha um perfil quando um dispositivo tem vários), Aeronave a exportar (exporta também as relações limitadas a uma aeronave, para todas as aeronaves), Escrever nos meus perfis do MSFS, Escrever também ficheiros de importação do MSFS para cada dispositivo, uma execução de teste.
#Por dentro da integração do MSFS 2024
flowchart LR P["O seu perfil"] --> E["engine msfs2024 export"] E --> U["Os seus próprios<br/>perfis"] E --> K["Predefinições<br/>do JoyPro"] E --> F["Ficheiros de importação"] F --> I["Por si: roda dentada,<br/>Import"] U --> S["Settings ><br/>Controls"] K --> S I --> S
Código: engine\Games\MsfsIntegration.cs (uma classe para os dois simuladores), MsfsIntegration.UserProfiles.cs (a escrita direta), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (leitura Steam e Store), WgsContainers.cs (a gravação da Store), MsfsSimProfile.cs (os registos em profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (o editor por linhas), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.
- Formato: um fragmento XML (vários elementos de topo):
<Version>,<FriendlyName>,<Device DeviceName GUID ProductID CompositeID HWVer>com<Axes>e<Context ContextName>/<Action ActionName Flag>/<Primary>/<Secondary>/<KEY Information>code</KEY>. Um perfil de 2024 lista todas as ações dos seus contextos, as não atribuídas como<Action/>vazio. Códigos: botão N = N-1, hat 256-259, eixo L X/Y/Z 1026/1042/1058, eixo R 770/786/802, sliders 514/530. Opções: 2 digital, 4 eixo, 128 inverter, 1024 sem curva de sensibilidade, 4096 substituição de eixo por ação. Só os elementos<Action>alterados são escritos de novo. - Dispositivos: um perfil identifica o seu dispositivo pelo GUID de instância DirectInput (
GUID), por isso não é preciso nenhum dispositivo ligado para o ler. O simulador associa uma predefinição pelo ID de produto USB (hex): o JoyPro usa o que o simulador anotou emprofile_00, senão o PID USB (o vJoy aparece como ID de produto 0). - Que perfil está ativo: por dispositivo e aeronave, os registos em
profile_00têm um espaço General e um espaço de categoria; um perfil próprio aí éinputprofile_<n>, que é o nome do ficheiro no Steam e o nome do contentor na Store. - Gravação da Store: só é escrita quando o índice tem o layout conhecido (versão 14, sem marca de conflito, o contentor listado uma vez num estado conhecido); depois um novo blob,
container.<n+1>, o índice por último (ficheiro temporário e substituição), lido de volta, e a geração antiga removida. Qualquer falha repõe tudo; algo desconhecido não escreve nada e o ficheiro de importação leva as atribuições. - Lista de comandos:
engine msfs2024 refresh-dblê as predefinições da Asobo, todos os eventos de voo queen-US.locPaknomeia, os seus perfis General e os pacotes de add-ons não compactados (Community, Marketplace) com as suas aeronaves; a lista de aeronaves vem da lista de conteúdos do simulador. Numa instalação nova, a lista é criada na primeira importação. - Comandos:
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-filescomo as duas caixas da página Exportar); relações por aeronave comengine relations aircraft set; Desfazer comengine backups restore; o monitor de jogos comengine sync statuseengine sync diff. O nome antigo da CLIengine msfs ...continua a significar MSFS 2024.
#Limites conhecidos
- Os espaços de predefinição específicos de uma aeronave não são escritos (só vêm com o pacote próprio da aeronave); o JoyPro nunca escreve
profile_00(o ficheiro termina com uma soma de verificação). - A predefinição do JoyPro só chega às aeronaves que o simulador ainda não configurou para um dispositivo; nas outras, o seu próprio perfil ou um ficheiro de importação leva as atribuições.
- No máximo duas combinações de entrada por ação; uma terceira é comunicada. Meios eixos, diagonais do hat e um segundo hat não são lidos nem escritos. Modificadores: só botões do mesmo dispositivo.
- Os pacotes de add-ons compactados (
.fsarchive) são ignorados; caminhos de gravação da Store com mais de 260 caracteres não são lidos. - Uma cópia na nuvem (Steam Cloud, nuvem Xbox) pode prevalecer sobre a escrita do JoyPro quando outro PC gravou mais tarde.
- Testes:
engine\tests\smoke\msfs.ps1,smoke\msfsuserprofiles.ps1,gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs(gravações Steam e Store, perfis por aeronave, reversão),MsfsStoreWatcherEndToEndTests; no simuladortools\e2e\games\Msfs2024Settings.ps1(predefinições, eixos, botões e a curva por ação em Controls).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): msfs.md.