JoyPro2 Discord GitHub
Flussi principali

Esportare nei tuoi giochi

Mostra:

L'esportazione è il passo che fa funzionare le tue cloche nel gioco. JoyPro scrive le tue relazioni e assegnazioni nei file delle impostazioni dei comandi di ogni gioco, gli stessi file che salva il menu Controls del gioco. Mentre voli non gira niente in background: una volta esportato, il gioco legge i suoi file come sempre.

flowchart LR
  C["1 Verifica<br/>(facoltativa)"] --> M["2 Scegli come<br/>(4 scelte)"]
  M --> G["3 Spunta i giochi,<br/>Esporta giochi selezionati"]
  G --> W["Prima il backup,<br/>poi vengono scritti<br/>i file del gioco"]
Il passo 1 si limita a guardare; non ferma mai l'esportazione. Annulla ultima esportazione sulla scheda di un gioco rimette a posto i suoi file. Nei giochi solo Xbox non viene scritto niente: usano Avvia nella pagina Joystick virtuale.
Per principianti

#Esportare in tre passi

Apri Esporta nella barra in basso. La pagina è fatta di tre schede numerate dall'alto verso il basso:

La pagina Esporta: verifica, come, giochiLa pagina Esporta: verifica, come, giochi
La pagina Esporta: verifica, come, giochi (Le immagini mostrano l'app in inglese.)
  1. Verifica il tuo profilo. Premi Controlla ora. JoyPro cerca le cose che andrebbero storte nel gioco, per esempio un pulsante che fa due cose nello stesso velivolo. Correggi ciò che trova (un clic per problema) o lascialo; la verifica non blocca mai l'esportazione. Vedi la Verifica.
  2. Come JoyPro scrive nei giochi. Scegli una delle quattro opzioni. Se non sei sicuro, tieni la prima: Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi spuntato. Le tue cloche fanno allora esattamente quello che dice il tuo profilo, e nient'altro.
  3. Esporta nei giochi. Ogni gioco per cui il tuo profilo ha assegnazioni riceve una scheda con la sua immagine. Spunta i giochi e premi Esporta giochi selezionati, oppure premi Esporta ora su una scheda.

Chiudi prima il gioco. I giochi scrivono i loro file dei comandi quando si chiudono, quindi JoyPro si rifiuta di esportare in un gioco in esecuzione e te lo dice.

#Quale scelta è giusta per me?

Scelta Sceglila quando Cosa succede alle assegnazioni del gioco
Sostituisci sui miei dispositivi JoyPro è il posto dove configuri le tue cloche Sui dispositivi del tuo profilo restano solo le tue assegnazioni (per i velivoli che esporti).
Aggiorna, mantieni le assegnazioni del gioco Assegni anche cose dentro il gioco e vuoi tenerle Le tue assegnazioni entrano; un'assegnazione del gioco viene rimossa solo dove sta su un pulsante che usi per qualcos'altro.
Aggiorna, prevale il mio profilo Come quella sopra, ma hai spostato delle azioni su altri pulsanti in JoyPro Come sopra, e ogni azione che assegni perde i suoi altri pulsanti nel gioco, così uno spostamento sposta davvero.
Aggiungi soltanto Stai provando JoyPro per la prima volta Non viene rimosso niente. Se il gioco usa già un pulsante per qualcos'altro, la tua assegnazione viene esclusa e la Verifica te lo dice.

Cancella anche gli altri miei dispositivi (una spunta sotto le scelte): i dispositivi collegati che non hanno assegnazioni nel tuo profilo perdono le loro assegnazioni nei velivoli esportati. Lasciala spuntata se vuoi partire puliti, toglila se usi un secondo dispositivo solo dentro il gioco.

#Sicuro per come è fatto

  • Prima di modificare un file del gioco, JoyPro lo copia in un backup. Ogni scheda ha Annulla ultima esportazione: rimette i file esattamente come erano, byte per byte.
  • La prima esportazione in un gioco che ha già le sue assegnazioni chiede una volta: "Importare prima?". Scegli Importa prima se vuoi tenere ciò che hai fatto nel gioco, Esporta comunque per sostituirlo.
  • I dispositivi non collegati mantengono le loro assegnazioni. Le assegnazioni del mouse e del gamepad non vengono mai toccate.

#Cosa noti nel gioco

Avvia il gioco e apri il suo menu dei comandi: le tue assegnazioni sono lì, nella colonna di ogni dispositivo, con i nomi che usa il gioco. In DCS appaiono per velivolo; in Star Citizen per azione della nave; in IL-2 in Key mapping. La sezione Nel gioco qui sotto elenca ogni tipo di gioco.

#Altri modi in cui le tue assegnazioni arrivano al gioco

Modo Cosa fa
Scrivi nel mio gioco (la configurazione rapida) L'esportazione della configurazione rapida. Scrive i giochi che ha configurato, con lo stesso backup. Vedi Avvio rapido.
Il finto controller (pad Xbox virtuale) In ACE COMBAT 8 e Hell Let Loose: Vietnam non viene scritto niente. La loro esportazione lo dice. La tua cloche guida un finto controller finché Avvia è attivo. Vedi Giochi solo Xbox.
La kneeboard di DCS Non è un'esportazione di assegnazioni: una pagina per velivolo che elenca cosa fanno i tuoi pulsanti, nel cockpit. Vedi la kneeboard.
Avanzate

#Le modalità nel dettaglio

"Stesso input" significa lo stesso dispositivo, lo stesso pulsante o asse e gli stessi modificatori, nello stesso velivolo (o nave, veicolo) quando il gioco tiene le assegnazioni per velivolo. Ogni modalità lavora solo nei velivoli dell'esportazione.

Aggiungi soltanto Aggiorna, mantieni Aggiorna, prevale il profilo Sostituisci
Le tue assegnazioni scritte dove l'input è libero scritti scritti scritti
Un'assegnazione del gioco su un input che usi per un'altra azione mantenuta; la tua assegnazione non viene scritta ed è segnata rimossa rimossa rimossa
Un'assegnazione del gioco della stessa azione su un altro input (dopo uno Sposta) mantenuto mantenuta (l'azione è su entrambi gli input) rimossa rimossa sui dispositivi scritti
Altre assegnazioni del gioco sui tuoi dispositivi mantenuto mantenuto mantenuto rimosse
Assegnazioni predefinite del gioco sui tuoi dispositivi mantenuto mantenuto mantenute a meno che non contengano una delle tue azioni rimosse
Dispositivi collegati senza assegnazioni nel profilo mantenuto mantenuto le tue azioni vengono rimosse da essi mantenute, a meno di Cancella anche gli altri miei dispositivi
Dispositivi non collegati, mouse, gamepad mai toccati mai toccati mai toccati mai toccati
Tastiera solo con l'opzione della tastiera solo con l'opzione della tastiera solo con l'opzione della tastiera solo con l'opzione della tastiera
Velivoli non inclusi nell'esportazione mai toccati mai toccati mai toccati mai toccati (DCS: a meno dell'opzione "perdono le assegnazioni predefinite di DCS anche in tutti gli altri velivoli")

Cancella anche gli altri miei dispositivi non si usa con Aggiungi soltanto. Con le altre modalità cancella i dispositivi collegati che il profilo non usa, nei velivoli esportati (DCS: anche le loro assegnazioni predefinite di DCS). I dispositivi che l'importazione ignora e il dispositivo vJoy in cui JoyPro convoglia gli input non vengono mai cancellati.

Dalla 2.5.0 il valore predefinito è Sostituisci sui miei dispositivi + Cancella anche gli altri miei dispositivi (come in JoyPro 1). Una modalità scelta da te viene ricordata.

#In breve: una tua assegnazione, quattro modalità

Modalità Il gioco usa il tuo pulsante per qualcos'altro La tua azione ha altri pulsanti nel gioco Altri dispositivi collegati
Sostituisci sui miei dispositivi Quell'assegnazione viene rimossa; la tua viene scritta Rimossi sui dispositivi scritti Mantenuti, a meno di Cancella anche gli altri miei dispositivi
Aggiorna, prevale il mio profilo Quell'assegnazione viene rimossa; la tua viene scritta Rimosso Le tue azioni vengono rimosse da essi
Aggiorna, mantieni le assegnazioni del gioco Quell'assegnazione viene rimossa; la tua viene scritta Mantenuti: l'azione è su entrambi Mantenute
Aggiungi soltanto Mantenuta; la tua non viene scritta ed è segnata Mantenute Mantenute

#Opzioni per gioco

In Opzioni e percorsi (per esperti):

  • DCS: l'elenco Velivoli... sulla scheda di DCS (vengono scritti solo i velivoli spuntati); DCS: mantieni predefiniti della tastiera (attivo); i miei dispositivi perdono le assegnazioni predefinite di DCS anche in tutti gli altri velivoli (disattivo).
  • Star Citizen: SC: mantieni predefiniti della tastiera, preferisci ordine locale.
  • Gli altri giochi: una casella Simulazione che mostra cosa cambierebbe senza scrivere.
  • Percorsi: una cartella Saved Games o di configurazione diversa per ogni gioco; Percorsi e dispositivi ignorati propri di questo profilo dà al profilo aperto i suoi invece di quelli del PC.

#Segni: "Non scritto nel gioco"

Aggiungi soltanto (e ogni modalità in cui un gioco non ha un posto libero per un altro input, per esempio Elite Dangerous con due input per azione) esclude alcune assegnazioni. Il profilo ricorda ciascuna con l'azione del gioco che occupa l'input e la data; la Verifica mostra una scheda per ogni segno con Esporta con 'Aggiorna' per sostituirlo, Sposta su un altro pulsante e Lascia così. Ogni esportazione sostituisce i segni del suo gioco e dei suoi velivoli, quindi un segno sparisce quando un'esportazione successiva scrive l'assegnazione.

#Impostazioni ricordate

La modalità, la spunta Cancella anche, le opzioni per gioco e i percorsi sono conservati nelle impostazioni di JoyPro; i giochi e i velivoli DCS che hai spuntato tu sono conservati per profilo. Sostituisci e Cancella anche chiedono conferma prima di ogni esportazione (Impostazioni > Conferme può disattivare la domanda).

#Dopo l'esportazione

  • Annulla ultima esportazione sulla scheda ripristina il backup più recente di quel gioco. L'elenco completo è in Backup configurazioni dei giochi in fondo alla pagina Esporta.
  • L'esportazione registra i file del gioco per il monitoraggio dei giochi: l'esportazione di JoyPro stessa non chiede mai dopo "acquisire le modifiche?"; una modifica che fai nel gioco dopo invece sì (il monitoraggio).
  • JoyPro tiene i suoi dati accanto al file del gioco, così un'importazione successiva riporta nomi delle relazioni, gruppi, modificatori e curve (reimportazione).

#Nel gioco

Ciò che il giocatore vede dopo un'esportazione dipende dal tipo di gioco. Tutti i giochi qui sotto seguono le stesse regole: JoyPro scrive solo le azioni del suo elenco comandi, si rifiuta di scrivere mentre il gioco è in esecuzione, prima fa il backup dei file e non tira mai a indovinare un dispositivo o un'azione che non riesce ad abbinare (lo salta con un avviso).

Nel gioco: Simulatori di volo: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro prende il controllo dei dispositivi su cui scrive. Con Sostituisci ogni altra assegnazione di quei dispositivi sparisce nei velivoli esportati, con Cancella anche vengono cancellati anche gli altri dispositivi collegati (DCS: anche le loro impostazioni predefinite di DCS).

  • DCS World: in Options > Controls, scegli il velivolo: le tue assegnazioni sono nella colonna del dispositivo, le predefinite rimosse appaiono come celle vuote, i tuoi modificatori sono nell'elenco dei modificatori. Cambiano solo i velivoli spuntati. JoyPro scrive solo le differenze rispetto alle predefinite di DCS, come fa DCS stesso.
  • IL-2 Great Battles: Settings > Key mapping mostra le tue assegnazioni e le risposte degli assi. Le righe del mouse e le righe che JoyPro non conosce restano.
  • IL-2 Korea: il profilo di key mapping "General".
  • Falcon BMS: il launcher crea il file dei tasti e la mappatura degli assi al successivo Launch, quindi avvia BMS dal launcher.
  • MSFS 2024 / 2020: in Controls il dispositivo mostra il preset di JoyPro.
  • X-Plane 11 / 12: Settings > Joystick mostra le assegnazioni.
Nel gioco: Giochi con fanteria, veicoli o menu: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro tocca solo le azioni di volo (aereo, elicottero, astronave). Le tue assegnazioni a piedi, dei veicoli e dei menu restano byte per byte. Sostituisci e Cancella anche liberano solo le azioni di volo che JoyPro conosce.

  • Star Citizen: Options > Keybindings mostra le azioni della nave sui tuoi joystick (js1, js2, ...). Con Sostituisci o Cancella anche le assegnazioni joystick predefinite del gioco su js1 vengono disattivate quando js1 viene scritto o non è usato.
  • War Thunder: Controls mostra le assegnazioni dei velivoli; i comandi di carri armati e navi restano invariati.
  • Arma 3 / Arma 2: le impostazioni dei tasti del profilo; cambiano solo le azioni di aerei ed elicotteri.
Nel gioco: Giochi spaziali: Elite Dangerous, X4: Foundations
  • Elite Dangerous tiene due input per azione (Primary e Secondary). Un'assegnazione senza posto libero riceve un segno "Non scritto" con "Sposta su un altro pulsante" o "Lascia così". Le assegnazioni a piedi e dell'SRV restano.
  • X4: le impostazioni degli input del gioco; cambiano solo le azioni della nave catalogate.
Nel gioco: Giochi che leggono un solo dispositivo o solo un controller Xbox
  • Giochi impostati su vJoy (giochi che leggono solo pochi dispositivi): l'esportazione scrive le assegnazioni sul dispositivo vJoy. JoyPro copia le tue cloche su di esso mentre giochi, e HidHide nasconde i tuoi dispositivi reali solo a quel gioco. Il gioco vede un unico dispositivo con tutto sopra. Vedi Joystick virtuale.
  • Giochi solo Xbox (ACE COMBAT 8, Hell Let Loose: Vietnam): non viene scritto niente, e l'esportazione lo dice. La tua cloche guida un finto controller (pad Xbox virtuale) finché Avvia è attivo. HidHide non serve. Vedi Giocare con un HOTAS a un gioco solo Xbox.
Dettagli tecnici interni

#Come funziona dentro

Un'esportazione dal clic ai file scritti:

# Chi Cosa succede
1 Tu Premi Esporta giochi selezionati nella pagina Esporta.
2 JoyPro Chiede al motore lo stato del gioco (profile game-state --game <id>): importato, esportato, ha assegnazioni.
3 JoyPro Ti chiede quando serve: una prima esportazione ("Importare prima?") o una modalità che rimuove assegnazioni (Impostazioni > Conferme).
4 Motore Esegue <game> export --mode <m> --nuke-untouched-devices <b> ...: si rifiuta mentre il gioco è in esecuzione, fa il backup di ogni file (GameBackups e .jpbak) e scrive solo azioni a catalogo.
5 Motore Salva il registro di sincronizzazione (impronta e base) e i segni di esportazione, poi risponde: scritto, saltato, SkippedTakenInputs.
6 JoyPro La scheda del gioco mostra "Esportato 14:02", e Annulla ultima esportazione è pronto.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) chiedono AskAboutFirstExportAsync (engine profile game-state) e ConfirmRiskyExportAsync, poi ExportGameAsync sceglie l'esportatore della scheda: dcs, il2, starcitizen o un gioco del registro. Il comando viene costruito dalle impostazioni della pagina, es. 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. Ogni chiamata al motore passa da un solo punto, RunEngineAsync, con --profile e --status true (l'avanzamento e Annulla dell'area di attività), in serie così due comandi non scrivono mai insieme.
  2. Motore. engine\Program.cs indirizza dcs / il2 / starcitizen ai loro esportatori e ogni altro gioco a Games.GameRegistry (una GameIntegration per gioco). DCS: EngineDcsExport.Modes.cs calcola, per ogni file di dispositivo, le assegnazioni che DCS ha attive (profilo pulito meno removed, più added e changed), decide quali devono essere attive e scrive solo le vere differenze dai valori predefiniti.
  3. Sicurezza. GameExportSafety.BackupBeforeOverwrite copia ogni file in <file>.jpbak e nell'archivio dei backup con versioni (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ con manifest.json; vengono conservati i 30 set più recenti per gioco). I giochi del registro (Nuclear Option) ricevono un'istantanea dei valori che possono cambiare. Un file creato dall'esportazione viene registrato come "non esisteva", così un ripristino lo rimuove di nuovo.
  4. Dopo. Il registro di sincronizzazione (<data>\Sync\<game>.json: dimensione, ora e SHA-256 per file e un hash di ogni assegnazione) fa tacere il monitoraggio per la modifica di JoyPro stesso. ExportSkippedBinds.cs riempie SkippedTakenInputs; il comando di esportazione li trasforma nei segni del profilo. La cronologia del profilo tiene un punto di ripristino prima di ogni esportazione.

#I file che riceve ogni gioco

Gioco File
DCS World per velivolo e dispositivo Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, un .jp accanto, il modifiers.lua del velivolo
IL-2 Great Battles data\input\global.actions (nuove righe alla fine, l'ordine mantenuto), le risposte degli assi, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS il User\Config\Setup.v100.* {GUID}.xml del launcher per dispositivo
MSFS 2024 / 2020 profili di input (2024: il pacchetto di preset joypro-input-profiles nella cartella Community e i profili Steam)
X-Plane 11 / 12 le preferenze del joystick in Output\preferences
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml e actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
Giochi del registro il loro file di configurazione e <config>.joypro-meta.json

Segni delle assegnazioni non scritte: engine export-marks list, engine export-marks dismiss. Impostazioni: export-settings.json (ModeChosenByUser); il valore predefinito del motore senza --mode è merge-overwrite.

#Ogni modalità dalla riga di comando

Scelta nella GUI Opzioni del motore
Sostituisci sui miei dispositivi + Cancella anche gli altri miei dispositivi (predefinito) --mode clean --nuke-untouched-devices true
Sostituisci sui miei dispositivi --mode clean --nuke-untouched-devices false
Aggiorna, prevale il mio profilo (+ Cancella anche) --mode merge-overwrite --nuke-untouched-devices true|false
Aggiorna, mantieni le assegnazioni del gioco (+ Cancella anche) --mode merge --nuke-untouched-devices true|false
Aggiungi soltanto --mode add (nuke non si usa)

Per gioco: engine dcs export, engine il2 export, engine starcitizen export, e engine <game> export per ogni gioco del registro (per esempio engine warthunder export, engine msfs2024 export, engine xplane12 export; ognuno accetta --mode, --dry-run, --include-keyboard e --nuke-untouched-devices). Annulla: engine backups restore. Test: engine\tests\smoke\dcsexportmodes.ps1 (ogni modalità, ciclo completo, annullamento byte per byte) e engine\tests\smoke\roundtrip.ps1 (importazione, clean + nuke, una nuova importazione lascia il gioco com'era).