JoyPro2 Discord GitHub
Jogos

Arma 3

Mostrar:

O Arma 3 guarda as suas atribuições no seu perfil de jogador, <name>.Arma3Profile: uma linha por ação com códigos numéricos, e uma lista dos joysticks que o jogo já viu. O JoyPro lê as atribuições de aviões e helicópteros para o seu perfil e escreve-as de volta apenas nessas linhas. As atribuições de infantaria, veículos e menus ficam como estão. No Arma, as curvas de resposta são por dispositivo e eixo físico, por isso uma curva conta para todos os veículos.

Arma 3 nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine arma3
Ficheiro de atribuições
Documents\Arma 3\<name>.Arma3Profile (texto ParamFile, códigos de entrada numéricos)
Lista de comandos a partir de
a configuração do jogo (bin.pbo > config.bin) com os nomes em inglês de languagecore; não é preciso um primeiro arranque
Teste no jogo
25/25 passos concluídos (2026-10-10)
  • ✓ 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
    com o Arma 3 fechado

Antes: inicie o Arma 3 uma vez com todos os dispositivos ligados e depois saia.

Depois: as suas atribuições estão em Options > Controls.

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

  • Importar: as atribuições de aviões e helicópteros nos seus manches, aceleradores e pedais entram no seu perfil, com a sensibilidade, a zona morta e a inclinação da curva de cada eixo.
  • Relações: uma relação é uma função em todos os jogos. "Gear" pode ser o mesmo interruptor no Arma 3, no DCS e nos outros jogos.
  • Exportar: o JoyPro reescreve apenas as linhas de teclas das ações de voo. As suas atribuições de teclado e rato ficam, também nessas ações.

#Importar as suas atribuições do Arma 3

  1. Abra Iniciar. Se o cartão do Arma 3 pedir uma lista de comandos, prima Criar lista: o JoyPro lê as ações e os seus nomes em inglês da configuração do jogo (só leitura, não é preciso um primeiro arranque).
  2. Prima Importar no cartão do Arma 3 e mantenha Adicionar ao meu perfil.
  3. Prima Importar agora. Ver as minhas relações abre o que entrou.

As atribuições de teclado não são importadas nem exportadas no Arma 3: o JoyPro gere apenas os seus joysticks.

#Criar e verificar relações

Junte a mesma função dos seus jogos com o fluxo das relações e depois prima Verificar na página Exportar. A exportação conta helicópteros e aviões como veículos diferentes: o mesmo botão numa ação de avião e numa ação de helicóptero não é um conflito; duas ações de avião num botão são.

#Exportar para o Arma 3

  1. Feche o Arma 3. O jogo guarda o perfil quando sai e quando muda as configurações, por isso o JoyPro recusa escrever enquanto ele está a correr.
  2. Abra Exportar e marque o cartão do Arma 3.
  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.
No jogo: O que vê no Arma 3

Inicie o jogo e abra Options > Controls no menu principal. As suas atribuições estão nas ações de aviões e helicópteros, ao lado das teclas do teclado que tinha. Em Controllers os seus dispositivos estão listados e ativados; Customize de um dispositivo mostra a sensibilidade, a zona morta e a inclinação da curva que o JoyPro escreveu.

#O que faz você mesmo no Arma 3

  • Inicie o Arma uma vez com todos os dispositivos ligados. O jogo adiciona um dispositivo à sua lista (e dá-lhe o seu intervalo de números) da primeira vez que o vê. O JoyPro não consegue escrever um dispositivo que não esteja na lista: ignora-o e diz-lhe para iniciar o jogo uma vez com ele ligado.
  • Um dispositivo que desativou na lista Controllers do jogo é ligado pela exportação quando recebe atribuições (a exportação di-lo), a não ser que o tenha desligado para o Arma 3 no JoyPro (enabled=0, veja Técnico).

#Erros comuns

  • "O Arma 3 está a correr": saia do jogo e exporte outra vez.
  • Um dispositivo foi ignorado: o Arma ainda não o viu, ou recebeu um ID novo (outra porta USB dá uma entrada nova com um novo intervalo de números). Inicie o jogo uma vez com ele ligado.
  • Duas relações num eixo com curvas diferentes: o Arma tem uma curva por eixo físico. Ganha a primeira relação por nome; a exportação nomeia ambas.
  • O acelerador só funciona em metade da alavanca: o impulso analógico precisa das duas metades da alavanca. O JoyPro escreve o acelerador e o travão aerodinâmico do avião como um eixo completo; verifique se a relação está num eixo e não num botão.
Avançado

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
%USERPROFILE%\Documents\Arma 3\<name>.Arma3Profile o perfil predefinido: linhas key<Action>[]={...};, class JoysticksList (dispositivos com as suas listas de valores) e as opções do jogo
%USERPROFILE%\Documents\Arma 3 - Other Profiles\<name>\<name>.Arma3Profile os seus outros perfis (os nomes de pastas e ficheiros estão codificados como URL, Mission%20Builder)
<profile>.joypro-meta.json Os nomes, grupos e ajustes do JoyPro para as atribuições escritas, lidos de novo pela próxima importação
<profile>.jpbak a cópia de antes da primeira escrita, mais o arquivo de backups com versões do JoyPro

O JoyPro nunca toca em <name>.vars.Arma3Profile nem em .3den.Arma3Profile, e para quando o perfil é um ficheiro binário (rapified) em vez de texto. Uma pasta -profiles= ou outra pasta Documentos pode ser definida na página Exportar, em Opções e caminhos (para especialistas).

#Os modos de exportação no Arma 3

Só mudam as linhas das ações de aviões e helicópteros do catálogo. Os códigos de teclado, rato, TrackIR e comandos Xbox ficam sempre.

Modo O que acontece no perfil
Só adicionar Nada é removido. Uma atribuição cujo código outra ação do mesmo veículo já tem não é escrita e recebe uma marca "Não escrito no jogo".
Atualizar, manter atribuições do jogo Os seus códigos entram; um código de outra ação do mesmo veículo que colocou noutro sítio é retirado. Os outros códigos da ação ficam.
Atualizar, o meu perfil ganha Como acima, e uma ação que atribui perde os seus outros códigos de joystick dos joysticks ligados.
Substituir nos meus dispositivos As linhas de voo também perdem todos os outros códigos dos dispositivos escritos.
+ Limpar também os meus outros dispositivos O mesmo para os códigos dos outros joysticks ligados. Um joystick que não está ligado mantém os seus códigos.

#O que nunca é tocado

  • Ações de infantaria, veículos, vista e menu; todas as linhas que não são uma ação de voo do catálogo.
  • Códigos de teclado, rato, TrackIR e comando Xbox.
  • Joysticks que não estão ligados, códigos cujo intervalo numérico não tem nenhum dispositivo na lista, os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha.
  • A própria lista de dispositivos: o JoyPro não acrescenta entradas e só muda as listas de valores, o modo e os valores de clique analógico das existentes.

#Veículos, curvas, configurações do jogo

  • Granularidade: um conjunto de atribuições para todos os aviões e helicópteros. Algumas ações são partilhadas (leme, trem de aterragem).
  • Curvas de eixo, por dispositivo e eixo físico, tal como o diálogo Customize as guarda: sensibilidade para cada metade (-1 = cúbica, 0 = linear, +1 = raiz cúbica), zona morta (0 a 0.1) e inclinação (1.0, 1.2, 1.5, 1.9, 2.4 ou 3.0; outros valores são arredondados para o mais próximo, com um aviso). A inclinação multiplica e satura, não é um expoente. O JoyPro só escreve valores que definiu para o Arma 3 ou que vieram da importação; a sua curva geral do JoyPro não é transportada.
  • Inverter: o Arma não tem opção de inversão. O JoyPro inverte atribuindo a metade oposta do eixo.
  • Acelerador de eixo completo: "Thrust (Analog)" e "Speedbrake (Analog)" recebem as duas metades da alavanca, primeiro a metade negativa (alavanca para a frente); invertido, primeiro a metade positiva.
  • Configurações do jogo: o modelo de voo avançado do helicóptero e o seu auto-trim, os instrumentos, as opções de aterragem dura, vento e danos por esforço, e a vibração do comando; ligar/desligar por dispositivo e os limiares de clique analógico. Defina-as em Configurações > Configurações de force feedback dos jogos (escolha Arma 3) ou com engine ffb set. Uma exportação sem atribuições do Arma 3 escreve-as na mesma e não toca em nenhuma linha de tecla.
  • Force feedback: o Arma 3 não tem opção de force feedback para joystick.
  • Monitor de jogos: uma atribuição ou uma curva que mude no jogo é detetada depois de o jogo fechar; o JoyPro pergunta se a deve adotar.
  • HUD: o HUD encontra o jogo pelo seu processo e mostra as suas atribuições do Arma 3.
Detalhes técnicos internos

#Por dentro da integração do Arma 3

flowchart LR
  D["O seu dispositivo"] --> J["JoysticksList"]
  J --> C["Visto: códigos<br/>com um offset"]
  J --> S["Não visto:<br/>ignorado"]
  P["O seu perfil"] --> E["engine arma3 export"]
  C --> E
  E --> L["Linhas de teclas"]
  E --> A["Listas dos dispositivos"]
O Arma tem de ter visto um dispositivo uma vez (o seu GUID de instância em JoysticksList do perfil). Cada dispositivo que viu recebe o seu próprio intervalo de códigos (offset 256, 512 ...); um dispositivo ainda não visto é ignorado: inicie o Arma uma vez com ele. Exportar escreve as linhas de teclas das ações de aviões e helicópteros e as listas dos dispositivos (sensibilidade, zona morta, inclinação).

Código: engine\Games\Arma3Integration.cs sobre o código de perfis Arma partilhado com o Arma 2 (ArmaProfileIntegration.cs, ArmaGameData.cs), o modelo de eixos engine\AxisModels\Arma3.cs e o modelo de configurações engine\FfbModels\Arma3.cs.

  • Dispositivos: class JoysticksList { class Joystick1 { guid="..."; name="..."; offset=256; isXInput=0; sensitivity[]={...}; deadZone[]={...}; steepness[]={...}; mode="Custom"; ... }; }. guid é o GUID de instância DirectInput, em maiúsculas, sem chavetas. offset é 256 vezes N, atribuído quando o jogo vê o dispositivo pela primeira vez; as entradas ficam depois de o desligar. mode="Disabled" desliga um dispositivo.
  • Códigos (32 bits com sinal, off = o offset do dispositivo): botão 0x20000 + off + button; eixo 0x30000 + off + a, a de 0 a 7 a metade positiva, a + 8 a metade negativa (X, Y, Z, RotX, RotY, RotZ, Slider 1, Slider 2); hat 0x40000 + off + direction (oito direções, um hat). Os códigos de teclado são números DIK.
  • Listas de valores: sensitivity[] (16 valores, primeiro as metades positivas e depois as negativas), deadZone[] (8) e steepness[] (8). Uma lista em falta é criada depois da anterior na ordem de gravação do jogo, com as predefinições do jogo para os outros eixos, só quando um valor difere da predefinição. Importação + exportação dão o mesmo ficheiro byte a byte.
  • Lista de comandos: engine arma3 refresh-db lê CfgDefaultKeysPresets de bin.pbo > config.bin e os nomes de menu em inglês do stringtable.xml de languagecore_f.pbo; um perfil acrescenta ações de mods. 51 ações. engine arma3 catalog lista-as, engine arma3 paths mostra os perfis encontrados.
  • Importação / exportação: engine arma3 import, engine arma3 scan; engine arma3 export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices --ignore-device <d> --dry-run.
  • Configurações: engine ffb set --device "<name> {GUID}" --game Arma3 --param enabled=0|1 (também analogClickHigh, analogClickLow); para todo o jogo, --device * com RTDEnabled, RTDAutoTrim, RTDFullHUD, RTDRoughLanding, RTDWindDynamic, RTDStressDamage, vibrations.

#Limites conhecidos

  • Os botões de joystick com modificadores ainda não estão confirmados; o JoyPro não escreve modificadores nem atribuições de teclado para o Arma 3.
  • Podem ser codificados até 256 botões, 8 eixos e um hat por dispositivo (segundo o formato do ficheiro).
  • Ainda não está confirmado se o slider de Customize escreve o mesmo valor nas duas metades, nem como funcionam as curvas por ação que algumas ações acrescentam por cima (a pré-visualização só mostra a curva do dispositivo).
  • Testes: engine\tests\smoke\arma.ps1 (listas de valores, configurações, acelerador de eixo completo, aviso de conflito, ida e volta de importação, exportação só de configurações); no jogo tools\e2e\games\Arma3Settings.ps1 (perfil de teste JoyProE2E, só menu principal > Options > Controls).

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