JoyPro2 Discord GitHub
Flujos principales

Exportar a sus juegos

Mostrar:

Exportar es el paso que hace que sus palancas funcionen en el juego. JoyPro escribe sus relaciones y asignaciones en los archivos de ajustes de control de cada juego, los mismos archivos que guarda el propio menú Controls del juego. Nada se ejecuta en segundo plano mientras vuela: una vez exportado, el juego lee sus propios archivos como siempre.

flowchart LR
  C["1 Comprobar<br/>(opcional)"] --> M["2 Elegir cómo<br/>(4 opciones)"]
  M --> G["3 Marcar juegos,<br/>Exportar juegos marcados"]
  G --> W["Primero la copia de seguridad,<br/>luego se escriben los<br/>archivos del juego"]
El paso 1 solo mira; nunca detiene la exportación. Deshacer última exportación en la tarjeta de un juego devuelve sus archivos. En los juegos solo para Xbox no se escribe nada: usan Iniciar en la página Joystick virtual.
Para principiantes

#Exportar en tres pasos

Abra Exportar en la barra de abajo. La página son tres tarjetas numeradas de arriba abajo:

La página Exportar: comprobar, cómo, juegosLa página Exportar: comprobar, cómo, juegos
La página Exportar: comprobar, cómo, juegos (Las imágenes muestran la aplicación en inglés.)
  1. Compruebe su perfil. Pulse Comprobar ahora. JoyPro busca cosas que saldrían mal en el juego, por ejemplo un botón que hace dos cosas en la misma aeronave. Corrija lo que encuentre (un clic por problema) o déjelo; la comprobación nunca bloquea la exportación. Consulte la Comprobación.
  2. Cómo escribe JoyPro en los juegos. Elija una de cuatro opciones. Si no está seguro, deje la primera: Sustituir en mis dispositivos con Borrar también mis otros dispositivos marcado. Sus palancas harán entonces exactamente lo que dice su perfil, y nada más.
  3. Exportar a juegos. Cada juego para el que su perfil tiene asignaciones recibe una tarjeta con su imagen. Marque los juegos y pulse Exportar juegos marcados, o pulse Exportar ahora en una tarjeta.

Cierre antes el juego. Los juegos escriben sus archivos de control al salir, así que JoyPro se niega a exportar a un juego en marcha y se lo indica.

#¿Qué opción es la adecuada para mí?

Opción Elíjala cuando Qué pasa con las asignaciones propias del juego
Sustituir en mis dispositivos JoyPro es el lugar donde configura sus palancas En los dispositivos de su perfil, solo quedan sus asignaciones (para las aeronaves que exporta).
Actualizar, conservar las del juego También asigna cosas dentro del juego y quiere conservarlas Sus asignaciones entran; una asignación del juego solo se quita donde está en un botón que usted usa para otra cosa.
Actualizar, gana mi perfil Como la anterior, pero movió acciones a otros botones en JoyPro Como arriba, y cada acción que asigna pierde sus otros botones en el juego, así que un cambio de botón realmente lo mueve.
Solo añadir Está probando JoyPro por primera vez No se quita nada. Si el juego ya usa un botón para otra cosa, su asignación se deja fuera y la Comprobación se lo indica.

Borrar también mis otros dispositivos (una casilla bajo las opciones): los dispositivos conectados que no tienen asignaciones en su perfil pierden sus asignaciones en las aeronaves exportadas. Déjela marcada si quiere empezar limpio; desmárquela si usa un segundo dispositivo solo dentro del juego.

#Seguro por diseño

  • Antes de que JoyPro cambie un archivo del juego, lo copia en una copia de seguridad. Cada tarjeta tiene Deshacer última exportación: devuelve los archivos exactamente como estaban, byte a byte.
  • La primera exportación a un juego que ya tiene sus propias asignaciones pregunta una vez: "¿Importar primero?". Elija Importar primero si quiere conservar lo que hizo en el juego, o Exportar de todos modos para sustituirlo.
  • Los dispositivos que no están conectados conservan sus asignaciones. Sus asignaciones de ratón y mando nunca se tocan.

#Lo que nota en el juego

Inicie el juego y abra su menú de controles: sus asignaciones están allí, en la columna de cada dispositivo, con los nombres que usa el juego. En DCS aparecen por aeronave; en Star Citizen, por acción de nave; en IL-2, en Key mapping. La sección En el juego más abajo enumera cada tipo de juego.

#Otras formas en que sus asignaciones llegan al juego

Forma Qué hace
Escribir en mi juego (la configuración rápida) La exportación de la configuración rápida. Escribe los juegos que configuró, con la misma copia de seguridad. Consulte Inicio rápido.
El mando simulado (mando Xbox virtual) En ACE COMBAT 8 y Hell Let Loose: Vietnam no se escribe nada. Su exportación lo indica. Su palanca maneja un mando simulado mientras Iniciar está activado. Consulte Juegos solo para Xbox.
La tablilla de rodilla de DCS No es una exportación de asignaciones: una página por aeronave que muestra en la cabina lo que hacen sus botones. Consulte la tablilla de rodilla.
Avanzado

#Los modos en detalle

"La misma entrada" significa el mismo dispositivo, el mismo botón o eje y los mismos modificadores, en la misma aeronave (o nave, vehículo) cuando el juego guarda las asignaciones por aeronave. Todos los modos trabajan solo en las aeronaves de la exportación.

Solo añadir Actualizar, conservar Actualizar, gana el perfil Reemplazar
Sus asignaciones se escriben donde la entrada está libre redactado redactado redactado
Una asignación del juego en una entrada que usted usa para otra acción se conserva; su asignación no se escribe y se marca se quita se quita se quita
Una asignación del juego de la misma acción en otra entrada (después de un Mover) conservado se conserva (la acción está en ambas entradas) se quita se quita en los dispositivos escritos
Otras asignaciones del juego en sus dispositivos conservado conservado conservado se quitan
Valores predeterminados del juego en sus dispositivos conservado conservado se conservan, salvo que contengan una de sus acciones se quitan
Dispositivos conectados sin asignaciones en el perfil conservado conservado se les quitan sus acciones se conservan, salvo con Borrar también mis otros dispositivos
Dispositivos que no están conectados, ratón, gamepad nunca se tocan nunca se tocan nunca se tocan nunca se tocan
Teclado solo con la opción de teclado solo con la opción de teclado solo con la opción de teclado solo con la opción de teclado
Aeronaves que no están en la exportación nunca se tocan nunca se tocan nunca se tocan nunca se tocan (DCS: salvo con la opción "mis dispositivos pierden las asignaciones predeterminadas de DCS también en las demás aeronaves")

Borrar también mis otros dispositivos no se usa con Solo añadir. Con los demás modos borra los dispositivos conectados que el perfil no usa, en las aeronaves exportadas (DCS: también sus valores predeterminados de DCS). Los dispositivos que la importación ignora y el dispositivo vJoy al que JoyPro canaliza nunca se borran.

Desde la 2.5.0, el valor predeterminado es Sustituir en mis dispositivos + Borrar también mis otros dispositivos (como en JoyPro 1). Un modo que usted haya elegido se recuerda.

#En resumen: una de sus asignaciones, cuatro modos

Modo El juego usa su botón para otra cosa Su acción tiene otros botones en el juego Otros dispositivos conectados
Sustituir en mis dispositivos Esa asignación se quita; la suya se escribe Se quitan en los dispositivos escritos Se conservan, salvo con Borrar también mis otros dispositivos
Actualizar, gana mi perfil Esa asignación se quita; la suya se escribe Quitado Se les quitan sus acciones
Actualizar, conservar las del juego Esa asignación se quita; la suya se escribe Se conservan: la acción está en ambos Conservadas
Solo añadir Se conserva; la suya no se escribe y se marca Conservadas Conservadas

#Opciones por juego

En Opciones y rutas (para expertos):

  • DCS: la lista Aeronaves... en la tarjeta de DCS (solo se escriben las aeronaves marcadas); DCS: conservar predeterminados de teclado (activado); mis dispositivos pierden las asignaciones predeterminadas de DCS también en las demás aeronaves (desactivado).
  • Star Citizen: SC: conservar predeterminados de teclado, preferir el orden local.
  • Los demás juegos: una casilla Simulación que muestra lo que cambiaría sin escribir nada.
  • Rutas: una carpeta Saved Games o de configuración distinta por juego; Rutas y dispositivos ignorados propios de este perfil da al perfil abierto las suyas propias en lugar de las del PC.

#Marcas: "No escrito en el juego"

Solo añadir (y cualquier modo en el que un juego no tenga sitio libre para otra entrada, por ejemplo Elite Dangerous con dos entradas por acción) deja fuera algunas asignaciones. El perfil recuerda cada una con la acción del juego que ocupa la entrada y la fecha; la comprobación muestra una tarjeta por marca con Exportar con 'Actualizar' para sustituirlo, Mover a otro botón y Dejar como está. Cada exportación reemplaza las marcas de su juego y sus aeronaves, así que una marca desaparece cuando una exportación posterior escribe la asignación.

#Ajustes recordados

El modo, la casilla Borrar también, las opciones por juego y las rutas se guardan en la configuración de JoyPro; los juegos y las aeronaves de DCS que usted marcó se guardan por perfil. Sustituir y Borrar también preguntan antes de cada exportación (Configuración > Confirmaciones puede desactivar la pregunta).

#Después de la exportación

  • Deshacer última exportación en la tarjeta restaura la copia de seguridad más reciente de ese juego. La lista completa está en Copias de configuración de juegos, al final de la página Exportar.
  • La exportación registra los archivos del juego para la vigilancia de juegos: la propia exportación de JoyPro nunca pregunta después "¿adoptar los cambios?"; un cambio que usted haga luego en el juego, sí (la vigilancia).
  • JoyPro guarda sus propios datos junto al archivo del juego, así que una importación posterior recupera los nombres de las relaciones, los grupos, los modificadores y las curvas (reimportación).

#En el juego

Lo que ve el jugador después de una exportación depende del tipo de juego. Todos los juegos de abajo siguen las mismas reglas: JoyPro solo escribe las acciones de su lista de comandos, se niega a escribir mientras el juego está en marcha, primero hace una copia de seguridad de los archivos y nunca adivina un dispositivo o una acción que no puede emparejar (lo omite con un aviso).

En el juego: Simuladores de vuelo: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro se hace cargo de los dispositivos que escribe. Con Sustituir desaparecen todas las demás asignaciones de esos dispositivos en las aeronaves exportadas; con Borrar también se borran también los demás dispositivos conectados (en DCS, también sus valores predeterminados de DCS).

  • DCS World: en Options > Controls, elija la aeronave: sus asignaciones están en la columna del dispositivo, los valores predeterminados quitados aparecen como celdas vacías y sus modificadores están en la lista de modificadores. Solo cambian las aeronaves marcadas. JoyPro solo escribe las diferencias con los valores predeterminados de DCS, como hace el propio DCS.
  • IL-2 Great Battles: Settings > Key mapping muestra sus asignaciones y las respuestas de los ejes. Las líneas del ratón y las líneas que JoyPro no conoce se quedan.
  • IL-2 Korea: el perfil de key mapping "General".
  • Falcon BMS: el launcher crea el archivo de teclas y el mapeo de ejes en su siguiente Launch, así que inicie BMS a través del launcher.
  • MSFS 2024 / 2020: en Controls, el dispositivo muestra el preajuste de JoyPro.
  • X-Plane 11 / 12: Settings > Joystick muestra las asignaciones.
En el juego: Juegos con infantería, vehículos o menús: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro toca solo las acciones de vuelo (aeronave, helicóptero, nave espacial). Sus asignaciones a pie, de vehículo y de menú quedan byte a byte. Sustituir y Borrar también liberan solo las acciones de vuelo que JoyPro conoce.

  • Star Citizen: Options > Keybindings muestra las acciones de nave en sus joysticks (js1, js2, ...). Con Sustituir o Borrar también, los valores predeterminados de joystick propios del juego en js1 se desactivan cuando js1 se escribe o no se usa.
  • War Thunder: Controls muestra las asignaciones de aeronave; los controles de tanques y barcos no cambian.
  • Arma 3 / Arma 2: los ajustes de teclas del perfil; solo cambian las acciones de aviones y helicópteros.
En el juego: Juegos espaciales: Elite Dangerous, X4: Foundations
  • Elite Dangerous guarda dos entradas por acción (Primary y Secondary). Una asignación sin sitio libre recibe una marca "No escrito" con "Mover a otro botón" o "Dejar como está". Las asignaciones a pie y de SRV se quedan.
  • X4: los ajustes de entrada del juego; solo cambian las acciones de nave catalogadas.
En el juego: Juegos que leen un solo dispositivo o solo un mando Xbox
  • Juegos configurados con vJoy (juegos que solo leen unos pocos dispositivos): la exportación escribe las asignaciones en el dispositivo vJoy. JoyPro copia sus palancas en él mientras juega, y HidHide oculta sus dispositivos reales solo para ese juego. El juego ve un único dispositivo con todo. Consulte Joystick virtual.
  • Juegos solo para Xbox (ACE COMBAT 8, Hell Let Loose: Vietnam): no se escribe nada, y la exportación lo indica. Su palanca maneja un mando simulado (mando Xbox virtual) mientras Iniciar está activado. No hace falta HidHide. Consulte Jugar a un juego solo para Xbox con un HOTAS.
Detalles técnicos internos

#Cómo funciona por dentro

Una exportación, desde el clic hasta los archivos escritos:

# Quién Qué pasa
1 Usted Pulse Exportar juegos marcados en la página Exportar.
2 JoyPro Pregunta al motor por el juego (profile game-state --game <id>): importado, exportado, tiene asignaciones.
3 JoyPro Le pregunta cuando hace falta: una primera exportación ("¿Importar primero?") o un modo que quita asignaciones (Configuración > Confirmaciones).
4 Motor Ejecuta <game> export --mode <m> --nuke-untouched-devices <b> ...: se niega mientras el juego está en marcha, hace copia de cada archivo (GameBackups y .jpbak) y solo escribe acciones catalogadas.
5 Motor Guarda el registro de sincronización (huella y estado base) y las marcas de exportación, y luego responde: escrito, omitido, SkippedTakenInputs.
6 JoyPro La tarjeta del juego muestra "Exportado 14:02", y Deshacer última exportación queda listo.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) llaman a AskAboutFirstExportAsync (engine profile game-state) y a ConfirmRiskyExportAsync; luego ExportGameAsync elige el exportador de la tarjeta: dcs, il2, starcitizen o un juego del registro. El comando se construye a partir de los ajustes de la página, p. ej. RunDcsExportAsync: engine dcs export --mode clean --keep-keyboard-defaults true --nuke-untouched-devices true --clean-all-aircraft false --ignore-device <d> --planes F-16C_50|FA-18C_hornet. Cada llamada al motor pasa por un único lugar, RunEngineAsync, con --profile y --status true (el progreso del área de actividad y Cancelar), en serie para que dos comandos nunca escriban a la vez.
  2. Motor. engine\Program.cs dirige dcs / il2 / starcitizen a sus exportadores y todos los demás juegos a Games.GameRegistry (una GameIntegration por juego). DCS: EngineDcsExport.Modes.cs calcula, por archivo de dispositivo, las asignaciones que DCS tiene activas (perfil limpio menos removed, más added y changed), decide cuáles deben estar activas y escribe solo las diferencias reales con los valores predeterminados.
  3. Seguridad. GameExportSafety.BackupBeforeOverwrite copia cada archivo a <file>.jpbak y al almacén de copias de seguridad con versiones (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ con manifest.json; se guardan los 30 conjuntos más recientes por juego). Los juegos del registro (Nuclear Option) reciben una instantánea de los valores que pueden cambiar. Un archivo que crea la exportación se registra como "no existía", así que una restauración lo vuelve a quitar.
  4. Después. El registro de sincronización (<data>\Sync\<game>.json: tamaño, hora y SHA-256 por archivo y un hash de cada asignación) hace que la vigilancia no salte por el propio cambio de JoyPro. ExportSkippedBinds.cs llena SkippedTakenInputs; el comando de exportación los convierte en las marcas del perfil. El historial del perfil guarda un punto de control antes de cada exportación.

#Los archivos que recibe cada juego

Juego Archivos
DCS World por aeronave y dispositivo Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, un .jp al lado, el modifiers.lua de la aeronave
IL-2 Great Battles data\input\global.actions (líneas nuevas al final, se conserva el orden), las respuestas de eje, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS el User\Config\Setup.v100.* {GUID}.xml del lanzador por dispositivo
MSFS 2024 / 2020 perfiles de entrada (2024: el paquete de presets joypro-input-profiles en la carpeta Community y los perfiles de Steam)
X-Plane 11 / 12 las preferencias de joystick en Output\preferences
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml y actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
Juegos del registro su archivo de configuración y <config>.joypro-meta.json

Marcas de asignaciones no escritas: engine export-marks list, engine export-marks dismiss. Ajustes: export-settings.json (ModeChosenByUser); el valor predeterminado del motor sin --mode es merge-overwrite.

#Cada modo en la línea de comandos

Opción en la GUI Opciones del motor
Sustituir en mis dispositivos + Borrar también mis otros dispositivos (predeterminado) --mode clean --nuke-untouched-devices true
Sustituir en mis dispositivos --mode clean --nuke-untouched-devices false
Actualizar, gana mi perfil (+ Borrar también) --mode merge-overwrite --nuke-untouched-devices true|false
Actualizar, conservar las del juego (+ Borrar también) --mode merge --nuke-untouched-devices true|false
Solo añadir --mode add (nuke no se usa)

Por juego: engine dcs export, engine il2 export, engine starcitizen export, y engine <game> export para cada juego del registro (por ejemplo engine warthunder export, engine msfs2024 export, engine xplane12 export; cada uno acepta --mode, --dry-run, --include-keyboard y --nuke-untouched-devices). Deshacer: engine backups restore. Pruebas: engine\tests\smoke\dcsexportmodes.ps1 (cada modo, ida y vuelta, deshacer byte a byte) y engine\tests\smoke\roundtrip.ps1 (importar, clean + nuke, volver a importar deja el juego como estaba).