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"]
#Esportare in tre passi
Apri Esporta nella barra in basso. La pagina è fatta di tre schede numerate dall'alto verso il basso:


- 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.
- 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.
- 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. |
#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).
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.
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.
- 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.
- 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.
#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. |
- GUI.
ExportSelectedGamesAsync/ExportGameNowAsync(MainWindowViewModel.ExportGames.cs) chiedonoAskAboutFirstExportAsync(engine profile game-state) eConfirmRiskyExportAsync, poiExportGameAsyncsceglie l'esportatore della scheda:dcs,il2,starcitizeno 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--profilee--status true(l'avanzamento e Annulla dell'area di attività), in serie così due comandi non scrivono mai insieme. - Motore.
engine\Program.csindirizzadcs/il2/starcitizenai loro esportatori e ogni altro gioco aGames.GameRegistry(unaGameIntegrationper gioco). DCS:EngineDcsExport.Modes.cscalcola, per ogni file di dispositivo, le assegnazioni che DCS ha attive (profilo pulito menoremoved, piùaddedechanged), decide quali devono essere attive e scrive solo le vere differenze dai valori predefiniti. - Sicurezza.
GameExportSafety.BackupBeforeOverwritecopia ogni file in<file>.jpbake nell'archivio dei backup con versioni (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\conmanifest.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. - 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.csriempieSkippedTakenInputs; 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).
#Vedi anche
- La pagina Esporta, ogni comando che contiene
- La Verifica prima di un'esportazione
- Riferimento dell'esportazione e Backup configurazioni dei giochi
- Supporto dei giochi: cosa fa JoyPro per ogni gioco