JoyPro2 Discord GitHub
Giochi

Star Citizen

Mostra:

Star Citizen tiene tutti i tuoi comandi in un unico file, actionmaps.xml, e numera le tue cloche come slot joystick da js1 a js8. JoyPro legge le assegnazioni della nave di quel file nel tuo profilo e le riscrive sul posto: cambiano solo le azioni della nave e le impostazioni dei loro assi, ogni altra riga resta come l'ha scritta il gioco. Un dispositivo mantiene lo slot che il gioco gli ha già dato, così le tue assegnazioni non saltano da una cloche all'altra.

Star Citizen nativo (i suoi file di assegnazioni)
Supporto
nativo (i suoi file di assegnazioni)
Comando del motore
engine starcitizen
File di assegnazioni
LIVE\user\client\0\Profiles\default\actionmaps.xml + attributes.xml (XML)
Elenco comandi da
Data.p4k (defaultProfile.xml) e i tuoi profili
Test nel gioco
54/54 passi superati (2026-10-10)
  • ✓ 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 Star Citizen

Prima: collega ogni dispositivo che usi.

Poi: le tue assegnazioni sono in Options > Controls.

Avevi già assegnato pulsanti in Star Citizen? 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 Star Citizen

  • Importa: le assegnazioni della nave su cloche, manette e pedaliere entrano nel tuo profilo, con zone morte, curve e inversioni. Entrano anche le assegnazioni joystick predefinite del gioco su js1, così un'esportazione successiva non le perde.
  • Relazioni: una relazione è una funzione in ogni gioco. "Landing gear" può essere lo stesso interruttore in Star Citizen, DCS ed Elite Dangerous.
  • Esporta: JoyPro modifica actionmaps.xml sul posto. Le assegnazioni a piedi, dei veicoli e dei menu, del mouse e del gamepad restano come sono.

#Importa le tue assegnazioni di Star Citizen

  1. Apri Avvia. Se la scheda di Star Citizen chiede un elenco comandi, premi Crea elenco: JoyPro legge le azioni del gioco dalla tua installazione (Data.p4k, sola lettura). Dopo una patch del gioco, Aggiorna sulla scheda aggiunge le nuove azioni.
  2. Premi Importa sulla scheda di Star Citizen. Lascia Aggiungi al mio profilo. Spunta Prendi anche i tasti della tastiera solo se vuoi anche i tasti della nave in JoyPro.
  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

Ogni azione della nave è una voce in una relazione. Unisci la stessa funzione degli altri tuoi giochi con il flusso delle relazioni, poi premi Verifica nella pagina Esporta: trova un pulsante che fa due cose sulla tua nave prima che lo faccia il gioco.

#Esporta in Star Citizen

  1. Chiudi Star Citizen. Il gioco riscrive actionmaps.xml quando si chiude, quindi JoyPro si rifiuta di scrivere mentre è in esecuzione.
  2. Apri Esporta e spunta la scheda di Star Citizen.
  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.
La pagina EsportaLa pagina Esporta
La pagina Esporta
Nel gioco: Cosa vedi in Star Citizen

Avvia il gioco e apri Options > Controls dal menu principale. Scegli il tuo dispositivo (Joystick / HOTAS 1, 2 ...): la sua zona morta e la saturazione sono quelle impostate in JoyPro; Inversion Settings e Joystick Sensitivity Curves (Flight > Flight Movement) mostrano le tue inversioni, gli esponenti e le curve. Le assegnazioni della nave sono sullo slot joystick di ogni dispositivo. Le impostazioni predefinite del gioco che JoyPro ha disattivato appaiono vuote. Il menu mostra la saturazione 0.01 più alta di quella nel file (0.87 appare come 0.88); il gioco mantiene il valore esatto.

#Cosa fai tu in Star Citizen

  • Nient'altro per le assegnazioni. Collega ogni dispositivo che usi prima di esportare: un dispositivo non collegato mantiene il suo slot e le sue assegnazioni, ma JoyPro non può dargliene di nuove.
  • Se il gioco si trova in una cartella diversa da quella rilevata, imposta il percorso una volta nella pagina Esporta sotto Opzioni e percorsi (per esperti), oppure collega la cartella in Impostazioni > Giochi.

#Errori frequenti

  • "Star Citizen è in esecuzione": chiudi il gioco (anche dal launcher) ed esporta di nuovo.
  • Le assegnazioni sono finite sulla cloche sbagliata: lascia attivo SC: preferisci ordine locale (l'impostazione predefinita). Se è disattivato, gli slot seguono l'ordine in cui Windows segnala i dispositivi, e questo può spostare ogni assegnazione di un dispositivo su un altro numero js.
  • Un dispositivo non ha ricevuto uno slot: il gioco ha otto slot joystick. JoyPro unisce in un solo slot le voci doppie di una stessa cloche (il nome del gioco e il nome di JoyPro), ma più di otto dispositivi collegati con assegnazioni non ci stanno.
  • Un'assegnazione predefinita è tornata su js1: torna quando il dispositivo su js1 non è collegato al momento dell'esportazione. Collegalo ed esporta di nuovo con Sostituisci.
Avanzate

#File che JoyPro legge e scrive

File Di cosa si tratta
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml le tue riassegnazioni, gli slot joystick (<options type="joystick" instance="1..8" Product="...">), i gruppi di opzioni per slot (inversione, esponente, curva, sensibilità) e le opzioni del dispositivo (zona morta, saturazione per asse fisico)
...\Profiles\default\attributes.xml impostazioni valide per tutto il gioco (<Attr name="..." value="..."/>), solo i valori diversi da quelli predefiniti del gioco
...\Profiles\default\actionmaps.jp la copia di JoyPro del file scritto con i nomi delle relazioni come commenti, riletta dalla prossima importazione
...\Profiles\default\actionmaps.xml.joypro.json le impostazioni degli assi che JoyPro ha scritto per ultime, così "Aggiorna" distingue un valore che hai cambiato nel gioco dal proprio
actionmaps.xml.jpbak, attributes.xml.jpbak copie di prima della prima scrittura di un'esportazione, più l'archivio dei backup con versioni di JoyPro

L'esportazione modifica actionmaps.xml sul posto: cambiano solo le riassegnazioni delle navi e le impostazioni degli assi delle riassegnazioni d'asse che JoyPro scrive. Le altre action map, le riassegnazioni di mouse e gamepad, le modalità di attivazione, i modificatori, gli altri gruppi di opzioni e le opzioni dei dispositivi restano byte per byte. Un profilo senza assegnazioni di Star Citizen lascia il file com'è.

#Gli slot joystick

Star Citizen nomina ogni assegnazione joystick con il suo slot: js1_button3, js2_x. Il file elenca quale dispositivo occupa quale slot, tramite il nome prodotto DirectInput e il GUID prodotto del dispositivo.

  • Preferisci ordine locale (attivo di default): un dispositivo collegato che il file nomina già mantiene quello slot. Gli altri dispositivi riempiono gli slot liberi nell'ordine in cui li riporta Windows.
  • Un dispositivo, uno slot: la stessa cloche elencata due volte (con il nome del gioco e con il nome d'istanza di JoyPro, o una vecchia seconda voce) occupa un solo slot. L'esportazione rimuove le voci doppie e sposta le loro assegnazioni nello slot che il dispositivo mantiene. Le voci dei dispositivi non collegati restano.
  • Due dispositivi collegati dello stesso modello restano separati.
  • Un dispositivo che cambia slot porta con sé i suoi gruppi di opzioni (inversione, curve). Un dispositivo che non riceve uno slot perde i gruppi del suo vecchio slot, con un avviso.

#Le modalità di esportazione in Star Citizen

Ogni modalità cambia solo le azioni delle navi. Le mappe a piedi, dei veicoli e dei menu restano byte per byte.

Modalità Cosa succede nel gioco
Aggiungi soltanto Nessuna assegnazione del gioco cambia. Un'azione il cui slot joystick contiene già una riassegnazione o un valore predefinito attivo lo mantiene. Un'assegnazione su un input usato da un'altra azione della nave non viene scritta e riceve il segno "Non scritto nel gioco".
Aggiorna, mantieni le assegnazioni del gioco Il tuo input va nello slot joystick dell'azione (Star Citizen ne ha uno per azione e tipo di input). Un'assegnazione del gioco su un input che dai a un'altra azione della nave viene liberata: la sua riassegnazione sparisce, o diventa un js1_ vuoto quando l'azione ha un valore predefinito, così il predefinito non ritorna.
Aggiorna, prevale il mio profilo Come sopra; con l'opzione della tastiera un'azione che assegni perde anche la sua riassegnazione della tastiera.
Sostituisci sui miei dispositivi I dispositivi scritti mantengono solo le tue assegnazioni delle navi. Con un dispositivo su js1, le assegnazioni predefinite js1 del gioco che il tuo profilo non ha vengono disattivate.
+ Cancella anche gli altri miei dispositivi I dispositivi collegati senza assegnazioni nel tuo profilo perdono le loro assegnazioni delle navi; le assegnazioni predefinite di js1 vengono disattivate quando js1 non è usato.

Opzioni nella pagina Esporta (in Opzioni e percorsi (per esperti)):

  • SC: mantieni predefiniti della tastiera (attivo): la tastiera mantiene i tasti predefiniti del gioco. Disattivo: le tue assegnazioni della tastiera vengono scritte e i tasti predefiniti che occupano vengono liberati.
  • SC: preferisci ordine locale (attivo): vedi gli slot joystick sopra.
Opzioni e percorsi (per esperti) nella pagina EsportaOpzioni e percorsi (per esperti) nella pagina Esporta
Opzioni e percorsi (per esperti) nella pagina Esporta

#Le assegnazioni joystick predefinite del gioco

Star Citizen ha assegnazioni joystick predefinite che agiscono su js1 finché un'azione non riceve lì una riassegnazione (pitch su Y, yaw su X, roll sulla rotazione Z, alcuni pulsanti). L'importazione prende ogni valore predefinito attivo come assegnazione del dispositivo js1, così il tuo profilo contiene ciò che il gioco fa davvero. L'esportazione non scrive nessuna riassegnazione per un'assegnazione uguale al predefinito (solo le vere differenze). Sostituisci e Cancella anche disattivano i predefiniti che il tuo profilo non ha con una riassegnazione vuota js1_ , come scrive il menu del gioco stesso per un'assegnazione cancellata, e solo quando il dispositivo su js1 è collegato. Quindi importare e poi Sostituisci + Cancella anche lascia actionmaps.xml com'era.

#Cosa non viene mai toccato

  • Assegnazioni a piedi, dei veicoli terrestri e dei menu (i veicoli terrestri di Star Citizen contano come una classe di veicoli a sé).
  • I dispositivi non collegati: mantengono il loro slot e le loro riassegnazioni.
  • I dispositivi ignorati dall'importazione e il dispositivo vJoy in cui JoyPro inoltra i comandi.
  • Assegnazioni di mouse e gamepad; la tastiera, a meno che tu non esporti assegnazioni della tastiera.
  • Modalità di attivazione, modificatori, altri gruppi di opzioni e opzioni dei dispositivi.

#Navi, curve, impostazioni del gioco

  • Granularità: un solo set di assegnazioni delle navi per tutte le navi (il gioco non ha assegnazioni per nave).
  • Curve degli assi, in due posti come le tiene il gioco: zona morta e saturazione per dispositivo e asse fisico; inversione, esponente (da 1 a 3), una curva a 11 punti e sensibilità per slot e gruppo di opzioni. Esponente e curva si escludono a vicenda, come nel menu del gioco. Una relazione senza valori di Star Citizen riceve la sua curva JoyPro adattata: zona morta e saturazione vanno sull'asse del dispositivo, la curvatura diventa l'esponente più vicino, o la curva quando nessun esponente va bene. Non esiste un asse a un solo lato: la manetta assoluta e quella relativa del gioco sono azioni separate.
  • Aggiorna mantiene un valore d'asse che hai cambiato nel gioco (con un avviso); Sostituisci e prevale il mio profilo impostano i valori del tuo profilo. Una relazione neutra lascia il valore del gioco (la visuale libera mantiene il suo esponente predefinito 2.5).
  • Impostazioni valide per tutto il gioco (attributes.xml): HOTAS thrust invert toggle, il tempo e la soglia del trap della manetta relativa, i modificatori di sensibilità IFCS, ESP attivo, forza e smorzamento, ESP delle torrette, i valori di volo predefiniti (sticky throttle, speed limiter, coupled, G-safe, auto precision, space brake), invert flight controller e Vibration. Impostali in Impostazioni > Impostazioni force feedback dei giochi (scegli Star Citizen) o con engine ffb set. JoyPro cambia solo le righe che imposti, sul posto, e non crea il file. Il cursore della forza ESP finisce a 1.00, quindi JoyPro offre da 0 a 1.
  • Force feedback: nessuno. Vibration è l'unica impostazione di questo tipo del gioco.
  • Monitoraggio: un'assegnazione o un valore d'asse che cambi nel menu del gioco viene notato dopo la chiusura del gioco, e JoyPro chiede se acquisirlo. Confronta actionmaps.xml (solo le action map delle navi) e le impostazioni che JoyPro gestisce in attributes.xml.
  • HUD: l'HUD trova il gioco dal suo processo e mostra le tue assegnazioni di Star Citizen.
Dettagli tecnici interni

#Dentro l'integrazione di Star Citizen

flowchart LR
  A[("actionmaps.xml")] --> S["Slot per dispositivo"]
  D["Dispositivi connessi"] --> S
  P["Il tuo profilo"] --> E["engine starcitizen export"]
  S --> E
  E --> X["actionmaps.xml"]
  E --> T["attributes.xml"]
  X --> G["Options ><br/>Controls"]
Un dispositivo noto mantiene il suo slot joystick (js1 ... js8 in actionmaps.xml). Un nuovo dispositivo riceve il primo slot libero; un duplicato vecchio viene rimosso. Le riassegnazioni delle navi vengono modificate sul posto, le impostazioni valide per tutto il gioco vanno in attributes.xml.

Codice: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, il modello d'asse engine\AxisModels\StarCitizen.cs e il modello delle impostazioni engine\FfbModels\StarCitizen.cs.

  • Nomi dei dispositivi: il Product dello slot è il nome prodotto DirectInput e il GUID prodotto, separati da due spazi (vJoy Device {BEAD1234-0000-0000-0000-504944564944}). Uno slot o un blocco deviceoptions scritto con un altro nome (un GUID d'istanza) non viene riconosciuto dal gioco: riscrive lo slot con il suo prodotto e scarta i gruppi di opzioni dello slot. Per questo JoyPro scrive il nome prodotto del dispositivo collegato.
  • Elenco comandi: engine db refresh-starcitizen legge Data\Libs\Config\defaultProfile.xml da Data.p4k (o da una copia estratta con --source) in DB\StarCitizen\AllBinds.xml: ogni azione con il suo gruppo di opzioni, l'albero delle opzioni del joystick (genitori e valori predefiniti, quali gruppi mostrano una curva) e l'input joystick predefinito dell'azione. engine starcitizen labels prende i nomi dei comandi del gioco da global.ini.
  • Importa: engine starcitizen import (--include-keyboard, --device, --ignore-device); ogni riassegnazione d'asse riceve i valori che il gioco usa (il gruppo foglia dello slot, altrimenti il genitore più vicino che hai impostato, altrimenti il valore predefinito del gioco) e le opzioni del dispositivo del suo asse, come sua regolazione game:StarCitizen. engine starcitizen scan mostra lo stesso senza cambiare il profilo; engine starcitizen list-devices elenca gli slot joystick del file.
  • Esporta: engine starcitizen export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --prefer-local-order true|false --include-keyboard true|false --ignore-device <d>. Un nuovo blocco deviceoptions va prima del primo <options>; più relazioni su un gruppo di opzioni o su un asse fisico con valori diversi danno un avviso, e vince la prima relazione per nome.
  • Impostazioni del gioco: engine ffb set --device * --game StarCitizen --param <Attr name>=<value>; una riga esistente riceve il valore, una nuova va al suo posto in ordine.
  • Backup: engine backups list elenca le copie; Annulla ultima esportazione sulla scheda ripristina la più recente.

#Limiti noti

  • Otto slot joystick; il limite di pulsanti per dispositivo non è noto (le fonti non concordano).
  • Dove il gioco vuole un nuovo blocco deviceoptions, l'interpolazione della curva (il menu disegna una spline morbida attraverso i punti), l'intervallo dell'esponente e se la sensibilità vale per i joystick non sono ancora confermati. Gli intervalli delle impostazioni valide per tutto il gioco non sono nei file leggibili del gioco.
  • Se Vibration comanda una cloche force feedback DirectInput non è ancora confermato.
  • Test: engine\tests\smoke\starcitizen.ps1 (aggiornamento del catalogo, importazione di gruppi di opzioni e curve, importazione + esportazione byte per byte, ogni impostazione degli assi, conflitti, cambi di slot, attributes.xml sul posto); nel gioco tools\e2e\games\StarCitizenSettings.ps1 (Options del menu principale: impostazioni, assegnazioni e curve) e tools\e2e\games\StarCitizen.ps1 (matrice delle modalità di esportazione e importazione).

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