JoyPro2 Discord GitHub
Juegos

X-Plane 12 / 11

Mostrar:

X-Plane guarda las asignaciones de todos sus dispositivos en un archivo de preferencias dentro de su instalación: un "uso" de eje (cabeceo, acelerador, flaps ...) por eje de hardware, un comando por botón y curvas de respuesta opcionales. JoyPro lee ese archivo en su perfil, lo une con sus otros juegos en relaciones y lo vuelve a escribir, cambiando solo las líneas de vuelo que gestiona. X-Plane 12 y X-Plane 11 son dos juegos en JoyPro, cada uno con su propia instalación, lista de comandos y ajustes; ambos pueden estar instalados a la vez.

X-Plane 12 nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine xplane12
Archivo de asignaciones
Output\preferences\X-Plane Joystick Settings.prf, control profiles\*.prf (por líneas)
Entradas que lee el juego
lee 160 botones, 25 ejes, 1 hat por joystick (verificado)
Lista de comandos de
Resources\plugins\Commands.txt
Prueba en el juego
33/33 pasos superados (2026-10-11)
  • ✓ Importar
  • ✓ Exportar
  • ✗ Asignaciones de teclado
  • ✗ Modificadores
  • ✓ 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 juegoX-Plane 12: solo el interruptor por dispositivo "control-loaded axes" para palancas con force feedback; el simulador no tiene efectos de force feedback propios para la palanca (solo plugins).
  • ✗ 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
X-Plane 11 nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine xplane11
Archivo de asignaciones
igual que X-Plane 12
Entradas que lee el juego
lee 160 botones, 25 ejes, 1 hat por joystick (verificado)
Lista de comandos de
Resources\plugins\Commands.txt
  • ✓ Importar
  • ✓ Exportar
  • ✗ Asignaciones de teclado
  • ✗ Modificadores
  • ✓ 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
    mantenga X-Plane cerrado

Antes: inicie X-Plane una vez con sus dispositivos conectados y luego salga.

Después: calibre sus dispositivos en X-Plane (Settings > Joystick). Allí también aparecen sus asignaciones.

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

#Lo que JoyPro hace por X-Plane

  • Importar: los usos de eje, los comandos de botón, las marcas de inversión y las curvas de respuesta de sus dispositivos llegan a su perfil.
  • Relaciones: una relación es una función en todos sus juegos ("Tren" en X-Plane, MSFS y DCS en el mismo botón). Los comandos de vuelo de X-Plane vienen de su propio Commands.txt.
  • Exportar: JoyPro escribe las preferencias de joystick de la versión que exporta. X-Plane muestra sus asignaciones en Settings > Joystick.

#Importar sus asignaciones de X-Plane

  1. Abra Iniciar. La tarjeta de X-Plane 12 (o X-Plane 11) muestra la imagen del juego. Si pide una lista de comandos, pulse Crear lista: JoyPro lee Resources\plugins\Commands.txt del X-Plane instalado.
  2. Pulse Importar en la tarjeta y elija Añadir a mi perfil (X-Plane no tiene asignaciones de teclado en este archivo).
  3. Pulse Importar ahora. Ver mis relaciones abre lo que ha entrado.
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, el comando o eje de X-Plane 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 a X-Plane

  1. Cierre X-Plane. Reescribe sus preferencias al cerrar la ventana de ajustes y al salir. Ambas versiones se ejecutan como X-Plane.exe, así que JoyPro se niega mientras cualquiera de ellas esté en marcha.
  2. Abra Exportar. Cada versión instalada tiene su propia tarjeta.
  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 X-Plane

Inicie X-Plane y abra Settings > Joystick; luego elija su dispositivo. Cada eje muestra el uso que escribió JoyPro, los botones muestran sus comandos, y Edit Response Curve en un eje muestra los puntos y la interpolación que escribió JoyPro.

#Lo que hace usted mismo en X-Plane

  • Inicie X-Plane una vez con sus dispositivos conectados y luego ciérrelo. Una versión que nunca se inició aún no tiene archivo de preferencias. El primerísimo arranque vuela el tutorial, y X-Plane escribe sus preferencias de joystick al salir.
  • Calibre en X-Plane. La calibración y la zona nula siguen siendo de X-Plane (Settings > Joystick); JoyPro nunca las escribe.
  • Los comandos de plugins y de aeronaves no están en la lista de JoyPro: asígnelos en X-Plane; JoyPro no los toca.

#Errores frecuentes

  • Un eje no hace nada ("Multiple axes assigned to yaw"): X-Plane ignora un uso que comparten dos ejes conectados. La exportación avisa; Borrar también mis otros dispositivos o Sustituir borra el otro eje.
  • El acelerador funciona al revés: X-Plane invierte los ejes del acelerador por sí solo. JoyPro escribe su inversión sin cambios, así que deje la inversión desactivada a menos que su palanca realmente funcione al revés.
  • Cambió una curva que hizo en X-Plane: en los modos Actualizar y Solo añadir se mantiene cuando el ajuste de JoyPro es lineal (con un aviso); "gana mi perfil" y Sustituir escriben la curva de JoyPro.
Avanzado

#Archivos que JoyPro lee y escribe

Archivo Qué es
<install>\Output\preferences\X-Plane Joystick Settings.prf las asignaciones actuales de todos los dispositivos (por líneas)
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf perfiles de control guardados, mismo formato
<file>.joypro.json, <file>.joypro-meta.json las entradas y curvas que escribió JoyPro; nombres, grupos y ajuste para la próxima importación
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt donde el instalador de X-Plane lista sus instalaciones (solo lectura)

X-Plane Keys.prf (teclado) nunca se toca. Una versión instalada por Steam y nunca iniciada se encuentra en su carpeta de Steam. Otra carpeta se indica en Configuración > Juegos.

#Los modos de exportación en X-Plane

Modo Qué pasa en X-Plane
Solo añadir Solo entradas libres. Una asignación en una entrada con otro uso u otro comando no se escribe y se lista; un uso de eje que X-Plane tiene en otro eje se queda allí (aviso).
Actualizar, conservar las del juego Reemplaza el otro uso o comando en su entrada y conserva todo lo demás; un uso de eje se mueve (X-Plane ignora un uso que comparten dos ejes).
Actualizar, gana mi perfil Además libera los demás ejes y botones de los dispositivos conectados que tienen un uso o un comando que usted asigna, con sus curvas.
Sustituir en mis dispositivos Además libera todos los demás ejes y comandos de vuelo en los dispositivos que usted escribe.
+ Borrar también mis otros dispositivos Los dispositivos conectados que usted no escribe pierden sus usos y comandos de vuelo.

#Lo que nunca se toca

  • Las ranuras de dispositivos que no están conectados, los dispositivos ignorados de la importación y el dispositivo vJoy al que JoyPro canaliza.
  • Ejes de vista, de cámara, de VR y de comandos personalizados, comandos de plugins y de aeronaves, el teclado.
  • Las claves de calibración (_joy_center, _joy_null, datos de calibración en bruto), _eq_pfc_* y todas las demás líneas.

#Curvas y configuración

  • Granularidad: un archivo para todas las aeronaves (X-Plane puede vincular aeronaves a perfiles de control; JoyPro escribe los archivos que encuentra).
  • Curvas de respuesta (modelo de eje xplane): cualquier número de puntos con LINEAR, CATMULL_ROM o CUBIC_AVG, y los rangos fijos de los ejes de acelerador, hélice y mezcla (beta, feather, cutoff, FADEC ...). La Curva predeterminada se convierte en puntos; una curva sin cambios conserva sus bytes. El ajuste se puede definir para una versión o para ambas (family:xplane).
  • Inversión: _joy_rev_axis, su inversión sin cambios (X-Plane invierte los aceleradores por sí mismo).
  • Ajustes del juego (Configuración > Ajustes de force feedback de los juegos): respuesta de control de pitch, roll y yaw; X-Plane 12 además los ejes del copiloto y los "control-loaded axes" para palancas con force feedback; X-Plane 11 el aumento de estabilidad; ambos los topes de flaps. Solo se cambian las líneas que el archivo ya tiene.
  • Force feedback: X-Plane no tiene uno propio; solo el interruptor control-loaded.
  • Grabación de telemetría: desde la salida de datos UDP de X-Plane (puerto 49000), con posición, así que es posible una pista de Tacview.
  • Vigilancia: los cambios en las preferencias se detectan después de que X-Plane se cierra (la vigilancia).
Detalles técnicos internos

#Por dentro de la integración de X-Plane

flowchart LR
  P["Su perfil<br/>(relaciones + asignaciones)"] --> E["engine xplane12 export<br/>(o xplane11)"]
  D["Ranuras de dispositivo<br/>VID:PID + ruta HID"] --> E
  E --> J["Output / preferences /<br/>X-Plane Joystick Settings.prf"]
  E --> C["control profiles /<br/>Name - Joysticks.prf"]
  J --> G["X-Plane: Settings > Joystick"]
  C --> G
Cada versión de X-Plane tiene su propio archivo de preferencias. La calibración y la zona nula siguen siendo de X-Plane.

Código: engine\Games\XPlaneIntegration.cs (una instancia por versión), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (los perfiles de antes de la división en dos versiones se migran al cargarse).

  • Líneas: _joy_AXIS_use<i> (código de uso), _joy_rev_axis<i>, _joy_BUTN_use<i> (ruta de comando, sim/none/none = libre), axis_response_curve<i>. Índices globales: eje = ranura × 25 + eje, botón = ranura × 160 + botón.
  • Dispositivos: ranuras _joy_unique_id<slot> VID:<dec>PID:<dec>; con dispositivos idénticos, la ruta de interfaz HID de DirectInput debe ser igual a _joy_location<slot>. Los botones son los botones del dispositivo y luego el primer hat como 8 botones en el sentido de las agujas del reloj desde arriba; los demás hats no se asignan. Lee 160 botones y 25 ejes por dispositivo.
  • Códigos de uso: del 0 al 66 en ambas versiones; X-Plane 12 añade el acelerador 9, pitch/roll/yaw/frenos/tiller del copiloto y ambos frenos de rueda. Los códigos 74 a 77 y los ejes de vista no están catalogados.
  • Lista de comandos: engine xplane12 refresh-db / engine xplane11 refresh-db: la tabla de ejes de la versión más los grupos de comandos de vuelo de Commands.txt (sim/flight_controls, engines, autopilot, lights ...; no sim/view, operation, replay ...).
  • Importación / exportación: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), lo mismo para engine xplane11 export. Antes, copia de seguridad en .jpbak.
  • Ajustes y curvas: engine ffb set --game XPlane12, engine binds tuning set --scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1, engine binds tuning preview (medido en X-Plane 12.4.3 con una precisión de 0.0001).

#Límites conocidos

  • El significado de los códigos de uso 74 a 77; el orden de ejes HID frente a DirectInput es deducido.
  • La Control Sensitivity de X-Plane sin curva no está en la vista previa.
  • X-Plane 11 solo se comprueba con sus archivos instalados; la comprobación en el menú del juego está pendiente.
  • Pruebas: engine\tests\smoke\xplane.ps1; en el juego (X-Plane 12), las asignaciones y las curvas de respuesta pasaron 33 de 33 pasos; tools\e2e\games\XPlaneCurves.ps1 recorre cada eje y lo compara con la vista previa de JoyPro.

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