X-Plane tiene le assegnazioni di tutti i tuoi dispositivi in un unico file delle preferenze dentro la sua installazione: un "uso" dell'asse (pitch, throttle, flaps ...) per ogni asse hardware, un comando per pulsante, e curve di risposta facoltative. JoyPro legge quel file nel tuo profilo, lo unisce agli altri tuoi giochi nelle relazioni e lo riscrive, cambiando solo le righe di volo che gestisce. X-Plane 12 e X-Plane 11 sono due giochi in JoyPro, ognuno con la sua installazione, il suo elenco comandi e le sue impostazioni; possono essere installati uno accanto all'altro.
X-Plane 12 nativo (i suoi file di assegnazioni)
- Supporto
- nativo (i suoi file di assegnazioni)
- Comando del motore
engine xplane12- File di assegnazioni
Output\preferences\X-Plane Joystick Settings.prf,control profiles\*.prf(a righe)- Input che il gioco legge
- legge 160 pulsanti, 25 assi, 1 hat per joystick (verificato)
- Elenco comandi da
Resources\plugins\Commands.txt- Test nel gioco
- 33/33 passi superati (2026-10-11)
- ✓ Importa
- ✓ Esporta
- ✗ Assegnazioni da tastiera
- ✗ Modificatori
- ✓ Elenco comandi creato sul tuo PC
- ✓ Monitoraggio giochi
- ✓ Curve degli assi e zone morte
- ✓ Impostazioni dei comandi del gioco
- ◐ Impostazioni del force feedback nel giocoX-Plane 12: solo l'interruttore per dispositivo "control-loaded axes" per le cloche con force feedback; il simulatore non ha effetti di force feedback propri per la cloche (solo plugin).
- ✗ Force feedback dalla telemetria
- ✓ Registrazione della telemetria
- ✓ Joystick virtuale (vJoy)
- ◐ Pad Xbox virtuale
- ✓ Funzioni virtuali
- ✓ Configurazione guidata / Assegnazione automatica
- ✓ Cockpits
- ✓ Schede riepilogo
- ✓ Test nel gioco
X-Plane 11 nativo (i suoi file di assegnazioni)
- Supporto
- nativo (i suoi file di assegnazioni)
- Comando del motore
engine xplane11- File di assegnazioni
- come X-Plane 12
- Input che il gioco legge
- legge 160 pulsanti, 25 assi, 1 hat per joystick (verificato)
- Elenco comandi da
Resources\plugins\Commands.txt
- ✓ Importa
- ✓ Esporta
- ✗ Assegnazioni da tastiera
- ✗ Modificatori
- ✓ Elenco comandi creato sul tuo PC
- ✓ Monitoraggio giochi
- ✓ Curve degli assi e zone morte
- ✓ Impostazioni dei comandi del gioco
- ✗ Impostazioni del force feedback nel gioco
- ✗ Force feedback dalla telemetria
- ✓ Registrazione della telemetria
- ✓ Joystick virtuale (vJoy)
- ◐ Pad Xbox virtuale
- ✓ Funzioni virtuali
- ✓ Configurazione guidata / Assegnazione automatica
- ✓ Cockpits
- ✓ Schede riepilogo
- ✗ Test nel gioco
Dalla matrice di supporto, generata dal codice del motore: tutti i giochi.
#Funziona in 3 passi
- Configura tutto per me
nella pagina Start - Usa questi pulsanti
prima guarda l'elenco - Scrivi nel mio gioco
tieni chiuso X-Plane
Prima: avvia X-Plane una volta con i tuoi dispositivi collegati, poi esci.
Poi: calibra i tuoi dispositivi in X-Plane (Settings > Joystick). Anche le tue assegnazioni compaiono lì.
Avevi già assegnato pulsanti in X-Plane? Allora la pagina Start propone Importa, poi riempi i vuoti. Le tue assegnazioni restano, e solo i pulsanti liberi ricevono nuovi compiti. Vedi Avvio rapido: far funzionare la mia cloche.
#Cosa fa JoyPro per X-Plane
- Importa: gli usi degli assi, i comandi dei pulsanti, i flag di inversione e le curve di risposta dei tuoi dispositivi entrano nel tuo profilo.
- Relazioni: una relazione è una funzione in tutti i tuoi giochi ("Gear" in X-Plane, MSFS e DCS sullo stesso pulsante). I comandi di volo di X-Plane vengono dal suo
Commands.txt. - Esporta: JoyPro scrive le preferenze del joystick della versione verso cui esporti. X-Plane mostra le tue assegnazioni in Settings > Joystick.
#Importa le tue assegnazioni di X-Plane
- Apri Avvia. La scheda di X-Plane 12 (o X-Plane 11) mostra l'immagine del gioco. Se chiede un elenco comandi, premi Crea elenco: JoyPro legge
Resources\plugins\Commands.txtdell'X-Plane installato. - Premi Importa sulla scheda e scegli Aggiungi al mio profilo (in questo file X-Plane non ha assegnazioni della tastiera).
- Premi Importa ora. Vedi le mie relazioni apre ciò che è entrato.


#Crea e verifica le relazioni
Nella pagina Relazioni il comando o l'asse X-Plane di una relazione sta accanto alla stessa funzione negli altri tuoi giochi. Usa il flusso delle relazioni per unirli, poi premi Controlla ora nella pagina Esporta (la Verifica).
#Esporta in X-Plane
- Chiudi X-Plane. Riscrive le sue preferenze quando si chiude la finestra delle impostazioni e quando esci dal gioco. Entrambe le versioni girano come
X-Plane.exe, quindi JoyPro si rifiuta finché una delle due è in esecuzione. - Apri Esporta. Ogni versione installata ha la sua scheda.
- Lascia Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi se configuri i tuoi dispositivi in JoyPro. Premi Esporta ora sulla scheda.
Avvia X-Plane e apri Settings > Joystick, poi scegli il tuo dispositivo. Ogni asse mostra l'uso scritto da JoyPro, i pulsanti mostrano i loro comandi, e Edit Response Curve su un asse mostra i punti e l'interpolazione scritti da JoyPro.
#Cosa fai tu in X-Plane
- Avvia X-Plane una volta con i tuoi dispositivi collegati, poi chiudilo. Una versione mai avviata non ha ancora un file delle preferenze. Il primissimo avvio fa volare il tutorial, e X-Plane scrive le sue preferenze del joystick quando si chiude.
- Calibra in X-Plane. La calibrazione e la null zone restano di X-Plane (Settings > Joystick); JoyPro non le scrive mai.
- I comandi dei plugin e dei velivoli non sono nell'elenco di JoyPro: assegnali in X-Plane, JoyPro li lascia stare.
#Errori frequenti
- Un asse non fa niente ("Multiple axes assigned to yaw"): X-Plane ignora un uso condiviso da due assi collegati. L'esportazione avvisa; Cancella anche gli altri miei dispositivi o Sostituisci libera l'altro asse.
- La manetta funziona al contrario: X-Plane inverte da solo gli assi della manetta. JoyPro scrive la tua inversione senza cambiarla, quindi lascia l'inversione disattivata a meno che la tua leva non vada davvero nell'altro senso.
- Una curva fatta in X-Plane è cambiata: nelle modalità Aggiorna e in Aggiungi soltanto resta com'è quando la regolazione di JoyPro è lineare (con un avviso); "prevale il mio profilo" e Sostituisci scrivono la curva di JoyPro.
#File che JoyPro legge e scrive
| File | Di cosa si tratta |
|---|---|
<install>\Output\preferences\X-Plane Joystick Settings.prf |
le assegnazioni attuali di tutti i dispositivi (a righe) |
<install>\Output\preferences\control profiles\<Name> - Joysticks.prf |
profili dei comandi salvati, stesso formato |
<file>.joypro.json, <file>.joypro-meta.json |
gli input e le curve che JoyPro ha scritto; nomi, gruppi e regolazione per la prossima importazione |
%LOCALAPPDATA%\x-plane_install_12.txt / _11.txt |
dove l'installer di X-Plane elenca le sue installazioni (solo lettura) |
X-Plane Keys.prf (tastiera) non viene mai toccato. Una versione installata da Steam e mai avviata viene trovata nella sua cartella Steam. Un'altra cartella si imposta in Impostazioni > Giochi.
#Le modalità di esportazione in X-Plane
| Modalità | Cosa succede in X-Plane |
|---|---|
| Aggiungi soltanto | Solo input liberi. Un'assegnazione su un input con un altro uso o comando non viene scritta ed è elencata; un uso d'asse che X-Plane ha su un altro asse resta lì (avviso). |
| Aggiorna, mantieni le assegnazioni del gioco | Sostituisce l'altro uso o comando sul tuo input e mantiene tutto il resto; un uso d'asse si sposta (X-Plane ignora un uso condiviso da due assi). |
| Aggiorna, prevale il mio profilo | Libera anche gli altri assi e pulsanti dei dispositivi collegati che hanno un uso o un comando che assegni, con le loro curve. |
| Sostituisci sui miei dispositivi | Libera anche ogni altro asse e comando di volo sui dispositivi che scrivi. |
| + Cancella anche gli altri miei dispositivi | I dispositivi collegati che non scrivi perdono i loro usi e comandi di volo. |
#Cosa non viene mai toccato
- Slot di dispositivi non collegati, i dispositivi ignorati dall'importazione e il dispositivo vJoy in cui JoyPro convoglia gli input.
- Assi di visuale, telecamera, VR e comandi personalizzati, comandi di plugin e velivoli, la tastiera.
- Chiavi di calibrazione (
_joy_center,_joy_null, dati di calibrazione grezzi),_eq_pfc_*e ogni altra riga.
#Curve e impostazioni
- Granularità: un solo file per tutti i velivoli (X-Plane può collegare i velivoli ai profili dei comandi; JoyPro scrive i file che trova).
- Curve di risposta (modello d'asse
xplane): un numero qualsiasi di punti con LINEAR, CATMULL_ROM o CUBIC_AVG, e gli intervalli fissi degli assi di manetta, elica e miscela (beta, feather, cutoff, FADEC ...). La Curva predefinita diventa punti; una curva invariata mantiene i suoi byte. La regolazione si può impostare per una versione o per entrambe (family:xplane). - Inversione:
_joy_rev_axis, la tua inversione invariata (X-Plane inverte le manette da sé). - Impostazioni del gioco (Impostazioni > Impostazioni force feedback dei giochi): risposta dei comandi di pitch, roll e yaw; X-Plane 12 anche gli assi del copilota e gli "control-loaded axes" per le cloche force feedback; X-Plane 11 la stability augmentation; entrambi gli scatti dei flap. Vengono cambiate solo le righe che il file ha già.
- Force feedback: X-Plane non ne ha uno suo; solo l'interruttore control-loaded.
- Registrazione della telemetria: dall'uscita dati UDP di X-Plane (porta 49000), con la posizione, quindi è possibile una traccia Tacview.
- Monitoraggio: le modifiche nelle preferenze vengono notate dopo la chiusura di X-Plane (il monitoraggio).
#Dentro l'integrazione di X-Plane
flowchart LR P["Il tuo profilo<br/>(relazioni + assegnazioni)"] --> E["engine xplane12 export<br/>(o xplane11)"] D["Slot dei dispositivi<br/>VID:PID + percorso HID"] --> E E --> J["Output / preferences /<br/>X-Plane Joystick Settings.prf"] E --> C["control profiles /<br/>Name - Joysticks.prf"] J --> G["X-Plane: Settings > Joystick"] C --> G
Codice: engine\Games\XPlaneIntegration.cs (un'istanza per versione), engine\Games\XPlanePrf.cs, engine\AxisModels\XPlane.cs, engine\FfbModels\XPlane.cs, engine\Games\LegacyGameIds.cs (i profili di prima della divisione in due versioni vengono migrati al caricamento).
- Righe:
_joy_AXIS_use<i>(codice d'uso),_joy_rev_axis<i>,_joy_BUTN_use<i>(percorso del comando,sim/none/none= libero),axis_response_curve<i>. Indici globali: asse = slot × 25 + asse, pulsante = slot × 160 + pulsante. - Dispositivi: slot
_joy_unique_id<slot> VID:<dec>PID:<dec>; con dispositivi identici il percorso dell'interfaccia HID di DirectInput deve essere uguale a_joy_location<slot>. I pulsanti sono i pulsanti del dispositivo, poi il primo hat come 8 pulsanti in senso orario partendo da su; gli altri hat non vengono mappati. Legge 160 pulsanti e 25 assi per dispositivo. - Codici d'uso: da 0 a 66 in entrambe le versioni; X-Plane 12 aggiunge throttle 9, pitch/roll/yaw/freni/ruotino del copilota ed entrambi i freni delle ruote. I codici da 74 a 77 e gli assi della visuale non sono a catalogo.
- Elenco comandi:
engine xplane12 refresh-db/engine xplane11 refresh-db: la tabella degli assi della versione più i gruppi di comandi di volo diCommands.txt(sim/flight_controls,engines,autopilot,lights...; nonsim/view,operation,replay...). - Importazione / esportazione:
engine xplane12 import,engine xplane12 scan,engine xplane12 export(--mode,--nuke-untouched-devices,--dry-run), lo stesso perengine xplane11 export. Prima un backup in.jpbak. - Impostazioni e curve:
engine ffb set--game XPlane12,engine binds tuning set--scope game:XPlane12 --curve-points 0:0,0.4:0.3,1:1,engine binds tuning preview(misurato in X-Plane 12.4.3 entro 0.0001).
#Limiti noti
- Il significato dei codici d'uso da 74 a 77; l'ordine degli assi HID rispetto a DirectInput è dedotto.
- La Control Sensitivity di X-Plane senza una curva non è nell'anteprima.
- X-Plane 11 è verificato solo rispetto ai suoi file installati; la verifica nel menu del gioco è ancora da fare.
- Test:
engine\tests\smoke\xplane.ps1; nel gioco (X-Plane 12) assegnazioni e curve di risposta hanno superato 33 passi su 33;tools\e2e\games\XPlaneCurves.ps1percorre ogni asse confrontandolo con l'anteprima di JoyPro.
Tutte le note tecniche su questo gioco (generate dal repository): xplane.md.