JoyPro2 Discord GitHub
Jogos

Project Wingman

Mostrar:

O Project Wingman é um jogo arcade de combate aéreo em Unreal Engine 4. Lê vários dispositivos DirectInput ao mesmo tempo e guarda as atribuições num Input.ini simples, cada uma com o nome do dispositivo e a sua posição na lista de dispositivos do jogo; as curvas e zonas mortas ficam no jogo guardado. O JoyPro lê ambos para o seu perfil e volta a escrevê-los. Teclado, rato, comando e hats ficam como o jogo os tem.

Project Wingman nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine pw
Ficheiro de atribuições
%LOCALAPPDATA%\ProjectWingman\Saved\Config\WindowsNoEditor\Input.ini (ini Unreal, por nome e posição do dispositivo) + curvas e zonas mortas em savegame.sav
Lista de comandos a partir de
DefaultInput.ini do pak do jogo + o seu Input.ini
Teste no jogo
19/25 passos concluídos (2026-10-12)
  • ✓ 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 jogoProject Wingman: exportação e importação vistas no jogo; falta uma execução completa do teste (19/25 e 17/24 até agora).

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 Project Wingman fechado

Antes: inicie o jogo uma vez e depois feche-o. Desligue o Steam Input para o jogo.

Depois: as suas atribuições estão em Controls no jogo. Adicionou ou removeu um comando? Exporte outra vez.

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

  • Importar: todas as atribuições de joystick das ações de voo (picada, rolamento, guinada, impulso, os dois eixos de vista e os botões) entram no seu perfil nos seus dispositivos reais, com inversão, curva e zona morta.
  • Relações: "Fire missile" no Project Wingman pode ser a mesma relação que o lançamento de armas dos seus outros jogos.
  • Exportar: o JoyPro escreve as suas atribuições no Input.ini e as curvas e zonas mortas no jogo guardado.

#Importar as suas atribuições do Project Wingman

  1. Inicie o jogo uma vez se nunca o fez, para que a pasta dele exista.
  2. Abra Iniciar. Se o cartão do Project Wingman pedir uma lista de comandos, prima Criar lista: o JoyPro lê as ações de voo dos próprios ficheiros do jogo.
  3. Prima Importar no cartão, mantenha Adicionar ao meu perfil (recomendado) e prima Importar agora.
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

Junte as ações do Project Wingman às dos seus outros jogos na página Relações (fluxo de relações) e depois execute Verificar na página Exportar: encontra um botão que faz duas coisas no jogo.

#Exportar para o Project Wingman

  1. Feche o Project Wingman. O JoyPro recusa-se a escrever enquanto ele está a correr.
  2. Abra Exportar e marque o cartão do Project Wingman.
  3. Mantenha Substituir nos meus dispositivos com Limpar também os meus outros dispositivos, ou escolha Atualizar, manter atribuições do jogo se também atribuir no jogo. Prima Exportar agora no cartão.
A página ExportarA página Exportar
A página Exportar
No jogo: O que vê no Project Wingman

Abra Controls no jogo. KEY BINDINGS e AXIS BINDINGS mostram as suas atribuições na próxima posição livre de cada linha, com o nome do dispositivo sem espaços e o seu número, por exemplo "VJOYDEVICE 8 BUTTON 24" ou "VJOYDEVICE 8 AXIS 1", com a caixa Inverter marcada onde inverteu. CURVES + DEADZONES mostra a CURVE e a DEADZONE que o JoyPro escreveu para cada eixo.

#O que faz sozinho no Project Wingman

  • Exporte outra vez depois de adicionar ou remover um comando. O jogo numera um dispositivo pela sua posição na lista de dispositivos, e essa posição muda quando um comando entra ou sai. O JoyPro calcula-a a partir dos dispositivos ligados no momento da exportação.
  • Hats: o jogo não consegue atribuir um hat. Defina Hat Function 1 / 2 (WEAPON ou VIEW) em Controls > Miscellaneous.
  • Desligue o Steam Input para o jogo; um comando do Steam Input aparece como um dispositivo extra.

#Erros comuns

  • As atribuições apontam para o dispositivo errado: um comando foi adicionado ou removido desde a exportação. Exporte outra vez com os seus dispositivos habituais ligados. A importação avisa quando o número de um dispositivo mudou.
  • Uma atribuição de hat é recusada: é intencional, veja Hat Function acima.
  • O acelerador trava na metade inferior: "Thrust Axis" é um eixo centrado no Project Wingman: acima do centro acelera, abaixo trava.
Avançado

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
%LOCALAPPDATA%\ProjectWingman\Saved\Config\WindowsNoEditor\Input.ini as atribuições, secção [/Script/Engine.InputSettings]: linhas ActionMappings=(...) e AxisMappings=(...)
%LOCALAPPDATA%\ProjectWingman\Saved\SaveGames\savegame.sav curvas e zonas mortas por ação de eixo (<Axis>Curve, <Axis>Deadzone) e as funções do hat
<install>\ProjectWingman\Content\Paks\pakchunk0-WindowsNoEditor.pak só leitura: DefaultInput.ini, as atribuições predefinidas do jogo e a lista de ações
...\Input.ini.joypro-meta.json os dados do JoyPro sobre as atribuições exportadas (nomes, grupos, afinação) para a próxima importação

O jogo escreve o Input.ini no momento em que uma atribuição muda no seu menu, e só as listas que alterou; as outras vêm das predefinições do pak. Como uma lista escrita substitui as predefinições, o JoyPro escreve primeiro as predefinições de uma lista em falta. O Steam Cloud sincroniza a pasta de gravações.

#Os modos de exportação no Project Wingman

Só são removidos os mapeamentos de joystick de ações de voo catalogadas; teclado, comando, rato, linhas de menu e dispositivos que não estão ligados ficam.

Modo O que acontece
Só adicionar Uma atribuição numa entrada que o jogo usa para outra ação de voo não é escrita (marcada "Não escrito no jogo"); a forma própria do jogo de uma atribuição (Invert) fica.
Atualizar, manter atribuições do jogo Remove também o mapeamento do jogo numa entrada que o perfil dá a outra ação; os outros mapeamentos da ação ficam.
Atualizar, o meu perfil ganha Remove também os outros mapeamentos de joystick de cada ação que o perfil atribui, para que uma mudança seja completa.
Substituir nos meus dispositivos Os dispositivos exportados perdem os seus outros mapeamentos de joystick (um jogo só de voo).
+ Limpar também os meus outros dispositivos O mesmo nos outros dispositivos ligados.

#O que nunca é tocado

  • Mapeamentos de teclado, rato e comando, linhas de menu, hats.
  • Os dispositivos que não estão ligados, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
  • Todas as outras linhas do Input.ini (a ordem e os fins de linha ficam) e todos os outros bytes do savegame.sav.

#Curvas, zonas mortas, outras configurações

  • Por ação de eixo, para todos os dispositivos em conjunto: CURVE (0.00 a 2.00 no menu, 1.00 = reta) e DEADZONE (0 a 100 %) para pitch, roll, thrust, yaw e os dois eixos de vista. As predefinições do jogo: pitch e roll 25 %, vista 10 %, thrust e yaw 0 %.
  • Inverter por atribuição (a caixa Invert do espaço).
  • A fórmula do jogo não é conhecida. A pré-visualização do JoyPro assume uma zona morta reescalada e a curva como expoente (ainda não confirmado).
  • Global: sem perfis por aeronave. Sem modificadores (o jogo não tem nenhum), sem force feedback.
  • Monitor de jogos: o Input.ini e o savegame.sav são vigiados depois de o jogo fechar (o monitor de jogos).
  • HUD: enquanto o jogo corre, o HUD mostra a ação de cada botão premido.
Detalhes técnicos internos

#Por dentro da integração do Project Wingman

flowchart LR
  P["O seu perfil<br/>(relações + atribuições)"] --> E["engine pw export"]
  D["Dispositivos ligados<br/>(a sua posição na lista)"] --> E
  E --> I["Input.ini<br/>ActionMappings /<br/>AxisMappings"]
  E --> S["savegame.sav<br/>curva + zona morta<br/>por eixo"]
  I --> G["Project Wingman: Controls<br/>KEY / AXIS BINDINGS"]
  S --> C["CURVES + DEADZONES"]
O jogo numera um dispositivo pela sua posição na lista. Exporte de novo depois de acrescentar ou remover um controlador.

Código: engine\Games\ProjectWingmanIntegration.cs, engine\Games\ProjectWingmanSaveGame.cs, engine\AxisModels\ProjectWingman.cs (modelo de eixo projectwingman).

  • Chaves: Joystick_<name>_<place>_Axis<n>, ..._Button<n>. <name> é o nome de produto DirectInput sem espaços (VPforce Rhino FFB Joystick passa a VPforceRhinoFFBJoystick), não o texto HID. <place> é a posição do dispositivo na lista do jogo (Controls > Miscellaneous), que é a ordem do DirectInput invertida; os comandos XInput não estão nessa lista. Axis<n> conta os eixos presentes do dispositivo a partir de 0, pela ordem X Y Z Rx Ry Rz Slider Slider; Button<n> conta a partir de 0. Uma chave com uma vírgula no nome fica entre aspas.
  • Inverter = Scale=-1.000000.
  • Predefinições: as chaves Android_* das predefinições do pak são mantidas, porque o menu mostra um espaço por mapeamento e essas chaves são os espaços vazios.
  • savegame.sav: GVAS do Unreal; FloatProperty <Axis>Curve (metade do valor do menu) e <Axis>Deadzone (0..1), editadas no próprio ficheiro ou acrescentadas antes do None final. Sem soma de verificação.
  • Lista de comandos: engine pw refresh-db lê o DefaultInput.ini do pak e o seu Input.ini: 6 eixos e 14 botões.
  • Comandos: engine pw paths, engine pw catalog, engine pw scan, engine pw import, engine pw export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --dry-run.

#Limites conhecidos

  • O número do dispositivo muda com os seus controladores: exporte de novo depois de uma mudança de hardware.
  • Hats e modificadores são recusados.
  • A fórmula da curva é uma hipótese de trabalho.
  • Ainda falta uma execução completa do teste dentro do jogo; a exportação e a importação foram vistas no jogo.
  • Testes: engine\tests\smoke\projectwingman.ps1 (fixtures com a forma real); no jogo tools\e2e\games\ProjectWingmanSettings.ps1 (eixos aleatórios, botões, inversão, curva e zona morta; as páginas de controlos lidas de volta; as pastas de configuração e de gravações repostas).

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