JoyPro2 Discord GitHub
Juegos

FSX y Prepar3D

Mostrar:

FSX, FSX: Steam Edition y Prepar3D v4, v5 y v6 guardan sus controles en un archivo XML en %APPDATA%: un mapa por dispositivo con sus ejes, botones y hat, más el teclado. JoyPro lee ese archivo en su perfil, lo une con sus otros juegos en relaciones y lo vuelve a escribir bloque a bloque, dejando el formato, los comentarios y los demás mapas como están. Cada simulador es un juego propio en JoyPro porque cada uno tiene su propio archivo.

Esta integración se escribió a partir de fuentes públicas y solo está cubierta por un archivo de prueba sintético: ninguno de estos simuladores se ha probado aún con JoyPro en una instalación real. Después de su primera exportación, abra los controles del simulador y compruebe las asignaciones, y por favor informe de lo que sea distinto.

Microsoft Flight Simulator X nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine fsx
Archivo de asignaciones
%APPDATA%\Microsoft\FSX\Controls\Standard.XML (XML)
Entradas que lee el juego
lee 32 botones, 8 ejes por joystick (informado)
Lista de comandos de
la lista de eventos propia de JoyPro (ids públicos del SDK) + los eventos de sus archivos de controles y de la plantilla de la instalación
  • ✓ Importar
  • ✓ Exportar
  • ✓ Asignaciones de teclado
  • ◐ ModificadoresFSX y Prepar3D: Ctrl/Shift/Alt en las teclas; ningún modificador en las asignaciones de joystick.
  • ✓ 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
Microsoft Flight Simulator X: Steam Edition nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine fsxse
Archivo de asignaciones
%APPDATA%\Microsoft\FSX-SE\Controls\ (o la carpeta de FSX), XML
Entradas que lee el juego
lee 32 botones, 8 ejes por joystick (informado)
Lista de comandos de
igual que FSX
  • ✓ Importar
  • ✓ Exportar
  • ✓ Asignaciones de teclado
  • ◐ ModificadoresFSX y Prepar3D: Ctrl/Shift/Alt en las teclas; ningún modificador en las asignaciones de joystick.
  • ✓ 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
Prepar3D v4 nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine p3d4
Archivo de asignaciones
%APPDATA%\Lockheed Martin\Prepar3D v4\Controls\Standard.xml (XML)
Entradas que lee el juego
lee 32 botones, 8 ejes por joystick (informado)
Lista de comandos de
la lista de eventos propia de JoyPro + sus archivos de controles + el Standard.xmlx de la instalación
  • ✓ Importar
  • ✓ Exportar
  • ✓ Asignaciones de teclado
  • ◐ ModificadoresFSX y Prepar3D: Ctrl/Shift/Alt en las teclas; ningún modificador en las asignaciones de joystick.
  • ✓ 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
Prepar3D v5 nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine p3d5
Archivo de asignaciones
%APPDATA%\Lockheed Martin\Prepar3D v5\Controls\Standard.xml (XML)
Entradas que lee el juego
lee 32 botones, 8 ejes por joystick (informado)
Lista de comandos de
igual que Prepar3D v4
  • ✓ Importar
  • ✓ Exportar
  • ✓ Asignaciones de teclado
  • ◐ ModificadoresFSX y Prepar3D: Ctrl/Shift/Alt en las teclas; ningún modificador en las asignaciones de joystick.
  • ✓ 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
Prepar3D v6 nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine p3d6
Archivo de asignaciones
%APPDATA%\Lockheed Martin\Prepar3D v6\Controls\Standard.xml (XML)
Entradas que lee el juego
lee 32 botones, 8 ejes por joystick (informado)
Lista de comandos de
igual que Prepar3D v4
  • ✓ Importar
  • ✓ Exportar
  • ✓ Asignaciones de teclado
  • ◐ ModificadoresFSX y Prepar3D: Ctrl/Shift/Alt en las teclas; ningún modificador en las asignaciones de joystick.
  • ✓ 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: inicie el simulador una vez con sus dispositivos conectados y luego ciérrelo.

Después: abra los ajustes de controles del simulador y compruebe las asignaciones. Esta integración aún no se ha probado en una instalación real: por favor informe de lo que sea distinto.

¿Ya asignó botones en el simulador 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 FSX y Prepar3D

  • Importar: los ejes, botones y hats de sus dispositivos entran en su perfil, con la sensibilidad y la zona nula de cada eje. Las teclas del teclado entran cuando usted las pide.
  • Relaciones: una relación es una función en todos sus juegos ("Tren de aterrizaje" en FSX, MSFS y X-Plane en el mismo botón). Los comandos son los nombres de eventos públicos de los simuladores (GEAR_TOGGLE, AXIS_AILERONS_SET ...).
  • Exportar: JoyPro escribe el archivo de controles activo del simulador que exporta.

#Importe sus asignaciones

  1. Abra Iniciar. La tarjeta de su simulador muestra su imagen. Si pide una lista de comandos, pulse Crear lista: JoyPro combina su propia lista de eventos con los eventos que nombran sus archivos de controles (y los archivos de plantilla del propio simulador).
  2. Pulse Importar en la tarjeta. Elija Añadir a mi perfil y marque Tomar también las teclas del teclado si quiere también sus teclas.
  3. Pulse Importar ahora. Ver mis relaciones abre lo que ha entrado.

#Crear y comprobar relaciones

En la página Relaciones, el evento del simulador de una relación está junto a la misma función en sus otros juegos. Use el flujo de relaciones para unirlos y luego pulse Comprobar ahora en la página Exportar (la comprobación).

#Exportar

  1. Cierre el simulador. Reescribe el archivo al salir; JoyPro se niega mientras fsx.exe o Prepar3D.exe está en marcha.
  2. Abra Exportar y use la tarjeta de su simulador.
  3. Deje Sustituir en mis dispositivos con Borrar también mis otros dispositivos si es en JoyPro donde configura sus dispositivos. Pulse Exportar ahora en la tarjeta.
En el juego: Lo que ve en FSX y Prepar3D

Inicie el simulador y abra sus ajustes de controles: ahí aparecen las asignaciones de sus dispositivos, y la sensibilidad y la zona nula de cada eje en su página de calibración. La ruta exacta del menú y cómo muestran los simuladores el archivo de JoyPro aún no están confirmadas.

#Lo que hace usted mismo en FSX y Prepar3D

  • Inicie el simulador una vez con sus dispositivos conectados, para que escriba su archivo de controles.
  • Compruebe el resultado después de la primera exportación (vea arriba). Es la primera prueba real de esta integración en su PC.
  • Un hat se asigna entero y normalmente es el desplazamiento de la vista (PAN_VIEW). Otros eventos en direcciones sueltas del hat no se escriben; asígnelos en el simulador.

#Errores frecuentes

  • "El simulador está en marcha": ciérrelo y exporte de nuevo.
  • Un dispositivo perdió sus asignaciones tras volver a conectarlo: Windows puede dar a un dispositivo un GUID nuevo. JoyPro encuentra entonces su mapa por el nombre cuando exactamente un dispositivo conectado lo tiene (con un aviso).
  • Falta una asignación de joystick con modificador: el formato no tiene modificadores en botones de joystick. Las teclas pueden tener Ctrl, Shift y Alt.
Avanzado

#Archivos que JoyPro lee y escribe

Simulador Archivo de controles
FSX (en caja) %APPDATA%\Microsoft\FSX\Controls\Standard.XML (archivo activo según fsx.cfg [CONTROLS] Controls_Current)
FSX: Steam Edition %APPDATA%\Microsoft\FSX-SE\Controls\ junto a FSX en caja, %APPDATA%\Microsoft\FSX\Controls\ cuando está instalado solo
Prepar3D v4 / v5 / v6 %APPDATA%\Lockheed Martin\Prepar3D v<N>\Controls\Standard.xml (archivo activo según Prepar3D.cfg [CONTROLS])
todos <file>.joypro.json (las entradas que JoyPro escribió), <file>.joypro-meta.json (nombres, grupos y ajustes para la próxima importación)

El Standard.xmlx de Prepar3D (preajustes de dispositivos) y la plantilla de FSX en la carpeta de instalación se leen para la lista de comandos y nunca se escriben.

#Los modos de exportación en FSX y Prepar3D

Modo Qué ocurre en el simulador
Solo añadir Nunca quita ni sustituye un bloque. Una asignación en una entrada que tiene otro evento no se escribe y se enumera.
Actualizar, conservar las del juego Sustituye el evento en su entrada (el conflicto) y conserva todo lo demás.
Actualizar, gana mi perfil Quita además las otras entradas de los eventos que usted asigna (dispositivos conectados; el teclado solo con la opción de teclado).
Sustituir en mis dispositivos Los mapas principales de los dispositivos que usted escribe conservan solo sus asignaciones.
+ Borrar también mis otros dispositivos Los mapas principales de los demás dispositivos conectados se vacían (los mapas se quedan).

#Lo que nunca se toca

  • Los mapas de dispositivos que no están conectados, los dispositivos ignorados de la importación y el dispositivo vJoy al que JoyPro envía.
  • Los mapas de slew (... SLEW {GUID}), Mouse Yoke, Mouse Look, los mapas por SimObject de Prepar3D y el mapa de teclado, salvo que usted exporte asignaciones de teclado.
  • Las combinaciones de dos teclas normales, los comentarios, el formato y los elementos desconocidos.

#Curvas y configuración

  • Granularidad: global, un solo archivo para todas las aeronaves.
  • Ajustes de eje (modelo de ejes fsx): sensibilidad (de 0 a 127) y zona nula (de 0 a 127) por eje de dispositivo, como en la página de calibración. La Curva predeterminada se adapta (zona muerta a zona nula, saturación a sensibilidad); la forma de una curva no tiene equivalente. En el modo Actualizar, los valores ajustados en el simulador se quedan cuando los de JoyPro son el valor predeterminado simple.
  • Invertir: una sensibilidad negativa.
  • Sin force feedback, configuración del juego ni telemetría. La vigilancia detecta los cambios después de cerrar el simulador.
Detalles técnicos internos

#Dentro de la integración de FSX y Prepar3D

flowchart LR
  P["Su perfil<br/>(relaciones + asignaciones)"] --> E["engine fsx / fsxse /<br/>p3d4 / p3d5 / p3d6 export"]
  E --> X["Controls / Standard.XML:<br/>un mapa por dispositivo<br/>(nombre del dispositivo {GUID}),<br/>KEYBOARD_MAIN (solo con<br/>la opción de teclado)"]
  X --> G["La configuración de controles del simulador"]
Un archivo de controles por simulador. El mapa de teclado solo se escribe con la opción de teclado.

Código: engine\Games\FsxIntegration.cs (una clase, un juego por simulador), engine\Games\FsxControlsFile.cs (edición de texto de bloques enteros), engine\Games\FsxEvents.cs (la lista de eventos de JoyPro).

  • Formato: <SimControls.Map> con <Name>, <Axis> (<Index> de 0 a 7 = X, Y, Z, Rx, Ry, Rz, Slider, segundo deslizador; <AxEvent>, <AxScale>, <AxNull>), <Entry> (<Index> del botón empezando en 0, <Down> / <Up>, <DownRpt>1 para eventos que se repiten) y <POV> (un hat entero). Cabecera encoding="Windows-1252".
  • Dispositivos: un mapa por dispositivo DirectInput llamado <instance name>{<instance GUID>}; se compara por GUID, o si no, por nombre cuando exactamente un dispositivo conectado lo tiene. Un dispositivo que el archivo no tiene recibe un mapa nuevo. Se informa de 32 botones y 8 ejes por dispositivo.
  • Asignación: JOY_X .. JOY_SLIDER2 a <Index> de 0 a 7, JOY_BTN<n> a <Index> n-1, un hat en su dirección hacia arriba (JOY_BTN_POV1_U).
  • Lista de comandos: engine fsx refresh-db (y fsxse, p3d4, p3d5, p3d6): unos 150 eventos con los títulos de JoyPro, más cada evento que nombran sus archivos de controles y las plantillas del simulador; los eventos AXIS_* son ejes.
  • Importar / exportar: engine fsx paths (primero el archivo activo), engine fsx import, engine fsx scan, engine fsx export, y lo mismo para engine fsxse export, engine p3d4 export, engine p3d5 export, engine p3d6 export. Copia de seguridad antes de la primera escritura.

#Límites conocidos

  • Todo necesita una comprobación en una instalación real: la cabecera de Prepar3D v4+ y si <Name> sigue llevando el GUID, los bytes exactos que escriben los simuladores, el nombre de eje del segundo deslizador, y si un simulador conserva un mapa nuevo que JoyPro añade para un dispositivo que aún no ha visto.
  • El nombre del archivo de configuración de FSX: Steam Edition está deducido.
  • Pruebas: engine\tests\smoke\fsx.ps1 con un archivo sintético creado a partir del formato documentado.

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