JoyPro2 Discord GitHub
Juegos

Star Citizen

Mostrar:

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.

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 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.xml in 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

  1. 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.
  2. 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.
  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

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

  1. Cierre Star Citizen. El juego reescribe actionmaps.xml al salir, así que JoyPro se niega a escribir mientras está en marcha.
  2. Abra Exportar y marque la tarjeta de Star Citizen.
  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.
La página ExportarLa página Exportar
La página Exportar
En el juego: Lo que ve en Star Citizen

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.
Avanzado

#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.
Opciones y rutas (para expertos) en la página ExportarOpciones y rutas (para expertos) en la página Exportar
Opciones y rutas (para expertos) en la página Exportar

#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 con engine 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 en attributes.xml.
  • HUD: el HUD encuentra el juego por su proceso y muestra sus asignaciones de Star Citizen.
Detalles técnicos internos

#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"]
Un dispositivo conocido conserva su ranura de joystick (js1 ... js8 en actionmaps.xml). Un dispositivo nuevo obtiene la primera ranura libre; un duplicado obsoleto se elimina. Las reasignaciones de nave se editan en su sitio, los ajustes de todo el juego van a attributes.xml.

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 Product de 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 bloque deviceoptions escrito 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-starcitizen lee Data\Libs\Config\defaultProfile.xml de Data.p4k (o de una copia extraída con --source) y lo guarda en DB\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 labels toma de global.ini los 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 ajuste game:StarCitizen. engine starcitizen scan muestra lo mismo sin cambiar el perfil; engine starcitizen list-devices lista 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 bloque deviceoptions nuevo 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 list lista 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 deviceoptions nuevo, 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.xml en su sitio); en el juego tools\e2e\games\StarCitizenSettings.ps1 (Options del menú principal: ajustes, asignaciones y curvas) y tools\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.