Star Citizen guarda todos sus controles en un archivo, actionmaps.xml, y numera sus palancas como ranuras de joystick js1 a js8. JoyPro lee las asignaciones de nave de ese archivo en su perfil y las vuelve a escribir in situ: solo cambian las acciones de nave y sus ajustes de eje; cada otra línea queda como la escribió el juego. Un dispositivo conserva la ranura que el juego ya le dio, así que sus asignaciones no saltan de una palanca a otra.
Star Citizen nativo (sus propios archivos de asignaciones)
- Soporte
- nativo (sus propios archivos de asignaciones)
- Comando del motor
engine starcitizen- Archivo de asignaciones
LIVE\user\client\0\Profiles\default\actionmaps.xml+attributes.xml(XML)- Lista de comandos de
Data.p4k(defaultProfile.xml) y sus perfiles- Prueba en el juego
- 54/54 pasos superados (2026-10-10)
- ✓ 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 Star Citizen cerrado
Antes: conecte todos los dispositivos que use.
Después: sus asignaciones están en Options > Controls.
¿Ya asignó botones en Star Citizen 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 Star Citizen
- Importar: las asignaciones de su nave en palancas, aceleradores y pedales llegan a su perfil, con sus zonas muertas, curvas e inversiones. También llegan las asignaciones de joystick predeterminadas del propio juego en js1, para que una exportación posterior no las pierda.
- Relaciones: una relación es una función en todos los juegos. "Tren de aterrizaje" puede ser el mismo interruptor en Star Citizen, DCS y Elite Dangerous.
- Exportar: JoyPro edita
actionmaps.xmlin situ. Las asignaciones a pie, de vehículo y de menú, y las de ratón y mando, quedan como están.
#Importar sus asignaciones de Star Citizen
- Abra Iniciar. Si la tarjeta de Star Citizen pide una lista de comandos, pulse Crear lista: JoyPro lee las acciones del juego de su instalación (
Data.p4k, solo lectura). Tras un parche del juego, Actualizar en la tarjeta añade las acciones nuevas. - Pulse Importar en la tarjeta de Star Citizen. Deje Añadir a mi perfil. Marque Tomar también las teclas del teclado solo si también quiere las teclas de su nave en JoyPro.
- Pulse Importar ahora. Ver mis relaciones abre lo que ha entrado.


#Crear y comprobar relaciones
Cada acción de nave es una entrada en una relación. Una la misma función de sus otros juegos con el flujo de relaciones y luego pulse Comprobar en la página Exportar: encuentra un botón que hace dos cosas en su nave antes de que lo haga el juego.
#Exportar a Star Citizen
- Cierre Star Citizen. El juego reescribe
actionmaps.xmlal salir, así que JoyPro se niega a escribir mientras está en marcha. - Abra Exportar y marque la tarjeta de Star Citizen.
- 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 Options > Controls desde el menú principal. Elija su dispositivo (Joystick / HOTAS 1, 2 ...): su zona muerta y su saturación son las que ajustó en JoyPro; Inversion Settings y Joystick Sensitivity Curves (Flight > Flight Movement) muestran sus inversiones, exponentes y curvas. Las asignaciones de su nave están en la ranura de joystick de cada dispositivo. Los valores predeterminados del juego que JoyPro desactivó aparecen vacíos. El menú muestra la saturación 0.01 más alta que la del archivo (0.87 aparece como 0.88); el juego conserva el valor exacto.
#Lo que hace usted mismo en Star Citizen
- Nada más para las asignaciones. Conecte todos los dispositivos que use antes de exportar: un dispositivo que no esté conectado conserva su ranura y sus asignaciones, pero JoyPro no puede darle nuevas.
- Si el juego está en otra carpeta distinta de la detectada, indique la ruta una vez en la página Exportar en Opciones y rutas (para expertos), o vincule la carpeta en Configuración > Juegos.
#Errores frecuentes
- "Star Citizen está en ejecución": cierre el juego (también desde el launcher) y exporte de nuevo.
- Las asignaciones acabaron en la palanca equivocada: deje SC: preferir orden local activado (el valor predeterminado). Desactivado, las ranuras siguen el orden en que Windows informa de los dispositivos, lo que puede mover todas las asignaciones de un dispositivo a otro número js.
- Un dispositivo no obtuvo ranura: el juego tiene ocho ranuras de joystick. JoyPro fusiona en una ranura las entradas duplicadas de una misma palanca (el nombre del juego y el nombre de JoyPro), pero más de ocho dispositivos conectados con asignaciones no caben.
- Una asignación predeterminada volvió a js1: vuelve cuando el dispositivo de js1 no está conectado al exportar. Conéctelo y exporte de nuevo con Sustituir.
#Archivos que JoyPro lee y escribe
| Archivo | Qué es |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
sus reasignaciones, las ranuras de joystick (<options type="joystick" instance="1..8" Product="...">), los grupos de opciones por ranura (inversión, exponente, curva, sensibilidad) y las opciones de dispositivo (zona muerta, saturación por eje físico) |
...\Profiles\default\attributes.xml |
ajustes de todo el juego (<Attr name="..." value="..."/>), solo los valores que difieren de los predeterminados del juego |
...\Profiles\default\actionmaps.jp |
la copia de JoyPro del archivo escrito con los nombres de las relaciones como comentarios, que la próxima importación vuelve a leer |
...\Profiles\default\actionmaps.xml.joypro.json |
los ajustes de eje que JoyPro escribió por última vez, para que "Actualizar" distinga un valor que usted cambió en el juego de uno propio |
actionmaps.xml.jpbak, attributes.xml.jpbak |
copias de antes de la primera escritura de una exportación, más el almacén de copias de seguridad con versiones de JoyPro |
La exportación edita actionmaps.xml en su sitio: solo cambian las reasignaciones de nave y los ajustes de eje de las reasignaciones de eje que escribe JoyPro. Los demás mapas de acciones, las reasignaciones de ratón y gamepad, los modos de activación, los modificadores, los demás grupos de opciones y las opciones de dispositivo quedan byte a byte. Un perfil sin asignaciones de Star Citizen deja el archivo como está.
#Las ranuras de joystick
Star Citizen nombra cada asignación de joystick por su ranura: js1_button3, js2_x. El archivo lista qué dispositivo ocupa qué ranura, por el nombre de producto DirectInput y el GUID de producto del dispositivo.
- Preferir orden local (activado por defecto): un dispositivo conectado que el archivo ya nombra conserva esa ranura. Los demás dispositivos llenan las ranuras libres en el orden en que Windows los informa.
- Un dispositivo, una ranura: la misma palanca listada dos veces (con el nombre del juego y con el nombre de instancia de JoyPro, o una segunda entrada antigua) ocupa una sola ranura. La exportación quita las entradas duplicadas y mueve sus asignaciones a la ranura que conserva el dispositivo. Las entradas de dispositivos que no están conectados se quedan.
- Dos dispositivos conectados del mismo modelo se mantienen separados.
- Un dispositivo que cambia de ranura se lleva consigo sus grupos de opciones (inversión, curvas). Un dispositivo que no obtiene ranura pierde los grupos de su ranura antigua, con un aviso.
#Los modos de exportación en Star Citizen
Todos los modos cambian solo acciones de nave. Los mapas a pie, de vehículo y de menú quedan byte a byte.
| Modo | Qué ocurre en el juego |
|---|---|
| Solo añadir | No cambia ninguna asignación del juego. Una acción cuya ranura de joystick ya tiene una reasignación o un valor predeterminado activo lo conserva. Una asignación en una entrada que usa otra acción de nave no se escribe y recibe la marca "No escrito en el juego". |
| Actualizar, conservar las del juego | Su entrada va a la ranura de joystick de la acción (Star Citizen tiene una por acción y tipo de entrada). Una asignación del juego en una entrada a la que usted da otra acción de nave se libera: su reasignación desaparece, o pasa a ser un js1_ vacío cuando la acción tiene un valor predeterminado, para que el predeterminado no vuelva. |
| Actualizar, gana mi perfil | Como arriba; con la opción de teclado, una acción que usted asigna pierde también su reasignación de teclado. |
| Sustituir en mis dispositivos | Los dispositivos escritos conservan solo sus asignaciones de nave. Con un dispositivo en js1, se desactivan los valores predeterminados de js1 del juego que su perfil no tiene. |
| + Borrar también mis otros dispositivos | Los dispositivos conectados sin asignaciones en su perfil pierden sus asignaciones de nave; los valores predeterminados de js1 se desactivan cuando js1 no se usa. |
Opciones en la página Exportar (en Opciones y rutas (para expertos)):
- SC: conservar predeterminados de teclado (activado): el teclado conserva las teclas predeterminadas del juego. Desactivado: se escriben sus asignaciones de teclado y se liberan las teclas predeterminadas que ocupan.
- SC: preferir orden local (activado): vea las ranuras de joystick más arriba.


#Las asignaciones de joystick predeterminadas del juego
Star Citizen tiene asignaciones de joystick predeterminadas que actúan en js1 hasta que una acción recibe allí una reasignación (pitch en Y, yaw en X, roll en la rotación Z, unos cuantos botones). La importación toma cada valor predeterminado activo como una asignación del dispositivo js1, así que su perfil contiene lo que el juego hace de verdad. La exportación no escribe ninguna reasignación para una asignación igual a la predeterminada (solo diferencias reales). Sustituir y Borrar también desactivan los valores predeterminados que su perfil no tiene con una reasignación vacía js1_ , igual que el propio menú del juego escribe una asignación borrada, y solo cuando el dispositivo de js1 está conectado. Así, importar y luego Sustituir + Borrar también deja actionmaps.xml como estaba.
#Lo que nunca se toca
- Asignaciones a pie, de vehículos terrestres y de menú (los vehículos terrestres de Star Citizen cuentan como su propia clase de vehículo).
- Los dispositivos que no están conectados: conservan su ranura y sus reasignaciones.
- Los dispositivos ignorados de la importación y el dispositivo vJoy al que JoyPro envía.
- Las asignaciones de ratón y gamepad; el teclado, salvo que exporte asignaciones de teclado.
- Los modos de activación, los modificadores, los demás grupos de opciones y las opciones de dispositivo.
#Naves, curvas, configuración del juego
- Granularidad: un único conjunto de asignaciones de nave para todas las naves (el juego no tiene asignaciones por nave).
- Curvas de eje, en dos lugares, tal como las guarda el juego: zona muerta y saturación por dispositivo y eje físico; inversión, exponente (1 a 3), una curva de 11 puntos y sensibilidad por ranura y grupo de opciones. El exponente y la curva se excluyen entre sí, como en el menú del juego. A una relación sin valores de Star Citizen se le ajusta su curva de JoyPro: la zona muerta y la saturación van al eje del dispositivo, la curvatura pasa a ser el exponente más cercano, o la curva cuando ningún exponente encaja. No hay eje de un solo lado: el acelerador absoluto y el relativo del juego son acciones separadas.
- Actualizar conserva un valor de eje que usted cambió en el juego (con un aviso); Sustituir y gana mi perfil ponen los valores de su perfil. Una relación neutra deja el valor propio del juego (la vista libre conserva su exponente predeterminado 2.5).
- Ajustes de todo el juego (
attributes.xml): HOTAS thrust invert toggle, el tiempo y el umbral de la retención del acelerador relativo, los modificadores de sensibilidad del IFCS, ESP activado, su intensidad y amortiguación, ESP de torreta, los valores de vuelo por defecto (sticky throttle, limitador de velocidad, coupled, G-safe, auto precision, space brake), invert flight controller y Vibration. Configúrelos en Configuración > Ajustes de force feedback de los juegos (elija Star Citizen) o conengine ffb set. JoyPro cambia solo las líneas que usted configura, en su sitio, y no crea el archivo. El control deslizante de intensidad del ESP termina en 1.00, así que JoyPro ofrece de 0 a 1. - Force feedback: ninguno. Vibration es el único ajuste de este tipo del juego.
- Vigilancia: una asignación o un valor de eje que usted cambia en el menú del juego se detecta después de que el juego se cierra, y JoyPro pregunta si debe adoptarlo. Compara
actionmaps.xml(solo los mapas de acciones de nave) y los ajustes que JoyPro gestiona enattributes.xml. - HUD: el HUD encuentra el juego por su proceso y muestra sus asignaciones de Star Citizen.
#Por dentro de la integración de Star Citizen
flowchart LR
A[("actionmaps.xml")] --> S["Ranura por dispositivo"]
D["Dispositivos conectados"] --> S
P["Su perfil"] --> E["engine starcitizen export"]
S --> E
E --> X["actionmaps.xml"]
E --> T["attributes.xml"]
X --> G["Options ><br/>Controls"]
Código: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, el modelo de eje engine\AxisModels\StarCitizen.cs y el modelo de ajustes engine\FfbModels\StarCitizen.cs.
- Nombres de dispositivo: el
Productde la ranura es el nombre de producto DirectInput y el GUID de producto, separados por dos espacios (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). El juego no reconoce una ranura o un bloquedeviceoptionsescrito con otro nombre (un GUID de instancia): reescribe la ranura con su producto y descarta los grupos de opciones de la ranura. Por eso JoyPro escribe el nombre de producto del dispositivo conectado. - Lista de comandos:
engine db refresh-starcitizenleeData\Libs\Config\defaultProfile.xmldeData.p4k(o de una copia extraída con--source) y lo guarda enDB\StarCitizen\AllBinds.xml: cada acción con su grupo de opciones, el árbol de opciones de joystick (padres y valores predeterminados, qué grupos muestran una curva) y la entrada de joystick predeterminada de la acción.engine starcitizen labelstoma deglobal.inilos nombres que da el juego a los controles. - Importar:
engine starcitizen import(--include-keyboard,--device,--ignore-device); cada reasignación de eje recibe los valores que usa el juego (el grupo hoja de la ranura; si no, el padre más cercano que usted configuró; si no, el predeterminado del juego) y las opciones de dispositivo de su eje, como su ajustegame:StarCitizen.engine starcitizen scanmuestra lo mismo sin cambiar el perfil;engine starcitizen list-deviceslista las ranuras de joystick del archivo. - Exportar:
engine starcitizen export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --prefer-local-order true|false --include-keyboard true|false --ignore-device <d>. Un bloquedeviceoptionsnuevo va antes del primer<options>; varias relaciones en un mismo grupo de opciones o en un mismo eje físico con valores distintos dan un aviso, y gana la primera relación por nombre. - Ajustes del juego:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; una línea existente recibe el valor, una nueva va a su lugar en el orden. - Copias de seguridad:
engine backups listlista las copias; Deshacer última exportación en la tarjeta restaura la más reciente.
#Límites conocidos
- Ocho ranuras de joystick; el límite de botones por dispositivo no se conoce (las fuentes se contradicen).
- Aún no está confirmado dónde quiere el juego un bloque
deviceoptionsnuevo, la interpolación de la curva (el menú dibuja una spline suave por los puntos), el rango del exponente ni si la sensibilidad se aplica a los joysticks. Los rangos de los ajustes de todo el juego no están en los archivos legibles del juego. - Aún no está confirmado si Vibration maneja una palanca con force feedback DirectInput.
- Pruebas:
engine\tests\smoke\starcitizen.ps1(actualización del catálogo, importación de grupos de opciones y curvas, importación + exportación byte a byte, cada ajuste de eje, conflictos, cambios de ranura,attributes.xmlen su sitio); en el juegotools\e2e\games\StarCitizenSettings.ps1(Options del menú principal: ajustes, asignaciones y curvas) ytools\e2e\games\StarCitizen.ps1(matriz de modos de exportación e importación).
Todas las notas técnicas sobre este juego (generadas a partir del repositorio): starcitizen.md.