JoyPro2 Discord GitHub
Flujos principales

Importar un juego

Mostrar:

Importar lee los ajustes de control que ha guardado un juego y los convierte en un perfil de JoyPro: una relación por función con su botón o eje. Es el inicio más rápido: entra todo lo que ya configuró en sus juegos, y a partir de entonces JoyPro lo mantiene en un solo lugar.

flowchart LR
  G["Los archivos de control<br/>de su juego"] --> I["Importar"]
  D["Sus dispositivos<br/>conectados"] --> I
  I --> P["Su perfil:<br/>relaciones, asignaciones,<br/>modificadores, curvas"]
Importar solo lee. El juego conserva sus asignaciones exactamente como están.
Para principiantes

#Importar en tres clics

  1. Abra Iniciar (el primer botón de la barra inferior). En Sus juegos, cada juego que JoyPro encontró en su PC tiene una tarjeta con su imagen. Pulse Importar en el juego al que más juega.
  2. JoyPro pregunta cómo:
    • Añadir a mi perfil (recomendado) conserva lo que tiene y añade las asignaciones del juego.
    • Empezar de nuevo desde este juego sustituye sus relaciones por lo que tiene el juego (JoyPro guarda antes una copia de su perfil).
    • Tomar también las teclas del teclado trae también los comandos de vuelo del teclado. Las asignaciones de dispositivos siempre se toman.
    • Para DCS: Todas mis aeronaves de DCS, o desmárquelo y elija aeronaves.
  3. Pulse Importar ahora. Un momento después, la tarjeta dice "Hecho: su perfil tiene ahora 214 relaciones (180 asignadas)" y Ver mis relaciones las abre. En cambio, Ver primero muestra lo que tiene el juego, sin cambiar nada.
La página de Inicio con sus juegos y dispositivosLa página de Inicio con sus juegos y dispositivos
La página de Inicio con sus juegos y dispositivos (Las imágenes muestran la aplicación en inglés.)

¿No hay ningún perfil abierto? JoyPro crea uno y a partir de entonces lo guarda automáticamente (no hay botón Guardar: cada cambio se guarda y se puede deshacer, también después de reiniciar).

#¿Qué cambia en el juego?

Nada. Importar solo lee los archivos del juego. El juego conserva sus asignaciones exactamente como están, exporte usted después o no.

#Importar y luego dejar que JoyPro rellene los huecos

En la página de Inicio, la tarjeta "Configurar sus dispositivos" muestra los juegos en los que hizo asignaciones usted mismo. Importar y luego rellenar huecos importa primero un juego así. Luego Rellenar huecos ahora... pone las funciones importantes en los botones que siguen libres. Sus propias asignaciones se quedan. Para los juegos que ya están en su perfil, la tarjeta ofrece Rellenar huecos....

#Antes de su primera importación: la lista de comandos

JoyPro necesita conocer los comandos de cada juego (sus nombres e ids). Crea esta lista una vez a partir de su propia instalación. Cuando falta una lista, la página de Inicio muestra Crear lista (o Crear todas las listas que faltan); una tarjeta de juego ofrece Actualizar tras una actualización del juego. Esto tarda desde unos segundos hasta unos minutos (DCS lee cada módulo).

Avanzado

#Opciones y lo que hacen

Opción Predeterminado Efecto
Añadir a mi perfil / Empezar de nuevo Añadir Añadir combina con el perfil abierto; Empezar de nuevo reemplaza sus relaciones tras una confirmación y una copia del perfil.
Tomar también las teclas del teclado su última elección También entran los comandos de vuelo asignados a teclas.
Importar también dispositivos no conectados activado También se importan los dispositivos que no están conectados ahora (útil para una palanca que conecte más tarde). Desactivado: se omiten y se cuentan.
Tratar los dispositivos con el mismo nombre como un solo dispositivo activado Windows da de vez en cuando un ID nuevo a un dispositivo; sus archivos antiguos y nuevos se leen como un solo dispositivo con el ID conectado. Dos dispositivos idénticos conectados a la vez se mantienen separados.
Incluir predeterminados (DCS, forma para expertos) activado Entran todas las asignaciones predeterminadas que DCS tiene activas para un dispositivo importado, para que una importación seguida de una exportación con Sustituir + Borrar también deje DCS como estaba. Sus propias asignaciones se imponen a un valor predeterminado en la misma entrada.
Importar invertido / deslizador / curvatura / zona muerta / saturación (forma para expertos) desactivado Toma los valores configurados en el juego para las asignaciones que JoyPro no exportó por sí mismo. Una asignación que exportó JoyPro recupera su ajuste sin estas opciones.
DCS: ignorar aeronaves *_easy desactivado Las copias de aeronaves del modo fácil se dejan fuera.

La importación para expertos (página Inicio, debajo de las tarjetas, y la página Avanzado) ofrece todas las opciones del motor por juego con Escanear (vista previa), Importar y Exportar. Cada elección se recuerda para la próxima importación.

#Los nombres, los grupos y los modificadores vuelven

Un archivo de juego solo contiene el dispositivo, la entrada y quizá una curva. La exportación de JoyPro guarda sus propios datos al lado, y una importación los vuelve a leer:

Juego Datos de JoyPro Se recupera
DCS <aircraft>\joystick\<device>.jp, modifiers.lua nombre de la relación, grupos (en orden), modificadores con nombre, inversión, deslizador, zona muerta, saturación, curva
IL-2 Great Battles data\input\jp.actions nombre, grupos, alias, modificadores, el ajuste exacto
Juegos del registro (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json nombre, grupos, alias, modificadores, ajuste
Star Citizen actionmaps.jp nombres

Gana el estado actual del juego: una curva que usted cambió en DCS después de la exportación se conserva. Las asignaciones que JoyPro nunca exportó reciben un nombre formado a partir de la acción del juego y los grupos DCS, IL2 o GENERATED + juego.

#Dos protecciones

  • Cambios aún no exportados. Si cambió asignaciones en JoyPro y no las ha exportado a este juego, una importación traería de vuelta las asignaciones antiguas. JoyPro pregunta antes.
  • ¿Ya importado? Cuando el perfil tiene el juego, los cambios que haga después en el juego entran a través de la vigilancia de juegos (pregunta después de que el juego se cierre); volver a importar sigue siendo un clic.
En el juego: Lo que lee la importación, por tipo de juego

Importar nunca escribe en una carpeta del juego. Lo que lee:

  • DCS: las asignaciones de cada aeronave y dispositivo, sus modificadores y, con "Incluir predeterminados", las asignaciones predeterminadas que DCS tiene para cada dispositivo.
  • IL-2 Great Battles / Korea: el key mapping y las respuestas de los ejes.
  • Star Citizen: las keybindings de la rama (LIVE, PTU ...), con los valores predeterminados de joystick del juego en js1.
  • Juegos con infantería o vehículos (War Thunder, Arma, Reforger, WARDOGS ...): solo las acciones de vuelo; todo lo demás se ignora, no se borra.
  • MSFS: los perfiles de entrada del simulador (versión de Steam o de Microsoft Store) y, si se pide, los preajustes predeterminados del simulador.

Los dispositivos que el juego no puede distinguir (dos dispositivos de un mismo modelo en algunos juegos) y las asignaciones de medio eje (Elite) se omiten y se nombran en el resultado.

Detalles técnicos internos

#Cómo funciona por dentro

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Llama a AskAboutUnexportedChangesAsync (motor sync pending), confirma Empezar de nuevo y guarda una copia del perfil (BackupProfileBeforeChange("before-import")); luego llama a la importación del juego: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync o ImportRegistryGameAsync. Ver primero ejecuta lo mismo con scan (PreviewImportWizardAsync) y abre el panel Salida.
  2. Motor. Para DCS: engine dcs import [--path <Saved Games\DCS>] --merge --include-defaults [--plane <a> --plane <b>] --include-keyboard true|false --ignore-easy-planes false --only-connected false --merge-same-name true. El importador lee cada archivo de dispositivo, identifica el dispositivo por su GUID de instancia de DirectInput y su nombre, asigna cada id de comando a la lista de comandos del juego (DB\<game> en %LOCALAPPDATA%\JoyPro2\GameData) y crea una relación por función y entrada. Las correcciones al cargar (--load-corrections, --correction-mode) reasignan los ids de comando renombrados con una puntuación de seguridad.
  3. Perfil. Las relaciones se combinan por nombre y por la misma entrada; los modificadores se crean a partir de modifiers.lua (DCS) o de los ajustes de shift del juego. El perfil se guarda de forma atómica y cada guardado es una versión en <data>\ProfileHistory (Deshacer funciona también tras reiniciar).
  4. Vigilancia. Una importación de un juego sin registro de sincronización registra los archivos del juego, para que se detecten los cambios que haga después en el juego (<data>\Sync\<game>.json).

#Los archivos que lee

Juego Archivos
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua y modifiers.lua, más los perfiles limpios que JoyPro creó a partir de su instalación de DCS
IL-2 Great Battles / Korea data\input\*.actions y las respuestas de eje
Star Citizen actionmaps.xml de la rama
MSFS la carpeta remota de Steam o la partida guardada de Microsoft Store

Las opciones de la GUI como opciones del motor: Añadir --merge, teclado --include-keyboard true, dispositivos no conectados --only-connected false, mismo nombre --merge-same-name true, aeronaves fáciles --ignore-easy-planes true. La protección para cambios aún no exportados es engine sync pending.

Comandos del motor: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import y engine <game> import para cada juego del registro (por ejemplo engine warthunder import, engine msfs2024 import). Reglas de reimportación: reimportación. Pruebas: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.