JoyPro2 Discord GitHub
Jogos

Hell Let Loose: Vietnam

Mostrar:

O Hell Let Loose: Vietnam é um shooter de infantaria em Unreal Engine 5 com helicópteros pilotáveis, mas não lê joystick nenhum: só teclado, rato e comandos Xbox. Os seus layouts de comando são fixos (escolhe A, B ou C no jogo). Por isso o JoyPro voa-o através de um comando simulado (um comando Xbox virtual): o seu manche, acelerador e pedais controlam os controlos do comando que o seu layout usa para cada ação do helicóptero. O JoyPro não escreve nada para o comando. Só escreve as teclas de piloto do teclado, quando as pede.

Hell Let Loose: Vietnam comando Xbox virtual
Suporte
comando Xbox virtual
Comando do motor
engine hllv
Ficheiro de atribuições
%LOCALAPPDATA%\HLLVietnam\Saved\SaveGames\EnhancedInputUserSettings.sav (GVAS; só teclas do teclado)
Entradas que o jogo lê
não lê nenhum joystick, só comandos Xbox
Lista de comandos a partir de
a tabela do próprio JoyPro com os três esquemas do comando e as teclas de piloto; os ficheiros do próprio jogo só com uma biblioteca Oodle (a de outro jogo, depois do seu sim)
Teste no jogo
19/19 passos concluídos (2026-10-11)
  • ◐ ImportarO Hell Let Loose: Vietnam não lê nenhum joystick: o JoyPro lê e escreve as suas teclas do teclado; o esquema do comando é o do jogo.
  • ◐ ExportarO Hell Let Loose: Vietnam não lê nenhum joystick: o JoyPro lê e escreve as suas teclas do teclado; o esquema do comando é o do jogo.
  • ✓ 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
Hell Let Loose apenas documentado
Suporte
apenas documentado
Comando do motor
nenhum
  • — 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
Squad apenas documentado
Suporte
apenas documentado
Comando do motor
nenhum
  • — 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. Atribuir o helicóptero
    na página Relações
  2. Instalar ViGEmBus
    depois Testar
  3. Iniciar o jogo
    no ecrã de título: Alt+Tab, Iniciar

#Configurar uma vez

  1. Abra Iniciar. Se o cartão do Hell Let Loose: Vietnam pedir uma lista de comandos, prima Criar lista. O JoyPro escreve a sua própria tabela dos três layouts de comando e das teclas de piloto.
  2. Abra Relações. Ponha o seu manche, acelerador e pedais nas ações de comando do helicóptero: coletivo, cíclico, guinada. Para o coletivo, ponha um eixo do acelerador tanto em Collective up como em Collective down. O JoyPro divide-o ao centro pelos dois gatilhos.
  3. Abra a página Joystick virtual. O comando simulado precisa de um ajudante gratuito chamado ViGEmBus. Marque a caixa por baixo da licença. Depois prima Instalar ViGEmBus. O Windows pede autorização: clique em Sim. Só faz isto uma vez.
  4. Prima Testar. Mova o seu manche. A imagem do comando mexe-se com ele.
A página Joystick virtual com o comando simuladoA página Joystick virtual com o comando simulado
A página Joystick virtual com o comando simulado (As imagens mostram a aplicação em inglês.)

Não precisa de mudar nada. O jogo usa o comando simulado sozinho. A página diz "No comando Xbox sozinho: o jogo só lê comandos Xbox". Para este jogo não precisa de HidHide: de qualquer forma, ele nunca vê os seus manches reais.

A configuração rápida só conhece as teclas de piloto

Configurar tudo por mim só conhece, por agora, as teclas de piloto do teclado do jogo, não as suas ações de comando. Por isso atribua você mesmo as ações de comando, como no passo 2. A resposta de boas-vindas Jogar ACE COMBAT com o meu manche mostra os mesmos passos do comando simulado como visita guiada.

#Sempre que jogar

  1. Inicie o Hell Let Loose: Vietnam. Espere até aparecer o ecrã de título.
  2. Mantenha Alt premido e prima Tab. Está de volta ao JoyPro.
  3. Prima Iniciar.
  4. Prima Alt+Tab outra vez. Está de volta ao jogo. Voe!
  5. Quando terminar, prima Parar.
Iniciar vem depois do jogo

Prima Iniciar só quando o jogo mostrar o ecrã de título. Cedo demais? O JoyPro diz "Cedo demais". Prima Parar e depois Iniciar. Faça isto sempre que jogar.

#O que o JoyPro faz pelo Hell Let Loose: Vietnam

  • Helicóptero no comando simulado: o JoyPro conhece as ações de helicóptero dos três layouts de comando (coletivo, cíclico, guinada, manter estabilidade, nivelamento automático, largada de abastecimentos, flare de reconhecimento, olhar, lugar, médico). Atribua-lhes o seu HOTAS, e o comando simulado move o stick, o gatilho ou o botão que o jogo espera.
  • Teclas de piloto do teclado: a pedido, o JoyPro lê e escreve as teclas do teclado do jogo para as ações de piloto.
  • O Hell Let Loose (o original) não tem nada para voar, e o Squad lê um dispositivo fundido: ambos estão apenas documentados (veja Avançado).

#Importar as suas teclas de piloto

Não há atribuições de joystick no jogo para importar. Só entram as teclas de piloto do teclado:

  1. Prima Importar no cartão do Hell Let Loose: Vietnam.
  2. Marque Aceitar também as teclas do teclado.
  3. 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

#Criar e verificar relações

O fluxo das relações funciona como em todos os jogos. Uma relação pode conter a ação de helicóptero deste jogo e a mesma função dos seus simuladores de voo. Assim "Collective" é uma alavanca do acelerador em todo o lado.

#Exportar

O comando simulado não precisa de exportação: Iniciar na página Joystick virtual cria a sua tabela a partir das suas relações. Uma exportação só escreve as teclas de piloto do teclado, e só quando marcou o teclado na importação (a escolha fica guardada por jogo): feche o jogo, abra Exportar e prima Exportar agora no seu cartão.

No jogo: O que vê no Hell Let Loose: Vietnam

O jogo vê um comando Xbox: os seus menus mostram botões do comando (por exemplo "B EXIT" no menu principal). O seu manche, acelerador e pedais voam o helicóptero como o faria o comando do layout que escolheu. As teclas de piloto do teclado que o JoyPro escreveu aparecem nas configurações de teclas do jogo.

#O que faz você mesmo no Hell Let Loose: Vietnam

  • Prima Iniciar no ecrã de título, sempre que jogar (veja acima).
  • Escolha o layout de comando (A, B ou C) em Options > Controls. Depois de uma mudança, prima Atualizar mapeamento na página Joystick virtual (ou Parar e Iniciar). O JoyPro passa então a seguir o novo layout.
  • Os botões do comando do jogo não podem ser reatribuídos, por isso é o layout que decide que controlo do comando tem cada ação. O JoyPro segue-o. Não há nada para definir no jogo para o comando.

#Erros comuns

  • O jogo não reage: premiu Iniciar cedo demais? Prima Parar e depois Iniciar no ecrã de título.
  • Sem ViGEmBus: sem ele, o jogo não consegue ver o seu manche. Instale-o na página Joystick virtual.
  • A guinada e o olhar mexem-se juntos nos layouts A e B: o jogo põe a guinada e o olhar para a esquerda / direita no mesmo eixo do stick e decide pelo contexto. O JoyPro fixa ali um eixo físico e avisa sobre o segundo.
  • O coletivo vai para o lado errado: marque Inverter na relação do coletivo. Isso troca os dois gatilhos.
  • Uma tecla de piloto não foi escrita: as teclas do teclado só são escritas com a escolha do teclado na importação.

Mais: Jogar um jogo só para Xbox com um HOTAS.

Avançado

#Como funciona o comando simulado

flowchart LR
  R["Manche, acelerador,<br/>pedais"] --> J["JoyPro<br/>(o comando simulado)"]
  L["O seu layout de comando<br/>A, B ou C"] --> J
  J --> G["Hell Let Loose: Vietnam<br/>vê um comando Xbox"]
Inicie o jogo e depois prima Iniciar no ecrã de título. O JoyPro segue o layout de comando que escolheu no jogo e não escreve nada para o comando.
  • Sem HidHide. O jogo só lê comandos Xbox, por isso nunca vê os seus manches reais. Nada tem de ser ocultado, e o Windows não pede direitos de administrador. O HidHide é só para jogos definidos para vJoy.
  • O modo muda sozinho. Enquanto não escolher um modo, o jogo usa o comando Xbox. Escolha outro modo na página Joystick virtual, e o JoyPro mantém a sua escolha.
  • A sua curva chega ao comando. O jogo não recebe exportação, por isso o próprio JoyPro aplica a zona morta, a saturação, a curva e a inversão de Resposta do eixo (página Atribuições) ao stick ou gatilho do comando. Marque só este jogo em Aplica-se a para ter uma curva própria. Senão conta a Curva predefinida.
  • O arranque automático cria o comando cerca de 3 segundos depois de o jogo começar, antes do ecrã de título. Nos testes do JoyPro, um comando criado antes do ecrã de título nunca chegou a este jogo. Nesse caso prima Parar e Iniciar no ecrã de título.
  • Vários jogos no comando: cada jogo mantém a sua própria tabela. Com o arranque automático, fica ativa a tabela do jogo em execução. Senão, escolha-a em Tabela do comando Xbox para «Iniciar» e «Testar».
  • Especialistas: o vJoy, o HidHide, a taxa de reencaminhamento e os modos estão em Mostrar detalhes para especialistas (vJoy, HidHide, modos).

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
%LOCALAPPDATA%\HLLVietnam\Saved\Config\Windows\GameUserSettings.ini só leitura: SelectedGamepadLayout (LayoutA, LayoutB ou LayoutC)
%LOCALAPPDATA%\HLLVietnam\Saved\SaveGames\EnhancedInputUserSettings.sav as teclas do teclado que alterou; o JoyPro escreve aí as teclas de piloto (com a opção de teclado)
...\EnhancedInputUserSettings.sav.joypro-meta.json Os dados do JoyPro sobre as teclas exportadas para a próxima importação

#Os layouts de comando do helicóptero

Ação A B C
Collective up / down RT / LT LT / RT RT / LT
Cyclic pitch stick esquerdo Y stick direito Y stick esquerdo Y
Cyclic roll stick esquerdo X stick direito X stick esquerdo X
Yaw stick direito X stick esquerdo X LB / RB
Stability hold B B B
Auto-level toggle clique em LS clique em LS clique em LS
Supply drop D-pad direita D-pad direita D-pad direita
Recon flare D-pad cima D-pad cima D-pad direita
Look left / right, up / down stick direito stick esquerdo stick direito
Free look (hold) RB LB -
Next seat Y Y Y
Medic / medic radial A / RB A / RB A / RB

#Os modos de exportação (teclas de piloto do teclado)

Uma tecla por ação de piloto. Um botão do rato numa ação de piloto fica sempre; as teclas de infantaria e as comuns nunca mudam.

Modo O que acontece
Só adicionar A tecla do jogo fica; uma tecla que outra ação de piloto tem é ignorada e marcada "Não escrito no jogo".
Atualizar, manter atribuições do jogo / Atualizar, o meu perfil ganha A tecla do perfil é definida; outra ação de piloto nessa tecla perde-a (o jogo usa então aí a sua predefinição).
Substituir nos meus dispositivos As outras teclas de piloto que alterou no jogo voltam às predefinições do jogo.
+ Limpar também os meus outros dispositivos Nada a limpar: o jogo não guarda atribuições de joystick.

#O que nunca é tocado

  • Os layouts de comando do jogo: são fixos, e o JoyPro não escreve atribuições de comando.
  • As teclas de infantaria e de veículos, os botões do rato, todos os outros bytes do ficheiro de gravação.
  • HidHide: o comando simulado não precisa dele para este jogo.

#Comando, curvas, outras configurações

  • Inverter numa relação de eixo inverte esse eixo do comando no reencaminhador do JoyPro. O JoyPro aplica também a sua curva de eixo ao comando (ver acima); as configurações de comando do próprio jogo aplicam-se depois.
  • Uma ação sem tecla do comando no layout recebe o próximo controlo livre do comando; o que não cabe aparece listado na página Joystick virtual. As funções virtuais também funcionam no comando.
  • Configurações > Jogos: Hell Let Loose: Vietnam: usar a biblioteca Oodle de outro jogo instalado: os ficheiros do jogo estão comprimidos e ele não traz nenhuma biblioteca para os ler. Com o seu sim, o JoyPro usa uma que outro jogo deste PC tenha, no sítio onde está (nunca é copiada), para criar a lista a partir dos próprios ficheiros do jogo. Desligado: a tabela própria do JoyPro, que é tudo o que o modo comando precisa. Perguntar de novo esquece a sua resposta.
  • Monitor de jogos: o ficheiro de gravação do teclado é monitorizado 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.

#Hell Let Loose e Squad

Jogo O que se sabe JoyPro
Hell Let Loose (original) O seu Input.ini só tem a picada / guinada da artilharia e das metralhadoras de veículos; nada que voe. Não está planeado.
Squad Lê um dispositivo HID combinado; uma versão beta acrescenta vários dispositivos HOTAS. As atribuições estão em %LOCALAPPDATA%\SquadGame\Saved\Config\...\Input.ini. À espera da versão com vários dispositivos; sem integração.
Detalhes técnicos internos

#Por dentro da integração do Hell Let Loose: Vietnam

Código: engine\Games\HllVietnamIntegration.cs, engine\Games\GvasKeyMappings.cs; o planeador e o reencaminhador do comando de virtual-joystick.

  • Entrada: o executável do jogo não tem código DirectInput, raw input nem GameInput, só teclado, rato e XInput. Declara-se um jogo de um só dispositivo (0 joysticks, modo sugerido xbox).
  • Lista de comandos: DB\HLLVietnam\actions.tsv, dois tipos de linhas: ações de helicóptero Pad_* com a tecla predefinida por layout na 5.ª coluna (A:Gamepad_LeftY|B:Gamepad_RightY|C:Gamepad_LeftY), e teclas de piloto do teclado Driver_*. engine hllv refresh-db escreve a tabela própria do JoyPro, ou lê os recursos de entrada do jogo quando pode ser usada uma biblioteca Oodle (primeiro a do próprio jogo, a de outro jogo só depois do seu sim: --oodle-dll <path>, carregada onde está, só no processo de atualização). engine hllv oodle indica a biblioteca que usaria.
  • Plano do comando: o planeador lê o layout do GameUserSettings.ini e fixa cada ação à sua tecla nesse layout (Gamepad_LeftY para XB_LY, Gamepad_FaceButton_Right para XB_B ...); uma relação nas duas ações do coletivo torna-se XB_TRIGGERS; Inverter acrescenta ~ (com uma curva, é a curva que a leva). O jogo declara MaxJoysticks 0 e o modo sugerido xbox, por isso, sem uma escolha guardada, o seu modo é xbox; engine vjoy mode HLLVietnam xbox guarda uma escolha. engine vjoy map. Sem passo HidHide: engine vjoy apply-hidhide diz "HidHide is not needed" para jogos destes.
  • Tabelas de configuração: DB\Functions\HLLVietnam.tsv só lista, por enquanto, as ações de piloto do teclado Driver_*, por isso o assistente de configuração e a configuração rápida não colocam as ações Pad_*.
  • Ficheiro do teclado: Unreal GVAS com a parte final Enhanced Input (perfis, mapeamentos com nome, tecla, classe de hardware e posição). O JoyPro só reescreve os mapeamentos <Action>_Keyboard das ações de piloto; os nomes de teclas são convertidos em nomes de teclas Unreal (Space para SpaceBar, D1 para One).
  • Comandos: engine hllv paths, engine hllv catalog, engine hllv scan, engine hllv import, engine hllv export --include-keyboard --mode clean|add|merge|merge-overwrite --dry-run.

#Limites conhecidos

  • Um voo com o comando virtual ainda não está confirmado (coletivo nos gatilhos, cíclico, guinada, stability hold, supply drop); os menus foram verificados.
  • Nos layouts A e B, a guinada e o olhar partilham um eixo de stick.
  • Testes: engine\tests\smoke\hllv.ps1 (nenhuma biblioteca carregada sem o seu sim, a tabela alternativa, primeiro a biblioteca do próprio jogo); no jogo tools\e2e\games\HllVietnamXbox.ps1 (menus com o comando virtual; vJoy e HidHide inalterados no fim).

Todas as notas técnicas sobre este jogo (geradas a partir do repositório): hll-vietnam.md, one-device-games.md.