JoyPro2 Discord GitHub
Jogos

WARDOGS

Mostrar:

O WARDOGS é um jogo de combate de helicópteros em Unreal Engine 5. O seu próprio plugin de joystick lê todos os dispositivos DirectInput e guarda as atribuições num só ficheiro de configurações: os seis eixos de voo e as ações de voo, cada um com o dispositivo a que pertence. O JoyPro lê essa secção para o seu perfil e volta a escrevê-la, juntamente com a sensibilidade, a zona morta da página HOTAS e o interruptor Enable HOTAS. O teclado, o rato e todas as outras partes do ficheiro ficam como estão.

WARDOGS nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine wardogs
Ficheiro de atribuições
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini (ini Unreal, nomes de campos com hash)
Lista de comandos a partir de
o seu GameUserSettings.ini + os eixos do JoyPro
Teste no jogo
36/36 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 mortas
  • ✓ 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
    mantenha o WARDOGS fechado

Antes: abra Settings > GAMEPAD > HOTAS no jogo uma vez. Depois feche-o.

Depois: Enable HOTAS está ligado, e as suas atribuições estão na página HOTAS.

Já atribuiu botões no WARDOGS 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 WARDOGS

  • Importar: as atribuições da página HOTAS entram no seu perfil: Pitch, Roll, Yaw, o coletivo (Throttle), os dois eixos de olhar e as ações de voo (Fire, Flares, Reload, Horn, Ping ...), cada uma no seu dispositivo, com inversão, sensibilidade e zona morta.
  • Relações: uma relação pode servir o WARDOGS e os seus outros jogos ao mesmo tempo: "Collective" na alavanca do acelerador no WARDOGS e nos helicópteros do DCS, por exemplo.
  • Exportar: o JoyPro escreve as atribuições de helicóptero no ficheiro de configurações do jogo e liga Enable HOTAS, para que o jogo as use.

#Importar as suas atribuições do WARDOGS

  1. Abra Iniciar. Se o cartão do WARDOGS pedir uma lista de comandos, prima Criar lista: o JoyPro cria-a a partir do seu próprio ficheiro de configurações e da sua própria tabela de eixos.
  2. Prima Importar no cartão do WARDOGS. Mantenha Adicionar ao meu perfil (recomendado).
  3. Prima Importar agora. 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

Na página Relações, junte as ações do WARDOGS à mesma função dos seus outros jogos, veja o fluxo de relações. Depois execute Verificar na página Exportar: encontra um botão que faz duas coisas no WARDOGS antes de o jogo o fazer.

#Exportar para o WARDOGS

  1. Feche o WARDOGS. O jogo reescreve todo o ficheiro de configurações ao sair, por isso o JoyPro recusa-se a escrever enquanto ele está a correr.
  2. Abra Exportar e marque o cartão do WARDOGS.
  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 WARDOGS

Inicie o WARDOGS e abra Settings > GAMEPAD > HOTAS. Enable HOTAS está ligado, cada linha de eixo mostra o seu dispositivo e eixo com a caixa de inversão, os controlos deslizantes Sensitivity e Deadzone, e as ações mostram os seus botões. O menu conta os botões de ação a partir de 0, mas os botões de meio eixo a partir de 1, por isso o mesmo botão pode mostrar dois números diferentes.

#O que faz sozinho no WARDOGS

  • Abra a página HOTAS uma vez antes da primeira exportação. O JoyPro só escreve na secção de joystick do jogo; se o ficheiro ainda não a tiver, a exportação para e pede-lhe que abra essa página no jogo.
  • Enable HOTAS desliga o voo com rato e teclado enquanto está ligado. O JoyPro liga-o sempre que escreve atribuições. Para o manter sob o seu controlo, defina-o em Configurações > Configurações de force feedback dos jogos (jogo WARDOGS): o que guardar aí é escrito em cada exportação.
  • "Garage / Vendor" e "Free Look Reset" ainda não estão na lista do JoyPro. Atribua-os uma vez no jogo e depois prima Atualizar no cartão do WARDOGS: o JoyPro adiciona as ações que encontrar no seu ficheiro.

#Erros comuns

  • "WARDOGS está em execução": feche o jogo e exporte outra vez.
  • Um dispositivo aparece como NOT CONNECTED no jogo: o jogo identifica um dispositivo pelo VID:PID e pelo seu nome DirectInput. Exporte outra vez com o dispositivo ligado: o JoyPro corrige um nome que difira do dispositivo ligado com o mesmo VID:PID.
  • Dois dispositivos idênticos: o WARDOGS não os consegue distinguir (recebem o mesmo nome). Use o Joystick virtual ou mantenha só um deles nas atribuições do WARDOGS.
  • As atribuições não fazem nada em voo: verifique Enable HOTAS na página HOTAS; desligado, o jogo ignora todas as atribuições de joystick.
Avançado

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
%LOCALAPPDATA%\Wardogs\Saved\Config\WindowsClient\GameUserSettings.ini as atribuições na secção [/Script/WDJoystick.WDJoystickSettings]; os interruptores globais do jogo Enable HOTAS (bUseHOTASHelicopters) e Self-Centering Collective (bCollectiveSelfCentering) em [/Script/WDGame.WDUserSettings]
...\GameUserSettings.ini.joypro-meta.json os dados do JoyPro sobre as atribuições exportadas (nomes das relações, grupos, afinação), lidos de volta na próxima importação
...\GameUserSettings.ini.jpbak o backup antes da primeira escrita (também guardado no arquivo de backups do JoyPro)

As atribuições de teclado do mesmo ficheiro e de Saved\SaveGames\EnhancedInputUserSettings.sav não são lidas nem escritas. O JoyPro não lê nada da instalação: o seu ficheiro de configurações é a fonte da lista de comandos.

#Os modos de exportação no WARDOGS

O jogo usa uma atribuição por ação. Todos os modos atuam só nas ações de helicóptero catalogadas pelo JoyPro; as outras linhas e secções do ficheiro nunca mudam.

Modo O que acontece
Só adicionar Uma atribuição só entra onde o espaço da ação está livre e nenhuma outra ação catalogada usa esse botão ou eixo; caso contrário é ignorada e marcada "Não escrito no jogo". Um espaço atribuído nunca é substituído.
Atualizar, manter atribuições do jogo A sua atribuição ocupa o espaço da ação (substitui a entrada que lá estava). Outra ação catalogada na mesma entrada perde-a. Uma segunda linha da ação fica.
Atualizar, o meu perfil ganha Como acima, e as linhas extra da ação desaparecem, para que uma ação movida seja movida por completo.
Substituir nos meus dispositivos Os dispositivos que escreve ficam só com as suas atribuições das ações catalogadas.
+ Limpar também os meus outros dispositivos Os dispositivos ligados sem atribuições no seu perfil perdem as suas atribuições catalogadas.

Uma exportação de um perfil sem atribuições do WARDOGS escreve só as configurações globais do jogo que guardou.

#O que nunca é tocado

  • Atribuições de teclado e rato, o ficheiro de gravação do teclado e todas as secções fora da secção de joystick (exceto os dois interruptores globais do jogo).
  • Ações que o JoyPro não cataloga: as suas linhas ficam como estão.
  • Os dispositivos que não estão ligados, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
  • Campos desconhecidos de uma linha de atribuição: são mantidos como estão.

#Eixos, sensibilidade, zona morta

  • Global: o WARDOGS não tem perfis de aeronave ou de veículo; as atribuições valem para todos os helicópteros.
  • Por eixo: inversão, Sensitivity (0.1 a 2.0, 1 = sem alteração) e Zona morta (0 a 0.5), nas unidades próprias da página HOTAS, arredondadas às suas duas casas decimais. Uma importação guarda-as como a afinação WARDOGS da relação, para que os seus outros jogos mantenham as suas próprias curvas.
  • Sem valores do WARDOGS, o JoyPro ajusta-os a partir da sua curva base: a zona morta passa tal como está, a sensibilidade segue o declive até à saturação. A zona morta de um slider não é passada, porque o WARDOGS trata o coletivo como um eixo centrado. Curvatura e curvas do utilizador não podem ser expressas; a exportação avisa.
  • O jogo não mostra pré-visualização e a sua fórmula não é conhecida. A pré-visualização do JoyPro assume inversão, uma zona morta reescalada, depois vezes a sensibilidade, cortada na deflexão total (ainda não confirmado).
  • Configurações do jogo: Enable HOTAS e Self-Centering Collective (para configurações com dois manches: o coletivo volta ao pairar quando o larga; deixe desligado para alavancas de acelerador), em Configurações > Configurações de force feedback dos jogos. Só são escritas quando o ficheiro já tem a chave. O WARDOGS não tem force feedback.
  • Monitor de jogos: uma atribuição que altera na página HOTAS é detetada depois de o jogo fechar; o JoyPro pergunta se a deve adotar (o monitor de jogos).
  • HUD: enquanto o WARDOGS está a correr, o HUD nomeia a ação de cada botão premido.
Detalhes técnicos internos

#Por dentro da integração do WARDOGS

flowchart LR
  P["O seu perfil"] --> E["engine wardogs export"]
  E --> S["GameUserSettings.ini"]
  E --> H["Enable HOTAS ligado"]
  E --> M[".joypro-meta.json"]
  S --> G["Settings > GAMEPAD<br/>> HOTAS"]
  H --> G
O JoyPro escreve a secção de joystick de GameUserSettings.ini (6 eixos e as ações de voo), liga Enable HOTAS quando são escritas atribuições, e guarda nomes e grupos em .joypro-meta.json.

Código: engine\Games\WardogsIntegration.cs, engine\AxisModels\Wardogs.cs (modelo de eixo wardogs), engine\FfbModels\Wardogs.cs (os dois interruptores globais do jogo).

  • Ficheiro: ASCII, CRLF, sem BOM, primeira linha ;METADATA=(Diff=true, UseCommands=true). As linhas de eixo são sempre as seis, pela ordem Pitch, Throttle, Roll, Yaw, LookPitch, LookYaw; ActionBindings=(Action=<action>,Binding=(...)) uma vez por ação atribuída, as linhas novas depois da última. Um eixo fica sem atribuição com DeviceIdentifier=""; uma ação, apagando a sua linha. Números decimais com seis casas. Os nomes ficam em ASCII (um nome não ASCII faria o motor gravar em UTF-16).
  • Nomes dos campos: a maioria dos campos são tokens com hash (_aaaa...). O JoyPro nunca os fixa no código: encontra cada campo pela sua posição junto às âncoras legíveis (DeviceIdentifier, bInvert, Positive, Sensitivity, DeadZone) e para quando a forma muda.
  • Dispositivos: DeviceIdentifier="VID:PID:<DirectInput instance name>", VID e PID a partir do GUID de produto DirectInput, o nome exatamente como o DirectInput o comunica, incluindo os espaços nas pontas (nunca cortados). Os números de eixo são os espaços do DIJOYSTATE2 (0 X, 1 Y, 2 Z, 3 Rx, 4 Ry, 5 Rz, 6/7 sliders); os botões contam a partir de 0.
  • Lista de comandos: engine wardogs refresh-db cria-a a partir do seu ficheiro de configurações mais os eixos do JoyPro; engine wardogs catalog lista-a, engine wardogs paths mostra onde o JoyPro procura.
  • Importar / exportar: engine wardogs scan, engine wardogs import, engine wardogs export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --ignore-device <d> --dry-run.
  • Configurações do jogo: engine ffb set --device * --game Wardogs --param enableHotas=true (ou selfCenteringCollective).

#Limites conhecidos

  • A lista completa de ações não é conhecida; o JoyPro lista as ações vistas em ficheiros reais.
  • Direções do hat como ações: a codificação ainda não está confirmada.
  • A fórmula de resposta de Sensitivity e Deadzone não é conhecida.
  • Dispositivos idênticos recebem o mesmo identificador e entram em conflito.
  • Testes: engine\tests\smoke\wardogs.ps1; no jogo tools\e2e\games\Wardogs.ps1 (atribuições), WardogsSettings.ps1 (valores da página HOTAS) e Watchdog.ps1 (o monitor de jogos).

Todas as notas técnicas sobre este jogo (geradas a partir do repositório): wardogs.md.