JoyPro2 Discord GitHub
Juegos

X4: Foundations

Mostrar:

X4: Foundations guarda sus asignaciones en inputmap.xml y nombra un joystick por su ranura (1 a 8), no por su nombre. Qué dispositivo ocupa qué ranura está en config.xml. JoyPro lee las asignaciones de vuelo espacial en su perfil y las vuelve a escribir in situ, en las ranuras que X4 ha fijado a sus dispositivos. Las inversiones y la zona muerta son globales en X4, así que JoyPro las ajusta a partir de sus relaciones para todo el juego.

X4: Foundations nativo (sus propios archivos de asignaciones)
Soporte
nativo (sus propios archivos de asignaciones)
Comando del motor
engine x4
Archivo de asignaciones
Documents\Egosoft\X4\<id>\inputmap.xml (XML) + las ranuras en config.xml
Entradas que lee el juego
lee 64 botones, 8 ejes, 1 hat por joystick (verificado)
Lista de comandos de
las tablas de nombres de X4.exe y los archivos .cat/.dat
Prueba en el juego
36/36 pasos superados (2026-10-11)
  • ✓ Importar
  • ✓ Exportar
  • ✓ Asignaciones de teclado
  • ◐ ModificadoresX4: Shift/Ctrl en las asignaciones de teclado; las asignaciones de joystick no llevan modificador.
  • ✓ Lista de comandos creada en su PC
  • ✓ Vigilancia de juegos
  • ✗ Curvas de eje y zonas muertasX4: solo la zona muerta global del juego y las inversiones (Game settings), nada por asignación.
  • ✓ 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
X Rebirth solo documentado
Soporte
solo documentado
Comando del motor
ninguno
  • — 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
X3 (Reunion, Terran Conflict, Albion Prelude) solo documentado
Soporte
solo documentado
Comando del motor
ninguno
  • — 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 X4 cerrado

Antes: dé una ranura a cada dispositivo una vez. En los ajustes de controles de X4, abra Manage Controllers/Joysticks. Asigne cada dispositivo a una ranura y luego salga del juego con normalidad.

Después: sus asignaciones están en Settings > Controls.

¿Ya asignó botones en X4 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 X4

  • Importar: las asignaciones de vuelo espacial de sus palancas, aceleradores y pedales llegan a su perfil, con las inversiones y el modo del acelerador del juego.
  • Relaciones: una relación es una función en todos los juegos. "Boost" puede ser el mismo botón en X4, Elite Dangerous y Star Citizen.
  • Exportar: JoyPro edita inputmap.xml in situ, en las ranuras de sus dispositivos. Las asignaciones de menú, primera persona, teclado y ratón se quedan.

#Importar sus asignaciones de X4

  1. Abra Iniciar. Si la tarjeta de X4 pide una lista de comandos, pulse Crear lista: JoyPro lee los controles del juego de su instalación (solo lectura).
  2. Pulse Importar en la tarjeta de X4. Deje Añadir a mi perfil. Marque Tomar también las teclas del teclado si también quiere sus teclas de vuelo en JoyPro.
  3. Pulse Importar ahora. Ver mis relaciones abre lo que ha entrado.

#Crear y comprobar relaciones

Una la misma función de sus juegos con el flujo de relaciones y luego pulse Comprobar en la página Exportar. Deje sus asignaciones de joystick sin modificadores: X4 no admite modificadores en una asignación de joystick.

#Exportar a X4

  1. Cierre X4. El juego escribe inputmap.xml y config.xml al terminar una sesión, así que JoyPro se niega a escribir mientras está en marcha.
  2. Abra Exportar y marque la tarjeta de X4.
  3. Deje Sustituir en mis dispositivos con Borrar también mis otros dispositivos si es en JoyPro donde configura sus palancas. Pulse Exportar ahora en la tarjeta.
En el juego: Lo que ve en X4

Inicie el juego y abra Settings > Controls. Sus asignaciones están en la columna de mando / joystick de cada control de vuelo espacial, en la ranura de su dispositivo. Invert Controller / Joystick Axes muestra las inversiones que ajustó JoyPro, y las filas de acelerador bidireccional, zona muerta del joystick y dirección adaptativa muestran sus valores. El autoalabeo y la vibración están en los ajustes del juego.

#Lo que hace usted mismo en X4

  • Dé una ranura a cada dispositivo una vez. En los ajustes de controles de X4, abra Manage Controllers/Joysticks y asigne cada palanca, acelerador y juego de pedales a una ranura; luego salga del juego con normalidad. X4 recuerda entonces el dispositivo en config.xml. Un dispositivo sin esa entrada cambia de ranura de una sesión a otra, así que JoyPro lo omite ("assign the device to a slot in X4 once"). Un dispositivo puesto en "none" allí también se omite.
  • Conecte sus dispositivos antes de exportar.

#Errores frecuentes

  • "X4 está en ejecución": salga del juego y exporte de nuevo.
  • Se omitió un dispositivo: no está fijado a una ranura en X4. Asígnelo en Manage Controllers/Joysticks.
  • Una palanca en la ranura 1 hace cosas de mando: la ranura 1 es la ranura de mando del esquema predeterminado de X4, así que una palanca ahí hereda las asignaciones de mando de serie. Sustituir en mis dispositivos las quita.
  • Los botones por encima de 64 o un segundo hat no hacen nada: X4 lee 64 botones, 8 ejes y un hat por dispositivo. JoyPro omite las asignaciones que superan eso con un aviso.
  • Una inversión se dejó sin tocar: una inversión vale para todos los dispositivos de ese control. Cuando sus relaciones no coinciden, o un mando está asignado al mismo control, JoyPro deja el valor del juego y avisa.
Avanzado

#Archivos que JoyPro lee y escribe

Archivo Qué es
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml las asignaciones activas (<action>, <state>, <range> por control y entrada) y los parámetros de <config> (inversiones, zona muerta, acelerador bidireccional, dirección adaptativa). <id> es la carpeta de la cuenta de Steam.
...\X4\<id>\config.xml las ranuras de dispositivo (<joysticks>) y ajustes del juego como la vibración, el auto-roll y el modo gamepad; se lee para las ranuras y se edita en su sitio para los ajustes
...\X4\<id>\inputmap.xml.joypro-meta.json Los nombres, grupos y ajustes de JoyPro de las asignaciones escritas, que la próxima importación vuelve a leer
inputmap.xml.jpbak, config.xml.jpbak copias de antes de la primera escritura, más el almacén de copias de seguridad por versiones de JoyPro

El archivo se escribe como texto: la declaración, los finales de línea, la sangría, los comentarios de sección, <config>, los atributos raíz y todas las líneas no tocadas quedan byte a byte. Una línea nueva va a su sección, después de la última entrada del mismo tipo con un número de control menor. JoyPro nunca toca los perfiles guardados inputmap_1.xml a inputmap_5.xml ni sus partidas guardadas. Steam Cloud sincroniza la carpeta; aún no está confirmado qué archivos sincroniza.

#Los modos de exportación en X4

Un conflicto es otro control de vuelo en la misma ranura y entrada. Las versiones gemelas de un control para el mapa y el monitor de detalle cuentan como el mismo control.

Modo Qué pasa en inputmap.xml
Solo añadir No se quita nada. Una asignación cuya entrada tiene otro control de vuelo no se escribe y recibe la marca "No escrito en el juego".
Actualizar, conservar las del juego Sus líneas se añaden junto a las demás entradas del control; solo se quitan los conflictos.
Actualizar, gana mi perfil Como arriba, y un control que usted asigna pierde sus demás líneas en las ranuras fijadas de dispositivos conectados (con la opción de teclado, también sus líneas de teclado).
Sustituir en mis dispositivos Se quitan las asignaciones de vuelo de las ranuras escritas que no están en su perfil, también las asignaciones de vuelo de gamepad de serie en la ranura 1.
+ Borrar también mis otros dispositivos Lo mismo para las ranuras que config.xml fija a dispositivos conectados que la exportación no usa. Una ranura sin dispositivo fijado se deja como está: su dispositivo es desconocido.

El menú de X4 asigna algunos controles juntos: "Toggle Travel Mode" pone la misma entrada también dentro del mapa, "Dock" también desacopla. JoyPro escribe y quita esos grupos como lo hace el menú, y nunca quita el gemelo "Interact" en primera persona.

#Lo que nunca se toca

  • Controles de menú, de mapa, en primera persona, de opciones y de accesibilidad; entradas del menú radial.
  • Líneas de teclado y ratón; el teclado solo se escribe con la opción de teclado, solo para controles de vuelo, nunca con las teclas que rechaza el menú de X4 (Escape, Delete, Ctrl+X/C/V ...).
  • Las ranuras de dispositivos que no están conectados o no están fijados, los gamepads, los dispositivos ignorados de la importación y el dispositivo vJoy al que JoyPro canaliza.
  • Todas las líneas de <config> que JoyPro no configura.

#Curvas y ajustes del juego

  • Granularidad: un único conjunto de asignaciones para todas las naves (los controles de vuelo espacial).
  • Las inversiones son un valor por control para todos los dispositivos (invert_steering_yaw, _pitch, _roll, invert_throttle, invert_strafe_*). Su relación conserva la dirección de DCS; los mapas HOTAS propios de X4 cuentan pitch, roll y acelerador como invertidos, así que para esos JoyPro pone el parámetro a su inversión al revés. Solo pone un parámetro cuando todos los ejes de JoyPro de ese control coinciden.
  • El acelerador bidireccional sigue el Deslizador de la relación del acelerador: Deslizador = solo hacia delante, sin Deslizador = el centro es empuje cero.
  • Zona muerta: X4 tiene una sola zona muerta para todos los ejes de todos los joysticks. Las zonas muertas de las relaciones no se escriben (la exportación lo indica); configure la zona muerta del juego en Configuración > Ajustes de force feedback de los juegos (elija X4) o con engine ffb set. En el mismo lugar están la dirección adaptativa, la vibración, el auto-roll y el modo gamepad. Un ajuste que guarde allí se impone a las relaciones, con un aviso cuando las invierte.
  • Sin curvas ni saturación por eje en X4; sin force feedback; sin telemetría.
  • Vigilancia: una asignación u opción que usted cambia en el juego se detecta después de que se cierra (inputmap.xml y config.xml), y JoyPro pregunta si debe adoptarla.
  • HUD: el HUD encuentra el juego por su proceso y muestra sus asignaciones de X4.

#X Rebirth y X3

X Rebirth usa las mismas palabras de inputmap.xml que X4, pero su lista de comandos necesitaría su propia extracción a partir de una instalación. X3 (Reunion, Terran Conflict, Albion Prelude) tiene otro motor y un formato de archivo desconocido. Ambos solo están documentados: JoyPro no los importa ni los exporta.

Detalles técnicos internos

#Por dentro de la integración de X4

flowchart LR
  D["Su dispositivo<br/>(GUID de instancia)"] --> C["config.xml<br/>joysticks"]
  C --> S["Fijado a una ranura:<br/>ranura 1 ... 8"]
  C --> K["Sin fijar o desactivado:<br/>se omite; asígnelo<br/>una vez en X4"]
  P["Su perfil"] --> E["engine x4 export"]
  S --> E
  E --> I["inputmap.xml<br/>asignaciones por ranura"]
  E --> O["opciones de todo el juego:<br/>inversiones, modo del acelerador"]
X4 nombra un joystick por su ranura. Un dispositivo sin ranura fija se omite.

Código: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs y el modelo de ajustes engine\FfbModels\X4.cs.

  • Ranuras: una asignación nombra una fuente: INPUT_SOURCE_JOYBUTTONS (botones y hat) o INPUT_SOURCE_JOYAXES, sin sufijo para la ranura 1 y con _2 a _8 para las demás. config.xml asigna los dispositivos a las ranuras por el GUID de instancia de DirectInput, escrito en la forma propia de X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00}); num de 0 a 7 es la ranura, disabled="1" significa ninguna. JoyPro solo escribe en las ranuras cuya entrada actual y activada coincide con un dispositivo conectado.
  • Códigos: los botones 1 a 11 usan los nombres de gamepad de X4 (INPUT_XBUTTON_A ... BIGBUTTON), del 12 al 64 INPUT_XBUTTON_12 ...; el hat INPUT_XBUTTON_DPAD_* (ocho direcciones); los ejes INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Los rangos no llevan sgn. Teclado: INPUT_KEYCODE_<DIK> con _SHIFT / _CONTROL.
  • Lista de comandos: engine x4 refresh-db lee gameoptions.lua y la página de textos en inglés de los archivos .cat/.dat y las tablas de nombres de X4.exe, solo lectura; 128 controles de vuelo espacial (6 ejes, 122 botones). Las filas se leen como "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)". engine x4 catalog la lista, engine x4 paths muestra los archivos encontrados.
  • Importación / exportación: engine x4 import, engine x4 scan; engine x4 export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run.
  • Ajustes del juego: engine ffb set --device * --game X4 --param <key>=<value>; los parámetros se editan en su sitio, uno que falta se añade como última línea de <config>. Una exportación sin asignaciones de X4 escribe igualmente los ajustes guardados.

#Límites conocidos

  • Los dispositivos sin ranura fijada se omiten; JoyPro todavía no los fija por sí mismo.
  • Los modificadores de joystick no se escriben: su marcado en el archivo aún no está confirmado.
  • 64 botones, 8 ejes y un hat por dispositivo; ocho ranuras, compartidas con los gamepads.
  • Vibración: el control deslizante del juego muestra el valor por 100 truncado (21 % aparece como 20); el archivo conserva el valor exacto.
  • Pruebas: engine\tests\smoke\x4.ps1 (también la actualización del catálogo); en el juego tools\e2e\games\X4.ps1 (asignaciones y matriz de modos, en su propia carpeta de perfil) y tools\e2e\games\X4Settings.ps1 (inversiones, modo del acelerador, ajustes del juego).

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