G-Rebels é um jogo de combate aéreo cyberpunk em Unreal Engine 5: voa um VTOL sobre megacidades. O jogo põe cada joystick que liga num canal (0 a 5) e guarda a função de cada eixo (picada, rolamento, guinada, impulso, deslocação lateral, cima / baixo) e as atribuições de botões por canal em dois ficheiros de gravação. O JoyPro lê essas funções e atribuições para o seu perfil e escreve-as de volta; teclado, gamepad e rato ficam como o jogo os tem.
G-Rebels nativo (os seus próprios ficheiros de atribuições)
- Suporte
- nativo (os seus próprios ficheiros de atribuições)
- Comando do motor
engine grebels- Ficheiro de atribuições
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav(GVAS, funções dos eixos alteradas no local) +EnhancedInputUserSettings.sav(botões)- Entradas que o jogo lê
- lê 96 botões, 24 eixos, nenhum hat por joystick (documentado)
- Lista de comandos a partir de
- a tabela do próprio JoyPro (funções dos eixos, botões)
- Teste no jogo
- 18/18 passos concluídos (2026-10-11)
- ✓ Importar
- ✓ Exportar
- ✗ Atribuições de teclado
- ✗ Modificadores
- ✓ Lista de comandos criada no seu PC
- ✓ Monitor de jogos
- ✗ Curvas de eixo e zonas mortasG-Rebels: só inversão.
- ✗ Configurações de controlo do jogo
- ✗ Configurações de force feedback no jogo
- ✗ Force feedback a partir da telemetria
- ✗ Gravação de telemetria
- ✓ Joystick virtual (vJoy)
- ◐ Comando Xbox virtual
- ✓ Funções virtuais
- ◐ Assistente de configuração / Atribuição automática
- ✗ Cockpits
- ✓ Folhas de referência
- ✓ Teste no jogo
Da matriz de suporte, gerada a partir do código do motor: todos os jogos.
#Pôr a funcionar em 3 passos
- Configurar tudo por mim
na página Início - Usar estes botões
veja primeiro a lista - Escrever no meu jogo
com o G-Rebels fechado
Antes, uma vez por dispositivo no jogo: dê-lhe um canal em OPTIONS > INPUT > DEVICES. Mude uma função de eixo no seu separador JST. Atribua um botão. (Detalhes abaixo.)
Depois: as suas atribuições aparecem no separador JST do dispositivo.
Já atribuiu botões no G-Rebels antes? Então a página Início oferece Importar e depois preencher lacunas. As suas atribuições ficam, e só os botões livres recebem novas funções. Veja Início rápido: pôr o meu manche a funcionar.
#O que o JoyPro faz pelo G-Rebels
- Importar: as funções dos eixos de cada canal (que eixo do manche é picada, rolamento, guinada, impulso, deslocação lateral, cima / baixo), com a inversão, e as atribuições de botões que o JoyPro conhece entram no seu perfil, nos seus dispositivos reais.
- Relações: "Pitch" no G-Rebels pode ser a mesma relação que a picada nos seus outros jogos.
- Exportar: o JoyPro define as funções dos eixos e as atribuições de botões nos canais dos seus dispositivos. Nunca adiciona um canal nem um dispositivo: essa parte faz você uma vez no jogo.
#Importar as suas atribuições do G-Rebels
- Abra Iniciar. Se o cartão do G-Rebels pedir uma lista de comandos, prima Criar lista: o JoyPro escreve a sua própria tabela das funções de eixo e dos botões do jogo.
- Prima Importar no cartão do G-Rebels, mantenha Adicionar ao meu perfil (recomendado) e prima Importar agora.
- Ver as minhas relações abre o que entrou.


#Criar e verificar relações
Atribua as suas relações às ações do G-Rebels na página Relações (veja o fluxo das relações) e depois execute Verificar na página Exportar. O G-Rebels permite uma função por eixo e um botão por ação e canal; a Verificação mostra onde duas relações querem a mesma entrada.
#Exportar para o G-Rebels
- Feche o G-Rebels. O JoyPro recusa escrever enquanto o jogo está a correr.
- Abra Exportar e marque o cartão do G-Rebels.
- Mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos se é no JoyPro que configura os seus manches. Prima Exportar agora no cartão.


Abra OPTIONS > INPUT > CONTROLS e o separador JST<channel> do seu dispositivo (JST0 para o canal 0). Em AXIS, cada eixo do joystick (X, Y, Z, RX, RY, RZ, Slider, Dial) mostra a função que o JoyPro definiu (YAW, THRUST, ROLL, PITCH, SIDE STRAFE, UP / DOWN ou NONE). Em BUTTONS, a ação atribuída mostra o seu botão, por exemplo "Enhanced Raw Input Controller 0 Button 5".
#O que faz você mesmo no G-Rebels
Faça isto uma vez por dispositivo, antes da primeira exportação:
- Ligue o dispositivo: OPTIONS > INPUT > DEVICES lista cada joystick com DEACTIVATED. Dê um canal a cada dispositivo que quer (0 - CHANNEL ... 5 - CHANNEL). Um dispositivo sem canal é ignorado pela exportação com "ligue-o em OPTIONS > INPUT > DEVICES".
- Mude uma função de eixo no separador JST do dispositivo. Só então o jogo guarda as linhas de eixo desse canal; o JoyPro altera-as no sítio e nunca as adiciona. Só abrir o separador não guarda nada.
- Atribua um botão no jogo uma vez. O ficheiro de botões aparece com a primeira atribuição.
#Erros comuns
- Uma função de eixo não é escrita: o canal ainda não tem linhas de eixo guardadas. Mude uma função de eixo no seu separador JST no jogo, feche o jogo e exporte outra vez.
- Falta uma atribuição de botão: dos botões do jogo, só Primary Fire está confirmado até agora; as outras ações seguem-se quando os seus nomes forem conhecidos.
- Vários dispositivos raw input partilham teclas: ponha todo o HOTAS num dispositivo com o Joystick virtual; assim só precisa de um canal.
#Ficheiros que o JoyPro lê e escreve
| Ficheiro | O que é |
|---|---|
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav |
os dispositivos com os seus canais (por caminho HID) e uma linha de eixo por cada eixo de cada canal: função, inversão, zona morta, multiplicador |
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\EnhancedInputUserSettings.sav |
as atribuições de botões, um mapeamento por ação e canal |
...\SaveOptions.sav.joypro-meta.json |
Os dados do JoyPro sobre as atribuições exportadas (nomes, grupos), lidos de novo pela próxima importação |
É feito backup dos dois ficheiros de gravação antes da primeira escrita (.jpbak ao lado deles e o arquivo de backups do JoyPro).
#Os modos de exportação no G-Rebels
Uma função por eixo e uma tecla por ação e canal. As mesmas regras valem para as funções de eixo e para os botões.
| Modo | O que acontece |
|---|---|
| Só adicionar | Uma função só vai para um eixo que não tenha nenhuma; um eixo com outra função é ignorado e marcado "Não escrito no jogo". |
| Atualizar, manter atribuições do jogo | A função do perfil vai para o seu eixo (a função que lá estava sai); a função fica nos seus outros eixos. Num botão: o mapeamento de outra ação na tecla sai. |
| Atualizar, o meu perfil ganha | Como acima, e os outros eixos da função nos canais ligados recebem NONE. |
| Substituir nos meus dispositivos | Todas as outras funções de um canal escrito passam a NONE. |
| + Limpar também os meus outros dispositivos | O mesmo nos canais ativos e ligados que o JoyPro não escreve. |
#O que nunca é tocado
- Teclado, comando, rato e as outras opções do jogo.
- Um canal cujo dispositivo não está ligado mantém as suas funções.
- Os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
- A lista de dispositivos do jogo: o JoyPro nunca liga nem desliga um dispositivo e nunca acrescenta um canal.
#Eixos e outras configurações
- Global: um conjunto de atribuições por canal, sem perfis por aeronave.
- Inverter é escrito com a função. Os hats (as linhas POV), a zona morta e a sensibilidade ainda não são escritos.
- Sem configurações gerais do jogo, sem force feedback.
- Monitor de jogos: uma função ou atribuição que mude no jogo é detetada depois de o jogo fechar (o monitor de jogos).
- HUD: enquanto o G-Rebels corre, o HUD mostra a ação de cada botão premido.
- O jogo lê até 96 botões e 24 eixos por dispositivo, sem hats.
#Por dentro da integração do G-Rebels
flowchart LR D["G-Rebels: DEVICES<br/>dispositivo no canal 0-5"] --> S P["O seu perfil<br/>(relações + atribuições)"] --> E["engine grebels export"] E --> S["SaveOptions.sav<br/>funções de eixo + inversão<br/>por canal"] E --> B["EnhancedInputUserSettings.sav<br/>atribuições de botões por canal"] S --> G["G-Rebels: CONTROLS ><br/>separador JST do canal"] B --> G
Código: engine\Games\GRebelsIntegration.cs, engine\Games\GRebelsSaveOptions.cs, engine\Games\GvasKeyMappings.cs.
- SaveOptions.sav: Unreal GVAS (UE 5.8, etiquetas de propriedade com árvores de tipos).
JoystickscontémS_Controller_Save { DeviceID (HID path), Enabled, MultiID (channel) };AxisOptionscontémS_Input_Axis_Save { Key, Offset, Multiplier, Role, Inverted, DeadZone }com chaves comoRawInput_Controller0_AxisYe a função como enum (0 Yaw, 1 Thrust, 2 Roll, 3 Pitch, 4 Side strafe, 5 Up/down, 6 None). Sem checksum: o JoyPro edita valores de tamanho fixo no próprio sítio. - EnhancedInputUserSettings.sav: teclas mapeadas pelo jogador do Unreal Enhanced Input. Os nomes dos mapeamentos são
<ACTION>JST<channel>(PRIMARYFIREJST0), as teclasRawInput_Controller<channel>_Button<n>, com n o número do botão DirectInput. A lista de mapeamentos é reescrita; todos os outros bytes ficam. - Dispositivos: a correspondência é feita pelo caminho HID com o canal que o jogo lhes deu.
- Lista de comandos: a tabela própria do JoyPro (
DB\GRebels\actions.tsv, funções de eixo e botões; os ficheiros do jogo não são lidos).engine grebels refresh-dbescreve-a na pasta de dados do jogo; as linhas que já lá estão mantêm a sua entrada. - Comandos:
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.
#Limites conhecidos
- Os hats, a zona morta e a sensibilidade não são escritos.
- Dos botões, só Primary Fire está confirmado no jogo.
- Nunca são acrescentadas entradas: os canais, as linhas de eixo e o ficheiro de botões têm de existir a partir do jogo.
- Testes:
engine\tests\smoke\grebels.ps1; no jogotools\e2e\games\GRebelsSettings.ps1(dois arranques: o primeiro dá um canal ao vJoy e grava as linhas de eixo, o segundo verifica funções aleatórias e Primary Fire em JST0; a pasta de gravações é reposta no fim).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): g-rebels.md.