G-Rebels è un gioco di combattimento aereo cyberpunk su Unreal Engine 5: piloti un VTOL sopra le megalopoli. Il gioco mette ogni joystick che attivi su un canale (da 0 a 5) e salva il ruolo di ogni asse (beccheggio, rollio, imbardata, spinta, strafe, su / giù) e le assegnazioni dei pulsanti per canale in due file di salvataggio. JoyPro legge quei ruoli e quelle assegnazioni nel tuo profilo e li riscrive; tastiera, gamepad e mouse restano come li ha il gioco.
G-Rebels nativo (i suoi file di assegnazioni)
- Supporto
- nativo (i suoi file di assegnazioni)
- Comando del motore
engine grebels- File di assegnazioni
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav(GVAS, ruoli degli assi modificati sul posto) +EnhancedInputUserSettings.sav(pulsanti)- Input che il gioco legge
- legge 96 pulsanti, 24 assi, nessun hat per joystick (documentato)
- Elenco comandi da
- la tabella di JoyPro (ruoli degli assi, pulsanti)
- Test nel gioco
- 18/18 passi superati (2026-10-11)
- ✓ Importa
- ✓ Esporta
- ✗ Assegnazioni da tastiera
- ✗ Modificatori
- ✓ Elenco comandi creato sul tuo PC
- ✓ Monitoraggio giochi
- ✗ Curve degli assi e zone morteG-Rebels: solo inversione.
- ✗ 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 G-Rebels chiuso
Prima, una volta per dispositivo nel gioco: dagli un canale in OPTIONS > INPUT > DEVICES. Cambia un ruolo d'asse nella sua scheda JST. Assegna un pulsante. (Dettagli qui sotto.)
Poi: le tue assegnazioni compaiono nella scheda JST del dispositivo.
Avevi già assegnato dei pulsanti in G-Rebels? Allora la pagina Start ti offre 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 G-Rebels
- Importa: i ruoli degli assi di ogni canale (quale asse della cloche è beccheggio, rollio, imbardata, spinta, strafe laterale, su / giù), con l'inversione, e le assegnazioni dei pulsanti che JoyPro conosce entrano nel tuo profilo sui tuoi dispositivi reali.
- Relazioni: "Beccheggio" in G-Rebels può essere la stessa relazione del beccheggio negli altri tuoi giochi.
- Esporta: JoyPro imposta i ruoli degli assi e le assegnazioni dei pulsanti sui canali dei tuoi dispositivi. Non aggiunge mai un canale o un dispositivo: questa parte la fai una volta nel gioco.
#Importa le tue assegnazioni di G-Rebels
- Apri Avvia. Se la scheda di G-Rebels chiede un elenco comandi, premi Crea elenco: JoyPro scrive la sua tabella dei ruoli degli assi e dei pulsanti del gioco.
- Premi Importa sulla scheda di G-Rebels, lascia Aggiungi al mio profilo (consigliato) e premi Importa ora.
- Vedi le mie relazioni apre ciò che è entrato.


#Crea e verifica le relazioni
Assegna le tue relazioni alle azioni di G-Rebels nella pagina Relazioni (vedi il flusso delle relazioni), poi esegui Verifica nella pagina Esporta. G-Rebels permette un ruolo per asse e un pulsante per azione e canale; la Verifica mostra dove due relazioni vogliono lo stesso input.
#Esportare in G-Rebels
- Chiudi G-Rebels. JoyPro si rifiuta di scrivere mentre il gioco è in esecuzione.
- Apri Esporta e spunta la scheda di G-Rebels.
- Lascia Sostituisci sui miei dispositivi con Cancella anche gli altri miei dispositivi se configuri le tue cloche in JoyPro. Premi Esporta ora sulla scheda.


Apri OPTIONS > INPUT > CONTROLS e la scheda JST<channel> del tuo dispositivo (JST0 per il canale 0). In AXIS ogni asse del joystick (X, Y, Z, RX, RY, RZ, Slider, Dial) mostra il ruolo impostato da JoyPro (YAW, THRUST, ROLL, PITCH, SIDE STRAFE, UP / DOWN o NONE). In BUTTONS l'azione assegnata mostra il tuo pulsante, per esempio "Enhanced Raw Input Controller 0 Button 5".
#Cosa fai tu in G-Rebels
Fallo una volta per dispositivo, prima della prima esportazione:
- Attiva il dispositivo: OPTIONS > INPUT > DEVICES elenca ogni joystick con DEACTIVATED. Dai un canale a ogni dispositivo che vuoi (0 - CHANNEL ... 5 - CHANNEL). Un dispositivo senza canale viene saltato dall'esportazione con "attivalo in OPTIONS > INPUT > DEVICES".
- Cambia un ruolo d'asse nella scheda JST del dispositivo. Solo allora il gioco salva le righe degli assi di quel canale; JoyPro le modifica direttamente e non le aggiunge mai. Aprire solo la scheda non salva niente.
- Assegna un pulsante nel gioco una volta. Il file dei pulsanti compare con la prima assegnazione.
#Errori frequenti
- Un ruolo d'asse non viene scritto: il canale non ha ancora righe degli assi salvate. Cambia un ruolo d'asse nella sua scheda JST nel gioco, chiudi il gioco, esporta di nuovo.
- Manca un'assegnazione di pulsante: finora tra i pulsanti del gioco è confermato solo Primary Fire; le altre azioni seguiranno quando i loro nomi saranno noti.
- Più dispositivi raw input condividono i tasti: metti l'intero HOTAS su un solo dispositivo con il Joystick virtuale; così gli serve un solo canale.
#File che JoyPro legge e scrive
| File | Di cosa si tratta |
|---|---|
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav |
i dispositivi con i loro canali (tramite percorso HID) e una riga per ogni asse di ogni canale: ruolo, inversione, zona morta, moltiplicatore |
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\EnhancedInputUserSettings.sav |
le assegnazioni dei pulsanti, una mappatura per azione e canale |
...\SaveOptions.sav.joypro-meta.json |
I dati di JoyPro sulle assegnazioni esportate (nomi, gruppi), riletti dalla prossima importazione |
Di entrambi i file di salvataggio si fa il backup prima della prima scrittura (.jpbak accanto a essi e l'archivio di backup di JoyPro).
#Le modalità di esportazione in G-Rebels
Un ruolo per asse e un tasto per azione e canale. Le stesse regole valgono per i ruoli degli assi e per i pulsanti.
| Modalità | Cosa succede |
|---|---|
| Aggiungi soltanto | Un ruolo va solo su un asse che non ne ha; un asse con un altro ruolo viene saltato e segnato "Non scritto nel gioco". |
| Aggiorna, mantieni le assegnazioni del gioco | Il ruolo del profilo va sul suo asse (il ruolo che c'era se ne va); il ruolo resta sui suoi altri assi. Un pulsante: la mappatura di un'altra azione sul tasto se ne va. |
| Aggiorna, prevale il mio profilo | Come sopra, e gli altri assi del ruolo sui canali collegati ricevono NONE. |
| Sostituisci sui miei dispositivi | Ogni altro ruolo di un canale scritto diventa NONE. |
| + Cancella anche gli altri miei dispositivi | Lo stesso sui canali attivi e collegati che JoyPro non scrive. |
#Cosa non viene mai toccato
- Tastiera, gamepad, mouse e le altre opzioni del gioco.
- Un canale il cui dispositivo non è collegato mantiene i suoi ruoli.
- I dispositivi ignorati dall'importazione e il dispositivo vJoy in cui JoyPro inoltra i comandi.
- L'elenco dei dispositivi del gioco: JoyPro non accende né spegne mai un dispositivo e non aggiunge mai un canale.
#Assi e altre impostazioni
- Globale: un solo insieme di assegnazioni per canale, nessun profilo per velivolo.
- Inverti viene scritto insieme al ruolo. Hat (le righe POV), zona morta e sensibilità non vengono ancora scritti.
- Nessuna impostazione generale del gioco, niente force feedback.
- Monitoraggio: un ruolo o un'assegnazione che cambi nel gioco viene notato dopo la sua chiusura (il monitoraggio).
- HUD: mentre G-Rebels è in esecuzione, l'HUD mostra il nome dell'azione di ogni pulsante premuto.
- Il gioco legge fino a 96 pulsanti e 24 assi per dispositivo, niente hat.
#Dentro l'integrazione di G-Rebels
flowchart LR D["G-Rebels: DEVICES<br/>dispositivo sul canale 0-5"] --> S P["Il tuo profilo<br/>(relazioni + assegnazioni)"] --> E["engine grebels export"] E --> S["SaveOptions.sav<br/>ruoli degli assi + inversione<br/>per canale"] E --> B["EnhancedInputUserSettings.sav<br/>assegnazioni dei pulsanti per canale"] S --> G["G-Rebels: CONTROLS ><br/>scheda JST del canale"] B --> G
Codice: engine\Games\GRebelsIntegration.cs, engine\Games\GRebelsSaveOptions.cs, engine\Games\GvasKeyMappings.cs.
- SaveOptions.sav: Unreal GVAS (UE 5.8, tag delle proprietà con alberi di tipi).
JoystickscontieneS_Controller_Save { DeviceID (HID path), Enabled, MultiID (channel) };AxisOptionscontieneS_Input_Axis_Save { Key, Offset, Multiplier, Role, Inverted, DeadZone }con chiavi comeRawInput_Controller0_AxisYe il ruolo come enum (0 Yaw, 1 Thrust, 2 Roll, 3 Pitch, 4 Side strafe, 5 Up/down, 6 None). Nessun checksum: JoyPro modifica sul posto valori a dimensione fissa. - EnhancedInputUserSettings.sav: tasti mappati dal giocatore di Unreal Enhanced Input. I nomi delle mappature sono
<ACTION>JST<channel>(PRIMARYFIREJST0), i tastiRawInput_Controller<channel>_Button<n>con n il numero del pulsante DirectInput. L'elenco delle mappature viene riscritto; ogni altro byte resta. - Dispositivi: abbinati tramite percorso HID al canale che il gioco ha dato loro.
- Elenco comandi: la tabella propria di JoyPro (
DB\GRebels\actions.tsv, ruoli degli assi e pulsanti; i file del gioco non vengono letti).engine grebels refresh-dbla scrive nella cartella dei dati del gioco; le righe già presenti mantengono la loro voce. - Comandi:
engine grebels paths,engine grebels catalog,engine grebels scan,engine grebels import,engine grebels export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --dry-run.
#Limiti noti
- Hat, zona morta e sensibilità non vengono scritti.
- Dei pulsanti, nel gioco è confermato solo Primary Fire.
- Le voci non vengono mai aggiunte: canali, righe degli assi e il file dei pulsanti devono già esistere, creati dal gioco.
- Test:
engine\tests\smoke\grebels.ps1; nel giocotools\e2e\games\GRebelsSettings.ps1(due avvii: il primo dà un canale a vJoy e salva le righe degli assi, il secondo verifica ruoli casuali e Primary Fire su JST0; alla fine la cartella dei salvataggi viene ripristinata).
Tutte le note tecniche su questo gioco (generate dal repository): g-rebels.md.