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.
#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
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
- 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.
- Prima Importar no cartão do WARDOGS. Mantenha Adicionar ao meu perfil (recomendado).
- Prima Importar agora. Ver as minhas relações abre o que entrou.


#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
- 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.
- Abra Exportar e marque o cartão do WARDOGS.
- 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.


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.
#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.
#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
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 comDeviceIdentifier=""; 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-dbcria-a a partir do seu ficheiro de configurações mais os eixos do JoyPro;engine wardogs cataloglista-a,engine wardogs pathsmostra 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(ouselfCenteringCollective).
#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 jogotools\e2e\games\Wardogs.ps1(atribuições),WardogsSettings.ps1(valores da página HOTAS) eWatchdog.ps1(o monitor de jogos).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): wardogs.md.