JoyPro2 Discord GitHub
Juegos

Microsoft Flight Simulator 2024

Mostrar:

MSFS 2024 guarda sus controles en perfiles, uno por dispositivo y categoría (Airplanes y General), y recuerda para cada dispositivo y aeronave qué perfil usa. JoyPro lee estos perfiles en un perfil propio y vuelve a escribir sus asignaciones exactamente en los perfiles que usa el simulador, en la versión de Steam y en la de Microsoft Store. Para las aeronaves que el simulador aún no ha configurado para un dispositivo, JoyPro añade sus propios presets como un pequeño paquete en la carpeta Community2024 del simulador, y donde no puede escribir un perfil le deja un archivo para importar en el menú Controls del simulador.

Microsoft Flight Simulator 2024 nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine msfs2024
Archivo de asignaciones
su propio perfil que el simulador usa por dispositivo y categoría (XML de Steam remote\inputprofile_* o el guardado de Microsoft Store, --user-profiles) + el paquete Community de JoyPro (joypro-input-profiles, un XML de preset por dispositivo); archivos de importación en Documents\JoyPro2\MSFS 2024 import files donde no se puede escribir su perfil
Entradas que lee el juego
lee 8 ejes, 1 hat (4 direcciones) por joystick (documentado)
Lista de comandos de
los archivos de preset de Asobo, los eventos de vuelo que nombra fs-base\en-US.locPak, las aeronaves instaladas
Prueba en el juego
26/26 pasos superados (2026-10-11)
  • ✓ Importar
  • ✓ Exportar
  • ✗ Asignaciones de teclado
  • ◐ ModificadoresMSFS: solo botones modificadores del mismo dispositivo.
  • ✓ Lista de comandos creada en su PC
  • ✓ Vigilancia de juegos
  • ✓ Curvas de eje y zonas muertas
  • ✗ Ajustes de control del juego
  • ✗ Ajustes de force feedback en el juego
  • ✗ Force feedback a partir de telemetría
  • ✓ Grabación de telemetría
  • ✓ Joystick virtual (vJoy)
  • ◐ Mando Xbox virtual
  • ✓ Funciones virtuales
  • ✓ Asistente de configuración / Asignar automáticamente
  • ✓ Cabinas
  • ✓ Hojas de referencia
  • ✓ Prueba en el juego

De la matriz de soporte, generada a partir del código del motor: todos los juegos.

Para principiantes

#Funciona en 3 pasos

  1. Configurarlo todo por mí
    en la página Inicio
  2. Usar estos botones
    mire antes la lista
  3. Escribir en mi juego
    con el simulador cerrado

Antes: conecte cada dispositivo una vez.

Después: lea el cuadro Sus perfiles de MSFS 2024. ¿Nombra un archivo de importación? Entonces importe ese archivo en el simulador (vea Lo que hace usted mismo abajo).

¿Ya asignó botones en MSFS 2024 antes? Entonces la página Inicio ofrece Importar y luego rellenar huecos. Sus asignaciones se quedan y solo los botones libres reciben nuevas funciones. Vea Inicio rápido: hacer que mi palanca funcione.

#Lo que hace JoyPro por MSFS 2024

  • Importar: los perfiles que creó en el menú Controls del simulador (Steam o Microsoft Store) entran en su perfil, asignaciones de vuelo y asignaciones General (cámaras, vistas, pausa activa, etc.), con los ajustes de eje de la página Sensitivity. Un dispositivo que nunca cambió en el simulador trae el preset que el simulador incluye para él, cuando los propios registros del simulador muestran que usa ese preset.
  • Relaciones: una relación es una función. En MSFS 2024 una relación puede ser para todas las aeronaves (lo predeterminado) o solo para las aeronaves que marque, como en DCS.
  • Exportar: JoyPro escribe sus asignaciones en el perfil que usa el simulador para cada dispositivo y categoría, escribe su paquete de presets para las aeronaves que el simulador aún no ha configurado, y escribe un archivo de importación donde no pudo actualizar su perfil.

#Importe sus asignaciones de MSFS 2024

  1. Abra Iniciar y pulse Importar en la tarjeta de Microsoft Flight Simulator 2024.
  2. Para MSFS importan dos opciones, ambas desactivadas salvo que las marque:
    • Importar también dispositivos no conectados: MSFS guarda las asignaciones de todos los dispositivos que ha visto. Desactivado: solo los dispositivos conectados ahora.
    • Importar también preajustes predeterminados que el simulador quizá no use: para dispositivos en los que los registros del simulador no muestran el uso de un preajuste incluido. Esto puede añadir asignaciones que el simulador no tiene.
  3. Pulse Importar ahora (o Ver primero para ver lo que tiene el simulador sin cambiar su perfil).

Las relaciones importadas se aplican a todas las aeronaves. Cuando una asignación solo existe en los perfiles de algunas aeronaves, la página Relaciones muestra una nota tras la importación con Limitar a estas aeronaves por relación, Limitar todas y Mantener para todas las aeronaves.

La página Inicio con sus juegosLa página Inicio con sus juegos
La página Inicio con sus juegos (Las imágenes muestran la aplicación en inglés.)

#Crear y comprobar relaciones

En la página Relaciones, una acción de MSFS 2024 muestra las aeronaves del simulador con marcas de verificación: todas las aeronaves marcadas significa todas las aeronaves. Una acción que solo existe en algunas aeronaves complementarias dice "solo para:" con esas aeronaves, y al añadirla solo se marcan ellas. Vea el flujo de relaciones y luego ejecute la comprobación en la página Exportar: encuentra un botón con dos funciones antes de que lo haga el simulador.

#Exportar a MSFS 2024

  1. Cierre MSFS 2024. JoyPro se niega a escribir mientras el simulador está en marcha (en la versión de Microsoft Store, también mientras se ejecuta su ayudante de inicio).
  2. Abra Exportar. En Exportar a juegos, dos casillas son para MSFS 2024:
    • MSFS 2024: escribir en mis perfiles de MSFS (activado): la exportación actualiza el perfil que usa el simulador para cada dispositivo y categoría, con copia de seguridad previa.
    • MSFS 2024: archivos de importación para cada dispositivo (desactivado): un archivo de importación para cada dispositivo y categoría, no solo donde JoyPro no pudo escribir su perfil.
  3. Deje Sustituir en mis dispositivos con Borrar también mis otros dispositivos si es en JoyPro donde configura sus dispositivos, y pulse Exportar ahora en la tarjeta de MSFS 2024.

Después de la exportación, el cuadro Sus perfiles de MSFS 2024 enumera cada perfil que escribió JoyPro, con sus aeronaves y el número de asignaciones. Si se escribieron archivos de importación, un segundo cuadro los nombra con Abrir carpeta.

La página ExportarLa página Exportar
La página Exportar
En el juego: Lo que ve en MSFS 2024

Inicie el simulador y abra Settings > Controls, luego elija su dispositivo y la categoría (Airplanes o General). Sus asignaciones están en su propio perfil, bajo los nombres de acción del simulador; la página del dispositivo (Hardware Settings en el engranaje del dispositivo) muestra las curvas de eje que escribió JoyPro. En una aeronave que el simulador aún no ha configurado para ese dispositivo, el dispositivo empieza con el preset de JoyPro.

#Lo que hace usted mismo en MSFS 2024

  • Nada, para cada perfil que aparece como actualizado en Sus perfiles de MSFS 2024.
  • Archivos de importación: cuando la exportación enumera uno, abra Settings > Controls, elija el dispositivo y la categoría (Airplanes o General), haga clic en el engranaje del perfil (no en el del preset), elija Import y seleccione el archivo que escribió JoyPro para ese dispositivo y categoría. El simulador solo acepta un archivo para el mismo dispositivo y categoría. Cuando el archivo lleva el nombre de su perfil, el simulador pregunta si sobrescribirlo: confirme, y su perfil tendrá las asignaciones de JoyPro. Vuelva a importar un archivo solo cuando la exportación diga que es nuevo o ha cambiado.
  • Conecte cada dispositivo una vez antes de la primera exportación: JoyPro necesita el ID de producto del dispositivo para su preset.
  • Una aeronave necesita asignaciones distintas a las demás: dele su propio perfil en el simulador (Controls, con esa aeronave cargada: duplique el perfil) y exporte de nuevo. La exportación nombra cada relación que no pudo colocar.
  • Pregunta de la nube de Xbox: si el simulador o la aplicación Xbox pregunta qué partida guardada conservar, conserve la de este PC; la otra descarta las asignaciones de JoyPro (en ese caso, exporte de nuevo).

#Errores frecuentes

  • "MSFS 2024 está en marcha": cierre el simulador; en la versión de Microsoft Store, el ayudante de inicio del simulador (gamelaunchhelper.exe) también tiene que haberse cerrado.
  • Faltan asignaciones en una aeronave: esa aeronave usa otro de sus perfiles. Compruebe la lista Sus perfiles de MSFS 2024; una línea con "archivo de importación" significa que importa ese archivo en el simulador.
  • No se escribió una relación: está limitada a algunas aeronaves, pero el perfil que usa ahí el simulador se comparte con otras aeronaves. El aviso nombra el perfil y las aeronaves.
  • Un dispositivo tiene varios perfiles: la importación toma el que nombran los registros del simulador, si no el más reciente, y nombra los demás. Elija otro con Perfil del juego en el formulario Otros juegos de la página Inicio.
  • "WRONG DEVICE" al asignar en el simulador: un dispositivo que no deja de enviar valores (algunas palancas con force feedback) se queda con la detección del simulador. Esto pasa en la asignación propia del simulador, no en JoyPro.
  • Reset to Defaults en el simulador restablece los presets de todos los dispositivos y aeronaves; JoyPro nunca lo hace por usted.
Avanzado

#Archivos que JoyPro lee y escribe

Archivo Qué es
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> su propio perfil (Steam), XML simple sin extensión; se escribe en su sitio, y Steam Cloud lo sube en la próxima sincronización
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ el guardado de Microsoft Store (containers.index, container.<n>, un blob por perfil); JoyPro escribe un blob nuevo, un archivo de contenedor nuevo y el índice
remote\profile_00 (Store: el contenedor profile_00) los registros de dispositivos del simulador: qué perfil o preajuste usa cada dispositivo por aeronave. Solo lectura, nunca se escribe
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml el preajuste de JoyPro de un dispositivo (acciones de vuelo), con layout.json y manifest.json
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml el preajuste de JoyPro de las asignaciones General de un dispositivo
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml los archivos de importación, en el propio formato de perfil del simulador
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak los preajustes que trae Asobo y los nombres de menú: solo lectura, para la lista de comandos y los preajustes predeterminados
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS los datos de propiedad y las copias de seguridad de JoyPro, nunca en una carpeta sincronizada

<packages> es el InstalledPackagesPath de %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt (Store: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). Antes de cada escritura, toda la carpeta de guardado de la Store o el archivo de Steam entra en el conjunto de copias de seguridad, así que Deshacer última exportación devuelve el guardado.

#Los modos de exportación en MSFS 2024

Los modos trabajan por perfil (es decir, por grupo de aeronaves) y solo en los contextos gestionados.

Modo Qué ocurre en sus perfiles de MSFS 2024
Solo añadir Una asignación solo se escribe donde ninguna otra acción de ese perfil usa la combinación de entradas; si no, aparece como no escrita. No se quita nada.
Actualizar, conservar las del juego La otra acción en su combinación de entradas la pierde; todo lo demás se queda, también la combinación antigua de una acción (una acción tiene dos: Primary y Secondary).
Actualizar, gana mi perfil Como arriba, y cada acción que usted asigna pierde sus otras combinaciones, también en los perfiles de otros dispositivos conectados (esos perfiles también se escriben).
Sustituir en mis dispositivos Los perfiles de los dispositivos conectados que JoyPro escribe conservan solo sus asignaciones.
+ Borrar también mis otros dispositivos Nunca vacía uno de sus propios perfiles de MSFS 2024.

Una relación para todas las aeronaves va a cada perfil que nombran los registros del simulador; una relación limitada a aeronaves solo va a los perfiles cuyas aeronaves están todas marcadas. Las relaciones limitadas nunca van al paquete de preajustes ni a los archivos de importación, porque esos se aplican a todas las aeronaves.

#Lo que nunca se toca

  • Los contextos de menú, mapa del mundo y desarrollador (MENU, MENU_*, WORLDMAP_*, DEBUG, DEVMODE*, EDITOR_*, MISSION_FLOW_TOOLS), en todos los modos.
  • Los perfiles de teclado, ratón y mando (GUID="{0}"): en MSFS no se escriben asignaciones de teclado.
  • profile_00, los preajustes que trae Asobo, las ranuras de preajuste específicas de aeronave y todos los demás contenedores del guardado de la Store (diarios de vuelo, otros títulos).
  • Los dispositivos que no están conectados, los dispositivos ignorados de la importación y el dispositivo vJoy al que JoyPro envía.

#Aeronaves, curvas, lo demás

  • Granularidad: por dispositivo y categoría (Airplanes, General) y por perfil; el simulador elige el perfil por dispositivo y aeronave, y JoyPro sigue esa elección.
  • Curvas de eje: la página Sensitivity del dispositivo, un conjunto por eje físico: Sensitivity + y -, Neutral, Dead zone, Extremity dead zone, Reactivity, el indicador sin curva y la inversión. Una relación puede dar a una acción sus propios valores (el ajuste propio por acción de MSFS 2024). Las relaciones en el mismo eje de dispositivo comparten su página: la exportación escribe los valores de la primera relación y avisa. Vea axis-curves.
  • Force feedback: MSFS no tiene uno propio.
  • Grabación de telemetría: mediante SimConnect, en solo lectura, con su propio SimConnect.dll (JoyPro no incluye ninguno): la versión de Steam de MSFS 2024 no trae ninguno, así que instale el SDK de MSFS 2024 o tenga MSFS 2020 instalado (su copia también sirve).
  • HUD: el HUD encuentra el simulador por su proceso y muestra sus asignaciones.
  • Vigilancia: JoyPro vigila su paquete, los perfiles de Steam y el containers.index del guardado de la Store; después de cerrar el simulador (el guardado de la Store espera 10 s tras su última escritura) pregunta si debe adoptar sus cambios hechos en el juego (la vigilancia).
  • Reimportación: los nombres de relación, los grupos y los ajustes vuelven mediante los metadatos de JoyPro junto a los archivos (reimportación).
  • Opciones para expertos (Otros juegos en la página Inicio): Perfil del juego (elija un perfil cuando un dispositivo tiene varios), Aeronave de exportación (exportar también las relaciones limitadas a una aeronave, para todas las aeronaves), Escribir en mis perfiles de MSFS, Escribir también archivos de importación de MSFS para cada dispositivo, una prueba sin cambios.
Detalles técnicos internos

#Dentro de la integración de MSFS 2024

flowchart LR
  P["Su perfil"] --> E["engine msfs2024 export"]
  E --> U["Sus propios<br/>perfiles"]
  E --> K["Preajustes<br/>de JoyPro"]
  E --> F["Archivos de importación"]
  F --> I["Usted: rueda dentada,<br/>Import"]
  U --> S["Settings ><br/>Controls"]
  K --> S
  I --> S
Sus propios perfiles (Steam inputprofile_n o la partida guardada de la versión de la Store) se escriben directamente. Los preajustes de JoyPro (Community2024 / joypro-input-profiles, un preajuste por dispositivo) sirven a las aeronaves que el simulador aún no ha configurado. Los archivos de importación (Documents / JoyPro2) los carga usted mismo en el simulador.

Código: engine\Games\MsfsIntegration.cs (una clase para los dos simuladores), MsfsIntegration.UserProfiles.cs (la escritura directa), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs (lectura de Steam y de la Store), WgsContainers.cs (el guardado de la Store), MsfsSimProfile.cs (los registros en profile_00), MsfsSimDefaults.cs, MsfsProfileFile.cs (el editor por líneas), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.

  • Formato: un fragmento XML (varios elementos de nivel superior): <Version>, <FriendlyName>, <Device DeviceName GUID ProductID CompositeID HWVer> con <Axes> y <Context ContextName> / <Action ActionName Flag> / <Primary> / <Secondary> / <KEY Information>code</KEY>. Un perfil de 2024 enumera todas las acciones de sus contextos, las no asignadas como <Action/> vacío. Códigos: botón N = N-1, hat 256-259, eje L X/Y/Z 1026/1042/1058, eje R 770/786/802, deslizadores 514/530. Indicadores: 2 digital, 4 eje, 128 invertir, 1024 sin curva de sensibilidad, 4096 ajuste de eje propio por acción. Solo se vuelven a generar los elementos <Action> cambiados.
  • Dispositivos: un perfil nombra su dispositivo por el GUID de instancia de DirectInput (GUID), así que no hace falta ningún dispositivo conectado para leerlo. El simulador asigna un preset por el ID de producto USB (hex): JoyPro usa el que el simulador anotó en profile_00; si no, el PID USB (vJoy aparece con ID de producto 0).
  • Qué perfil está activo: por dispositivo y aeronave, los registros de profile_00 tienen una ranura General y una ranura de categoría; un perfil propio ahí es inputprofile_<n>, que es el nombre de archivo de Steam y el nombre del contenedor de la Store.
  • Partida guardada de la Store: solo se escribe cuando el índice tiene el esquema conocido (versión 14, sin marca de conflicto, el contenedor listado una sola vez en un estado conocido); entonces un nuevo blob, container.<n+1>, el índice al final (archivo temporal y reemplazo), se vuelve a leer y se elimina la generación antigua. Cualquier fallo lo devuelve todo a su estado; con algo desconocido no se escribe nada y el archivo de importación lleva las asignaciones.
  • Lista de comandos: engine msfs2024 refresh-db lee los presets de Asobo, todos los eventos de vuelo que nombra en-US.locPak, sus perfiles General y los paquetes de complementos sin empaquetar (Community, Marketplace) con sus aeronaves; la lista de aeronaves sale de la lista de contenido del simulador. Una instalación nueva crea la lista en la primera importación.
  • 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 y --import-files como las dos casillas de la página Exportar); relaciones por aeronave con engine relations aircraft set; Deshacer con engine backups restore; la vigilancia con engine sync status y engine sync diff. El antiguo nombre de CLI engine msfs ... sigue significando MSFS 2024.

#Límites conocidos

  • Las ranuras de preset específicas de una aeronave no se escriben (solo vienen con el paquete propio de la aeronave); JoyPro nunca escribe profile_00 (el archivo termina con una suma de comprobación).
  • El preset de JoyPro solo llega a las aeronaves que el simulador aún no ha configurado para un dispositivo; en las demás, su propio perfil o un archivo de importación lleva las asignaciones.
  • Como máximo dos combinaciones de entrada por acción; una tercera se notifica. Los semiejes, las diagonales del hat y un segundo hat no se leen ni se escriben. Modificadores: solo botones del mismo dispositivo.
  • Los paquetes de complementos empaquetados (.fsarchive) se omiten; las rutas de partidas guardadas de la Store de más de 260 caracteres no se leen.
  • Una copia en la nube (Steam Cloud, nube de Xbox) puede imponerse a lo que escribió JoyPro cuando otro PC guardó más tarde.
  • Pruebas: engine\tests\smoke\msfs.ps1, smoke\msfsuserprofiles.ps1, gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs (partidas de Steam y de la Store, perfiles por aeronave, reversión), MsfsStoreWatcherEndToEndTests; en el simulador tools\e2e\games\Msfs2024Settings.ps1 (presets, ejes, botones y la curva por acción en Controls).

Todas las notas técnicas sobre este juego (generadas a partir del repositorio): msfs.md.