JoyPro2 Discord GitHub
Giochi

X-Plane 12 / 11

Mostra:

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.

Per principianti

#Funziona in 3 passi

  1. Configura tutto per me
    nella pagina Start
  2. Usa questi pulsanti
    prima guarda l'elenco
  3. 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

  1. 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.txt dell'X-Plane installato.
  2. Premi Importa sulla scheda e scegli Aggiungi al mio profilo (in questo file X-Plane non ha assegnazioni della tastiera).
  3. Premi Importa ora. Vedi le mie relazioni apre ciò che è entrato.
La pagina Start con i tuoi giochiLa pagina Start con i tuoi giochi
La pagina Start con i tuoi giochi (Le immagini mostrano l'app in inglese.)

#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

  1. 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.
  2. Apri Esporta. Ogni versione installata ha la sua scheda.
  3. Lascia Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi se configuri i tuoi dispositivi in JoyPro. Premi Esporta ora sulla scheda.
Nel gioco: Cosa vedi in X-Plane

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.
Avanzate

#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).
Dettagli tecnici interni

#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
Ogni versione di X-Plane ha il suo file delle preferenze. Calibrazione e null zone restano quelle di X-Plane.

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 di Commands.txt (sim/flight_controls, engines, autopilot, lights ...; non sim/view, operation, replay ...).
  • Importazione / esportazione: engine xplane12 import, engine xplane12 scan, engine xplane12 export (--mode, --nuke-untouched-devices, --dry-run), lo stesso per engine 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.ps1 percorre ogni asse confrontandolo con l'anteprima di JoyPro.

Tutte le note tecniche su questo gioco (generate dal repository): xplane.md.