JoyPro2 Discord GitHub
Jogos

G-Rebels

Mostrar:

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.

Para iniciantes

#Pôr a funcionar em 3 passos

  1. Configurar tudo por mim
    na página Início
  2. Usar estes botões
    veja primeiro a lista
  3. 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

  1. 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.
  2. Prima Importar no cartão do G-Rebels, mantenha Adicionar ao meu perfil (recomendado) e prima Importar agora.
  3. Ver as minhas relações abre o que entrou.
A página Início com os seus jogosA página Início com os seus jogos
A página Início com os seus jogos (As imagens mostram a aplicação em inglês.)

#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

  1. Feche o G-Rebels. O JoyPro recusa escrever enquanto o jogo está a correr.
  2. Abra Exportar e marque o cartão do G-Rebels.
  3. 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.
A página ExportarA página Exportar
A página Exportar
No jogo: O que vê no G-Rebels

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:

  1. 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".
  2. 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.
  3. 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.
Avançado

#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.
Detalhes técnicos internos

#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
Dê a cada dispositivo um canal, uma vez, no jogo. O JoyPro escreve as funções de eixo e os botões desse canal.

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). Joysticks contém S_Controller_Save { DeviceID (HID path), Enabled, MultiID (channel) }; AxisOptions contém S_Input_Axis_Save { Key, Offset, Multiplier, Role, Inverted, DeadZone } com chaves como RawInput_Controller0_AxisY e 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 teclas RawInput_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-db escreve-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 jogo tools\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.