JoyPro2 Discord GitHub
Flussi principali

Importare un gioco

Mostra:

L'importazione legge le impostazioni dei comandi che un gioco ha salvato e le trasforma in un profilo JoyPro: una relazione per funzione con il suo pulsante o asse. È il modo più rapido per cominciare: entra tutto ciò che hai già configurato nei tuoi giochi, e da lì in poi JoyPro lo tiene in un unico posto.

flowchart LR
  G["I file dei comandi<br/>del tuo gioco"] --> I["Importa"]
  D["I tuoi dispositivi<br/>collegati"] --> I
  I --> P["Il tuo profilo:<br/>relazioni, assegnazioni,<br/>modificatori, curve"]
L'importazione si limita a leggere. Il gioco tiene le sue assegnazioni esattamente come sono.
Per principianti

#Importare in tre clic

  1. Apri Avvia (il primo pulsante nella barra in basso). Sotto I tuoi giochi ogni gioco che JoyPro ha trovato sul tuo PC ha una scheda con la sua immagine. Premi Importa sul gioco a cui giochi di più.
  2. JoyPro chiede come:
    • Aggiungi al mio profilo (consigliato) tiene ciò che hai e aggiunge le assegnazioni del gioco.
    • Ricomincia da questo gioco sostituisce le tue relazioni con quelle che ha il gioco (prima JoyPro tiene una copia del tuo profilo).
    • Prendi anche i tasti della tastiera porta anche i comandi di volo sulla tastiera. Le assegnazioni dei dispositivi vengono sempre prese.
    • Per DCS: Tutti i miei velivoli DCS, oppure togli la spunta e scegli i velivoli.
  3. Premi Importa ora. Un attimo dopo la scheda dice "Fatto: il tuo profilo ora ha 214 relazioni (180 assegnate)" e Vedi le mie relazioni le apre. Guarda prima invece mostra cosa ha il gioco, senza cambiare niente.
La pagina Start con i tuoi giochi e dispositiviLa pagina Start con i tuoi giochi e dispositivi
La pagina Start con i tuoi giochi e dispositivi (Le immagini mostrano l'app in inglese.)

Nessun profilo aperto? JoyPro ne crea uno per te e da lì in poi lo salva automaticamente (non c'è un pulsante Salva: ogni modifica viene salvata e si può annullare, anche dopo un riavvio).

#Cosa cambia nel gioco?

Niente. L'importazione legge solo i file del gioco. Il gioco tiene le sue assegnazioni esattamente come sono, che tu esporti più tardi o no.

#Importa, poi lascia che JoyPro riempia i vuoti

Nella pagina Start, la scheda "Configura i tuoi dispositivi" elenca i giochi in cui hai fatto assegnazioni da solo. Importa, poi riempi i vuoti prima importa un gioco del genere. Poi Ora riempi i vuoti... mette le funzioni importanti sui pulsanti ancora liberi. Le tue assegnazioni restano. Per i giochi già nel tuo profilo, la scheda propone Riempi i vuoti....

#Prima della tua prima importazione: l'elenco comandi

JoyPro deve conoscere i comandi di ogni gioco (i loro nomi e id). Crea questo elenco una volta dalla tua installazione. Quando manca un elenco, la pagina Start mostra Crea elenco (o Crea tutti gli elenchi mancanti); una scheda di gioco propone Aggiorna dopo un aggiornamento del gioco. Ci vogliono da pochi secondi a qualche minuto (DCS legge ogni modulo).

Avanzate

#Opzioni e cosa fanno

Opzione Predefinito Effetto
Aggiungi al mio profilo / Ricomincia Aggiungi Aggiungi unisce nel profilo aperto; Ricomincia sostituisce le sue relazioni dopo una conferma e una copia del profilo.
Prendi anche i tasti della tastiera la tua ultima scelta Entrano anche i comandi di volo assegnati a tasti.
Importa anche i dispositivi non collegati attivo Vengono importati anche i dispositivi non collegati ora (utile per una cloche che colleghi più tardi). Disattivo: vengono saltati e contati.
Tratta i dispositivi con lo stesso nome come un unico dispositivo attivo Windows ogni tanto dà a un dispositivo un nuovo ID; i suoi file vecchi e nuovi vengono letti come un unico dispositivo sull'ID collegato. Due dispositivi identici collegati insieme restano separati.
Includi predefiniti (DCS, modulo per esperti) attivo Entra ogni assegnazione predefinita che DCS ha attiva per un dispositivo importato, così un'importazione seguita da un'esportazione Sostituisci + Cancella anche lascia DCS com'era. Le tue assegnazioni prevalgono su un predefinito sullo stesso input.
Importa inversione / slider / curvatura / zona morta / saturazione (modulo per esperti) off Prende i valori impostati nel gioco per le assegnazioni che JoyPro non ha esportato da sé. Un'assegnazione esportata da JoyPro riavrà la sua regolazione anche senza questi.
DCS: ignora velivoli *_easy off Le copie dei velivoli in modalità facile vengono escluse.

L'importazione per esperti (pagina Start, sotto le schede, e la pagina Avanzate) offre ogni opzione del motore per gioco con Analizza (anteprima), Importa ed Esporta. Ogni scelta viene ricordata per la prossima importazione.

#Nomi, gruppi e modificatori tornano

Un file del gioco contiene solo dispositivo, input e forse una curva. L'esportazione di JoyPro tiene i propri dati accanto, e un'importazione li rilegge:

Gioco Dati di JoyPro Ripristinato
DCS <aircraft>\joystick\<device>.jp, modifiers.lua nome della relazione, gruppi (in ordine), modificatori con nomi, inversione, slider, zona morta, saturazione, curva
IL-2 Great Battles data\input\jp.actions nome, gruppi, alias, modificatori, la regolazione esatta
Giochi del registro (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json nome, gruppi, alias, modificatori, regolazione
Star Citizen actionmaps.jp nomi

Prevale lo stato attuale del gioco: una curva che hai cambiato in DCS dopo l'esportazione viene mantenuta. Le assegnazioni che JoyPro non ha mai esportato ricevono un nome costruito dall'azione del gioco e i gruppi DCS, IL2 o GENERATED + gioco.

#Due protezioni

  • Modifiche non ancora esportate. Se hai cambiato assegnazioni in JoyPro e non le hai esportate in questo gioco, un'importazione riporterebbe le vecchie assegnazioni. JoyPro chiede prima.
  • Già importato? Quando il profilo ha il gioco, le modifiche che fai nel gioco in seguito arrivano tramite il monitoraggio dei giochi (chiede dopo la chiusura del gioco); importare di nuovo resta a un clic.
Nel gioco: Cosa legge l'importazione, per tipo di gioco

L'importazione non scrive mai in una cartella del gioco. Cosa legge:

  • DCS: le assegnazioni di ogni velivolo e dispositivo, i tuoi modificatori e, con "Includi predefiniti", le assegnazioni predefinite che DCS ha per ogni dispositivo.
  • IL-2 Great Battles / Korea: il key mapping e le risposte degli assi.
  • Star Citizen: le keybindings del ramo (LIVE, PTU ...), con le assegnazioni joystick predefinite del gioco su js1.
  • Giochi con fanteria o veicoli (War Thunder, Arma, Reforger, WARDOGS ...): solo le azioni di volo; tutto il resto viene ignorato, non cancellato.
  • MSFS: i profili di input del simulatore (versione Steam o Microsoft Store) e, su richiesta, i preset predefiniti del simulatore.

I dispositivi che il gioco non riesce a distinguere (due dispositivi dello stesso modello in alcuni giochi) e le assegnazioni a mezzo asse (Elite) vengono saltati e indicati nel risultato.

Dettagli tecnici interni

#Come funziona dentro

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Chiede AskAboutUnexportedChangesAsync (motore sync pending), conferma Ricomincia e tiene una copia del profilo (BackupProfileBeforeChange("before-import")), poi chiama l'importazione del gioco: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync o ImportRegistryGameAsync. Guarda prima esegue lo stesso con scan (PreviewImportWizardAsync) e apre il pannello Output.
  2. Motore. Per 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. L'importatore legge ogni file di dispositivo, associa il dispositivo tramite GUID d'istanza DirectInput e nome, associa ogni id di comando all'elenco comandi del gioco (DB\<game> in %LOCALAPPDATA%\JoyPro2\GameData) e costruisce una relazione per funzione e input. Le correzioni al caricamento (--load-corrections, --correction-mode) rimappano gli id di comando rinominati con un punteggio di certezza.
  3. Profilo. Le relazioni vengono unite per nome e per stesso input; i modificatori vengono creati da modifiers.lua (DCS) o dalle impostazioni shift del gioco. Il profilo viene salvato in modo atomico e ogni salvataggio è una versione in <data>\ProfileHistory (Annulla funziona anche dopo un riavvio).
  4. Monitoraggio. L'importazione di un gioco senza registro di sincronizzazione registra i file del gioco, così le modifiche che fai nel gioco in seguito vengono notate (<data>\Sync\<game>.json).

#I file che legge

Gioco File
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua e modifiers.lua, più i profili puliti che JoyPro ha creato dalla tua installazione di DCS
IL-2 Great Battles / Korea data\input\*.actions e le risposte degli assi
Star Citizen actionmaps.xml del ramo
MSFS la cartella remota di Steam o il salvataggio del Microsoft Store

Le opzioni della GUI come opzioni del motore: Aggiungi --merge, tastiera --include-keyboard true, dispositivi non collegati --only-connected false, stesso nome --merge-same-name true, velivoli facili --ignore-easy-planes true. La protezione per le modifiche non ancora esportate è engine sync pending.

Comandi del motore: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import e engine <game> import per ogni gioco del registro (per esempio engine warthunder import, engine msfs2024 import). Regole di reimportazione: reimportazione. Test: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.