JoyPro2 Discord GitHub
Jogos

Microsoft Flight Simulator 2024

Mostrar:

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 em Documents\JoyPro2\MSFS 2024 import files onde 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.locPak nomeia, 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.

Para iniciantes

#Pôr a funcionar em 3 passos

  1. Configurar tudo por mim
    na página Início
  2. Usar estes botões
    veja primeiro a lista
  3. 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

  1. Abra Iniciar e prima Importar no cartão do Microsoft Flight Simulator 2024.
  2. 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.
  3. 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.

A página Início com os seus jogosA página Início com os seus jogos
A página Início com os seus jogos (As imagens mostram a aplicação em inglês.)

#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

  1. 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).
  2. 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.
  3. 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.

A página ExportarA página Exportar
A página Exportar
No jogo: O que vê no MSFS 2024

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.
Avançado

#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.index da 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.
Detalhes técnicos internos

#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
Os seus próprios perfis (Steam inputprofile_n ou a gravação da Store) são escritos diretamente. As predefinições do JoyPro (Community2024 / joypro-input-profiles, uma predefinição por dispositivo) servem as aeronaves que o simulador ainda não configurou. Os ficheiros de importação (Documents / JoyPro2) são carregados por si no simulador.

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 em profile_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_00 tê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-db lê as predefinições da Asobo, todos os eventos de voo que en-US.locPak nomeia, 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 false e --import-files como as duas caixas da página Exportar); relações por aeronave com engine relations aircraft set; Desfazer com engine backups restore; o monitor de jogos com engine sync status e engine sync diff. O nome antigo da CLI engine 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 simulador tools\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.