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 enconfig.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.exey 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.
#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 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.xmlin situ, en las ranuras de sus dispositivos. Las asignaciones de menú, primera persona, teclado y ratón se quedan.
#Importar sus asignaciones de X4
- 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).
- 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.
- 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
- Cierre X4. El juego escribe
inputmap.xmlyconfig.xmlal terminar una sesión, así que JoyPro se niega a escribir mientras está en marcha. - Abra Exportar y marque la tarjeta de X4.
- 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.
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.
#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.xmlyconfig.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.
#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"]
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) oINPUT_SOURCE_JOYAXES, sin sufijo para la ranura 1 y con_2a_8para las demás.config.xmlasigna 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});numde 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 64INPUT_XBUTTON_12...; el hatINPUT_XBUTTON_DPAD_*(ocho direcciones); los ejesINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Los rangos no llevansgn. Teclado:INPUT_KEYCODE_<DIK>con_SHIFT/_CONTROL. - Lista de comandos:
engine x4 refresh-dbleegameoptions.luay la página de textos en inglés de los archivos.cat/.daty las tablas de nombres deX4.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 catalogla lista,engine x4 pathsmuestra 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 juegotools\e2e\games\X4.ps1(asignaciones y matriz de modos, en su propia carpeta de perfil) ytools\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.