X4: Foundations tiene le tue assegnazioni in inputmap.xml e chiama un joystick per il suo slot (da 1 a 8), non per il suo nome. Quale dispositivo sta in quale slot è scritto in config.xml. JoyPro legge le assegnazioni del volo spaziale nel tuo profilo e le riscrive sul posto, negli slot che X4 ha fissato per i tuoi dispositivi. In X4 inversioni e zona morta valgono per tutto il gioco, quindi JoyPro le imposta dalle tue relazioni per l'intero gioco.
X4: Foundations nativo (i suoi file di assegnazioni)
- Supporto
- nativo (i suoi file di assegnazioni)
- Comando del motore
engine x4- File di assegnazioni
Documents\Egosoft\X4\<id>\inputmap.xml(XML) + gli slot inconfig.xml- Input che il gioco legge
- legge 64 pulsanti, 8 assi, 1 hat per joystick (verificato)
- Elenco comandi da
- le tabelle dei nomi di
X4.exee gli archivi.cat/.dat - Test nel gioco
- 36/36 passi superati (2026-10-11)
- ✓ Importa
- ✓ Esporta
- ✓ Assegnazioni da tastiera
- ◐ ModificatoriX4: Shift/Ctrl sulle assegnazioni della tastiera; le assegnazioni del joystick non accettano modificatori.
- ✓ Elenco comandi creato sul tuo PC
- ✓ Monitoraggio giochi
- ✗ Curve degli assi e zone morteX4: solo la zona morta globale del gioco e le inversioni (Game settings), niente per assegnazione.
- ✓ 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
X Rebirth solo documentato
- Supporto
- solo documentato
- Comando del motore
- nessuno
- — 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
X3 (Reunion, Terran Conflict, Albion Prelude) solo documentato
- Supporto
- solo documentato
- Comando del motore
- nessuno
- — 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 X4
Prima: dai una volta uno slot a ogni dispositivo. Nelle impostazioni dei comandi di X4, apri Manage Controllers/Joysticks. Assegna ogni dispositivo a uno slot, poi esci dal gioco normalmente.
Poi: le tue assegnazioni sono in Settings > Controls.
Avevi già assegnato pulsanti in X4? 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 X4
- Importa: le assegnazioni del volo spaziale delle tue cloche, manette e pedaliere entrano nel tuo profilo, con le inversioni del gioco e la modalità della manetta.
- Relazioni: una relazione è una funzione in ogni gioco. "Boost" può essere lo stesso pulsante in X4, Elite Dangerous e Star Citizen.
- Esporta: JoyPro modifica
inputmap.xmlsul posto, negli slot dei tuoi dispositivi. Le assegnazioni di menu, prima persona, tastiera e mouse restano.
#Importa le tue assegnazioni di X4
- Apri Avvia. Se la scheda di X4 chiede un elenco comandi, premi Crea elenco: JoyPro legge i comandi del gioco dalla tua installazione (sola lettura).
- Premi Importa sulla scheda di X4. Lascia Aggiungi al mio profilo. Spunta Prendi anche i tasti della tastiera se vuoi anche i tuoi tasti di volo in JoyPro.
- Premi Importa ora. Vedi le mie relazioni apre ciò che è entrato.
#Crea e verifica le relazioni
Unisci la stessa funzione dei tuoi giochi con il flusso delle relazioni, poi premi Verifica nella pagina Esporta. Tieni le tue assegnazioni joystick senza modificatori: X4 non accetta modificatori su un'assegnazione joystick.
#Esporta in X4
- Chiudi X4. Il gioco scrive
inputmap.xmleconfig.xmlquando finisce una sessione, quindi JoyPro si rifiuta di scrivere mentre è in esecuzione. - Apri Esporta e spunta la scheda di X4.
- Lascia Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi se configuri le tue cloche in JoyPro. Premi Esporta ora sulla scheda.
Avvia il gioco e apri Settings > Controls. Le tue assegnazioni sono nella colonna controller / joystick di ogni comando del volo spaziale, sullo slot del tuo dispositivo. Invert Controller / Joystick Axes mostra le inversioni impostate da JoyPro, e le righe della manetta bidirezionale, della zona morta del joystick e dello sterzo adattivo mostrano i tuoi valori. Auto-roll e vibrazione sono nelle impostazioni del gioco.
#Cosa fai tu in X4
- Dai una volta uno slot a ogni dispositivo. Nelle impostazioni dei comandi di X4, apri Manage Controllers/Joysticks e assegna a uno slot ogni cloche, manetta e pedaliera, poi esci dal gioco normalmente. X4 ricorda allora il dispositivo in
config.xml. Un dispositivo senza questa voce si sposta tra gli slot da una sessione all'altra, quindi JoyPro lo salta ("assign the device to a slot in X4 once"). Anche un dispositivo impostato lì su "none" viene saltato. - Collega i tuoi dispositivi prima di esportare.
#Errori frequenti
- "X4 è in esecuzione": esci dal gioco ed esporta di nuovo.
- Un dispositivo è stato saltato: non è fissato a uno slot in X4. Assegnalo in Manage Controllers/Joysticks.
- Una cloche nello slot 1 fa cose da gamepad: lo slot 1 è lo slot del gamepad nella mappa predefinita di X4, quindi una cloche lì eredita le assegnazioni standard del gamepad. Sostituisci sui miei dispositivi le rimuove.
- I pulsanti oltre il 64 o un secondo hat non fanno niente: X4 legge 64 pulsanti, 8 assi e un hat per dispositivo. JoyPro salta le assegnazioni oltre questo limite con un avviso.
- Un'inversione è stata lasciata com'era: un'inversione vale per tutti i dispositivi su quel comando. Quando le tue relazioni non sono d'accordo, o un gamepad è assegnato allo stesso comando, JoyPro lascia il valore del gioco e avvisa.
#File che JoyPro legge e scrive
| File | Di cosa si tratta |
|---|---|
%USERPROFILE%\Documents\Egosoft\X4\<id>\inputmap.xml |
le assegnazioni attive (<action>, <state>, <range> per comando e input) e i parametri <config> (inversioni, zona morta, manetta bidirezionale, sterzata adattiva). <id> è la cartella dell'account Steam. |
...\X4\<id>\config.xml |
gli slot dei dispositivi (<joysticks>) e impostazioni del gioco come vibrazione, auto-roll e modalità gamepad; letto per gli slot, modificato sul posto per le impostazioni |
...\X4\<id>\inputmap.xml.joypro-meta.json |
I nomi, i gruppi e le regolazioni di JoyPro per le assegnazioni scritte, riletti dalla prossima importazione |
inputmap.xml.jpbak, config.xml.jpbak |
copie di prima della prima scrittura, più l'archivio di backup con versioni di JoyPro |
Il file viene scritto come testo: la dichiarazione, i fine riga, il rientro, i commenti delle sezioni, <config>, gli attributi della radice e ogni riga non toccata restano byte per byte. Una nuova riga va nella sua sezione dopo l'ultima voce dello stesso tipo con un numero di comando più basso. JoyPro non tocca mai i profili salvati da inputmap_1.xml a inputmap_5.xml né i tuoi salvataggi. Steam Cloud sincronizza la cartella; quali file sincronizza non è ancora confermato.
#Le modalità di esportazione in X4
Un conflitto è un altro comando di volo sullo stesso slot e input. I gemelli di un comando per la mappa e per il monitor dei dettagli contano come lo stesso comando.
| Modalità | Cosa succede in inputmap.xml |
|---|---|
| Aggiungi soltanto | Non viene rimosso niente. Un'assegnazione il cui input è usato da un altro comando di volo non viene scritta e riceve il segno "Non scritto nel gioco". |
| Aggiorna, mantieni le assegnazioni del gioco | Le tue righe vanno accanto agli altri input del comando; vengono rimossi solo i conflitti. |
| Aggiorna, prevale il mio profilo | Come sopra, e un comando che assegni perde le sue altre righe sugli slot fissati dei dispositivi collegati (con l'opzione della tastiera anche le sue righe della tastiera). |
| Sostituisci sui miei dispositivi | Le assegnazioni di volo degli slot scritti che non sono nel tuo profilo vengono rimosse, anche le assegnazioni di volo standard del gamepad sullo slot 1. |
| + Cancella anche gli altri miei dispositivi | Lo stesso per gli slot che config.xml fissa a dispositivi collegati non usati dall'esportazione. Uno slot senza un dispositivo fissato viene lasciato stare: il suo dispositivo è sconosciuto. |
Il menu di X4 assegna alcuni comandi insieme: "Toggle Travel Mode" imposta lo stesso input anche nella mappa, "Dock" serve anche per sganciarsi. JoyPro scrive e rimuove questi gruppi come fa il menu, e non rimuove mai il gemello "Interact" in prima persona.
#Cosa non viene mai toccato
- Comandi di menu, mappa, prima persona, opzioni e accessibilità; voci del menu radiale.
- Righe di tastiera e mouse; la tastiera viene scritta solo con l'opzione della tastiera, solo per i comandi di volo, mai con i tasti che il menu di X4 rifiuta (Escape, Delete, Ctrl+X/C/V ...).
- Slot di dispositivi non collegati o non fissati, gamepad, i dispositivi ignorati dall'importazione e il dispositivo vJoy in cui JoyPro convoglia gli input.
- Ogni riga
<config>che JoyPro non imposta.
#Curve e impostazioni del gioco
- Granularità: un solo set di assegnazioni per tutte le navi (i comandi di volo spaziale).
- Le inversioni sono un valore per comando per tutti i dispositivi (
invert_steering_yaw,_pitch,_roll,invert_throttle,invert_strafe_*). La tua relazione mantiene la direzione di DCS; le mappe HOTAS di X4 contano pitch, roll e throttle come invertiti, quindi per questi JoyPro imposta il parametro alla tua inversione capovolta. Imposta un parametro solo quando tutti gli assi JoyPro su quel comando concordano. - La manetta bidirezionale segue lo Slider della relazione della manetta: Slider = solo avanti, nessuno Slider = il centro è spinta zero.
- Zona morta: X4 ha una sola zona morta per ogni asse di ogni joystick. Le zone morte delle relazioni non vengono scritte (l'esportazione lo dice); imposta la zona morta del gioco in Impostazioni > Impostazioni force feedback dei giochi (scegli X4) o con
engine ffb set. Lo stesso posto contiene sterzata adattiva, vibrazione, auto-roll e modalità gamepad. Un'impostazione che salvi lì prevale sulle relazioni, con un avviso quando le inverte. - In X4 niente curve o saturazione per asse; niente force feedback; niente telemetria.
- Monitoraggio: un'assegnazione o un'opzione che cambi nel gioco viene notata dopo la sua chiusura (
inputmap.xmleconfig.xml), e JoyPro chiede se acquisirla. - HUD: l'HUD trova il gioco dal suo processo e mostra le tue assegnazioni di X4.
#X Rebirth e X3
X Rebirth usa le stesse parole di inputmap.xml di X4, ma il suo elenco comandi richiederebbe un'estrazione propria da un'installazione. X3 (Reunion, Terran Conflict, Albion Prelude) ha un altro motore e un formato di file sconosciuto. Entrambi sono solo documentati: JoyPro non li importa né li esporta.
#Dentro l'integrazione di X4
flowchart LR D["Il tuo dispositivo<br/>(GUID di istanza)"] --> C["config.xml<br/>joysticks"] C --> S["Fissato a uno slot:<br/>slot 1 ... 8"] C --> K["Non fissato o disattivato:<br/>saltato, assegnalo<br/>una volta in X4"] P["Il tuo profilo"] --> E["engine x4 export"] S --> E E --> I["inputmap.xml<br/>assegnazioni per slot"] E --> O["opzioni valide per tutto il gioco:<br/>inversioni, modalità della manetta"]
Codice: engine\Games\X4Integration.cs, engine\Games\X4CatalogSource.cs e il modello delle impostazioni engine\FfbModels\X4.cs.
- Slot: un'assegnazione nomina una sorgente:
INPUT_SOURCE_JOYBUTTONS(pulsanti e hat) oINPUT_SOURCE_JOYAXES, senza suffisso per lo slot 1 e da_2a_8per gli altri.config.xmlassocia i dispositivi agli slot tramite il GUID d'istanza DirectInput, scritto nella forma propria di X4 ({42cec570-0a3f-11f0-80-0b-44-45-53-54-00-00});numda 0 a 7 è lo slot,disabled="1"significa nessuno. JoyPro scrive solo negli slot la cui voce attuale e attiva corrisponde a un dispositivo collegato. - Codici: i pulsanti da 1 a 11 usano i nomi del gamepad di X4 (
INPUT_XBUTTON_A...BIGBUTTON), da 12 a 64INPUT_XBUTTON_12...; l'hatINPUT_XBUTTON_DPAD_*(otto direzioni); gli assiINPUT_JOYAXIS_X...RZ,SLIDER1,SLIDER2. Gli intervalli non ricevonosgn. Tastiera:INPUT_KEYCODE_<DIK>con_SHIFT/_CONTROL. - Elenco comandi:
engine x4 refresh-dbleggegameoptions.luae la pagina di testo inglese dagli archivi.cat/.date le tabelle dei nomi diX4.exe, in sola lettura; 128 comandi di volo spaziale (6 assi, 122 pulsanti). Le righe si leggono come "Yaw (Primary Steering Axis)", "Roll (Secondary Steering Axis)".engine x4 cataloglo elenca,engine x4 pathsmostra i file trovati. - Importazione / esportazione:
engine x4 import,engine x4 scan;engine x4 export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --include-keyboard --ignore-device <d> --dry-run. - Impostazioni del gioco:
engine ffb set --device * --game X4 --param <key>=<value>; i parametri vengono modificati sul posto, uno mancante viene aggiunto come ultima riga di<config>. Un'esportazione senza assegnazioni di X4 scrive comunque le impostazioni salvate.
#Limiti noti
- I dispositivi senza uno slot fissato vengono saltati; JoyPro non li fissa ancora da sé.
- I modificatori del joystick non vengono scritti: la loro marcatura nel file non è ancora confermata.
- 64 pulsanti, 8 assi e un hat per dispositivo; otto slot, condivisi con i gamepad.
- Vibrazione: il cursore del gioco mostra il valore per 100 troncato (21 % appare come 20); il file mantiene il valore esatto.
- Test:
engine\tests\smoke\x4.ps1(anche l'aggiornamento del catalogo); nel giocotools\e2e\games\X4.ps1(assegnazioni e matrice delle modalità, nella sua cartella del profilo) etools\e2e\games\X4Settings.ps1(inversioni, modalità della manetta, impostazioni del gioco).
Tutte le note tecniche su questo gioco (generate dal repository): x4.md.