JoyPro2 Discord GitHub
Giochi

X4: Foundations

Mostra:

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 in config.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.exe e 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.

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 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.xml sul posto, negli slot dei tuoi dispositivi. Le assegnazioni di menu, prima persona, tastiera e mouse restano.

#Importa le tue assegnazioni di X4

  1. 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).
  2. 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.
  3. 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

  1. Chiudi X4. Il gioco scrive inputmap.xml e config.xml quando finisce una sessione, quindi JoyPro si rifiuta di scrivere mentre è in esecuzione.
  2. Apri Esporta e spunta la scheda di X4.
  3. Lascia Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi se configuri le tue cloche in JoyPro. Premi Esporta ora sulla scheda.
Nel gioco: Cosa vedi in X4

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

#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.xml e config.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.

Dettagli tecnici interni

#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"]
X4 nomina un joystick con il suo slot. Un dispositivo senza uno slot fisso viene saltato.

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) o INPUT_SOURCE_JOYAXES, senza suffisso per lo slot 1 e da _2 a _8 per gli altri. config.xml associa 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}); num da 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 64 INPUT_XBUTTON_12 ...; l'hat INPUT_XBUTTON_DPAD_* (otto direzioni); gli assi INPUT_JOYAXIS_X ... RZ, SLIDER1, SLIDER2. Gli intervalli non ricevono sgn. Tastiera: INPUT_KEYCODE_<DIK> con _SHIFT / _CONTROL.
  • Elenco comandi: engine x4 refresh-db legge gameoptions.lua e la pagina di testo inglese dagli archivi .cat/.dat e le tabelle dei nomi di X4.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 catalog lo elenca, engine x4 paths mostra 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 gioco tools\e2e\games\X4.ps1 (assegnazioni e matrice delle modalità, nella sua cartella del profilo) e tools\e2e\games\X4Settings.ps1 (inversioni, modalità della manetta, impostazioni del gioco).

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