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.
#Funciona en 3 pasos
- Configurarlo todo por mí
en la página Inicio - Usar estos botones
mire antes la lista - 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
- 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.txtdel X-Plane instalado. - Pulse Importar en la tarjeta y elija Añadir a mi perfil (X-Plane no tiene asignaciones de teclado en este archivo).
- Pulse Importar ahora. Ver mis relaciones abre lo que ha entrado.


#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
- 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. - Abra Exportar. Cada versión instalada tiene su propia tarjeta.
- 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.
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.
#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).
#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
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 deCommands.txt(sim/flight_controls,engines,autopilot,lights...; nosim/view,operation,replay...). - Importación / exportación:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), lo mismo paraengine 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.ps1recorre 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.