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 delanguagecore; 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.
#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
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
- 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).
- Prima Importar no cartão do Arma 3 e mantenha Adicionar ao meu perfil.
- 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
- 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.
- Abra Exportar e marque o cartão do Arma 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.
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.
#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.
#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"]
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ão0x20000 + off + button; eixo0x30000 + off + a,ade 0 a 7 a metade positiva,a + 8a metade negativa (X, Y, Z, RotX, RotY, RotZ, Slider 1, Slider 2); hat0x40000 + 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) esteepness[](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-dblêCfgDefaultKeysPresetsdebin.pbo>config.bine os nomes de menu em inglês dostringtable.xmldelanguagecore_f.pbo; um perfil acrescenta ações de mods. 51 ações.engine arma3 cataloglista-as,engine arma3 pathsmostra 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émanalogClickHigh,analogClickLow); para todo o jogo,--device *comRTDEnabled,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 jogotools\e2e\games\Arma3Settings.ps1(perfil de testeJoyProE2E, só menu principal > Options > Controls).
Todas as notas técnicas sobre este jogo (geradas a partir do repositório): arma3.md.