JoyPro2 Discord GitHub
Jogos

DCS World

Mostrar:

O DCS guarda os seus controlos por aeronave e por dispositivo: cada módulo tem as suas próprias atribuições no seu manche, e o DCS adiciona as suas próprias atribuições predefinidas a cada dispositivo. O JoyPro lê estes ficheiros para um perfil, permite-lhe criar relações que abrangem todas as suas aeronaves de uma vez ("Gear" no F-16C, no F/A-18C e no A-10C II) e escreve-as de volta nos ficheiros de cada aeronave. Nada corre enquanto voa: o DCS lê os seus próprios ficheiros como sempre.

DCS World nativo (os seus próprios ficheiros de atribuições)
Suporte
nativo (os seus próprios ficheiros de atribuições)
Comando do motor
engine dcs
Ficheiro de atribuições
Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua (diff Lua), teclado e modifiers.lua; ficheiro auxiliar .jp
Entradas que o jogo lê
lê 128 botões, 8 eixos, 4 hats por joystick (documentado)
Lista de comandos a partir de
os ficheiros Lua de entrada da instalação, executados pelo próprio luae.exe do DCS (o DCS fica fechado)
Teste no jogo
56/56 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 jogoO DCS guarda as suas configurações de force feedback por dispositivo e aeronave (FF Tune), ver Force feedback no jogo; não há configurações de controlo globais do jogo a gerir.
  • ✓ 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 DCS fechado

Antes: se o cartão do DCS na página Início pedir uma lista de comandos, prima primeiro Criar lista.

Depois: inicie o DCS. As suas atribuições estão em Options > Controls, para cada aeronave.

Já atribuiu botões no DCS 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.

#Onde ficam as funções?

A configuração faz uma grande pergunta, com um slider. Conta sobretudo no DCS, porque voa muitas aeronaves diferentes.

Extremo esquerdo Extremo direito
Mesmo botão para a mesma tarefa em todas as aeronaves Onde a aeronave real o tem
O trem de aterragem está no mesmo botão em todos os aviões. Fácil de aprender. Cada botão faz o que o botão do manche real nesse sítio faz.

A configuração rápida usa a sua última escolha (o meio, da primeira vez). A arma e o acelerador nunca mudam de sítio. Veja Onde devem ficar as funções?.

#Olhar à volta sem head tracking

Sem TrackIR, sem VR? A configuração põe o olhar à volta num hat do seu manche: para a frente, para trás, para a esquerda e para a direita. Um mini-stick no seu acelerador pode receber os eixos de olhar. Veja Head tracking e olhar à volta.

A configuração faz primeiro uma pergunta: Usa rastreamento de cabeça ou RV? Sim (rastreamento de cabeça, face tracking, Tobii ou RV, ou tenciona arranjar um): nenhum botão de vista nos seus dispositivos, só "recentrar a vista". Não: olhar em volta recebe um bom lugar num hat do seu manche.

#As suas atribuições na kneeboard

O DCS pode mostrar uma página por aeronave na sua kneeboard. O JoyPro põe lá uma lista dos seus botões: abra Layout, prima Folhas de referência e depois Colocar na kneeboard. No cockpit, abra a kneeboard: a sua página está lá. Veja Ver as minhas atribuições na kneeboard do DCS.

#O que o JoyPro faz pelo DCS

  • Importar: as atribuições de cada aeronave nos seus manches, aceleradores e pedais entram no seu perfil, com os seus modificadores e configurações de eixo. Por predefinição, as atribuições predefinidas do DCS que estão ativas nos seus dispositivos também entram, para que nada se perca quando voltar a exportar.
  • Relações: uma relação é uma função em todas as aeronaves. "Weapon release" pode ser o botão pickle no F-16C e no A-10C II, com um só botão no seu manche.
  • Exportar: o JoyPro escreve os ficheiros de cada aeronave marcada. O DCS mostra depois as suas atribuições em Options > Controls.

#Importar as suas atribuições do DCS

  1. Abra Iniciar. O cartão do DCS mostra a imagem do jogo. Se o cartão pedir uma lista de comandos, prima primeiro Criar lista: o JoyPro lê cada módulo instalado com o próprio Lua do DCS (o DCS fica fechado; de alguns segundos a um minuto).
  2. Prima Importar no cartão do DCS. Mantenha Todas as minhas aeronaves DCS marcado, ou desmarque e escolha as aeronaves que voa.
  3. Prima Importar agora. Ver as minhas relações abre o que entrou.
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

Na página Relações, uma relação lista a sua ação por aeronave. Use o filtro de aeronaves para ver um módulo, e o fluxo das relações para juntar ações de várias aeronaves numa relação. Depois Verificar na página Exportar: encontra um botão que faz duas coisas na mesma aeronave antes de o DCS o fazer.

#Exportar para o DCS

  1. Feche o DCS. O JoyPro recusa escrever enquanto o DCS está a correr, porque o DCS escreve os seus ficheiros quando sai.
  2. Abra Exportar. No cartão do DCS, Aeronaves... lista todas as aeronaves do seu perfil: só as aeronaves marcadas são escritas, as outras mantêm os seus ficheiros exatamente como estão.
  3. Mantenha a primeira escolha, 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 do DCS.
O cartão do DCS com a lista de aeronaves: só as aeronaves marcadas são escritasO cartão do DCS com a lista de aeronaves: só as aeronaves marcadas são escritas
O cartão do DCS com a lista de aeronaves: só as aeronaves marcadas são escritas
No jogo: O que vê no DCS

Inicie o DCS e abra Options > Controls, depois escolha a aeronave no topo. As suas atribuições estão na coluna do seu dispositivo, com os nomes de comandos do próprio DCS; as predefinições do DCS que o JoyPro removeu aparecem como células vazias; os seus modificadores estão na lista de modificadores do DCS. As curvas de eixo aparecem em Axis Tune do eixo. As outras aeronaves que não marcou ficam como antes.

#O que faz você mesmo no DCS

  • Não é preciso mais nada para as atribuições. Se usa outra pasta Saved Games (por exemplo Saved Games\DCS.openbeta), defina-a uma vez em Configurações > Jogos em Controlos guardados em.
  • Para a aeronave do HUD e para o force feedback a partir da telemetria, o JoyPro instala uma vez um pequeno script no DCS (veja Avançado); feche também o DCS para isso.

#Erros comuns

  • "O DCS está a correr": feche o DCS (também o processo em segundo plano do launcher) e exporte outra vez.
  • Uma aeronave manteve as atribuições antigas: não foi marcada em Aeronaves... no cartão do DCS, ou o perfil não tem nenhuma relação para ela.
  • Um manche tem atribuições que nunca fez: são as atribuições predefinidas do DCS num dispositivo que o JoyPro não escreveu. Marque Limpar também os meus outros dispositivos, ou veja Atribuições predefinidas abaixo.
  • Dois dispositivos idênticos: o DCS distingue-os pelo ID de instância; mantenha Tratar dispositivos com o mesmo nome como um só dispositivo ligado, para que um dispositivo a que o Windows deu um ID novo seja lido como o mesmo dispositivo.
  • Um comando que o DCS mostra "não está na lista": foi adicionado por um mod (por exemplo o Input Command Injector com um pacote de atribuições da comunidade). Quando a página Início disser Os seus mods do DCS alteraram a lista de controlos; reconstrua a lista de comandos, prima Atualizar DB uma vez: o JoyPro lê os comandos do mod da mesma forma que o DCS. Os comandos que o JoyPro encontra antes disso nos seus ficheiros de atribuições do DCS já são conhecidos e estão marcados como dos seus ficheiros do DCS.
Avançado

#Ficheiros que o JoyPro lê e escreve

Ficheiro O que é
%USERPROFILE%\Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua as suas atribuições num dispositivo numa aeronave, como diferenças em relação às predefinições do DCS (keyDiffs, axisDiffs com added / removed, ffDiffs)
...\<aircraft>\joystick\<device>.jp A cópia do JoyPro com os nomes das relações e os grupos, lida de novo pela próxima importação
...\<aircraft>\keyboard\Keyboard.diff.lua o teclado (só quando exporta atribuições de teclado)
...\<aircraft>\modifiers.lua os modificadores da aeronave

<aircraft> é o nome do perfil de entrada que o módulo declara (por exemplo F-16C_50, FA-18C_hornet). Outra pasta Saved Games (DCS.openbeta) define-se em Configurações > Jogos. Os ficheiros são escritos sem marca de ordem de bytes (BOM), porque o Lua do DCS não a consegue carregar.

#Comandos de mods

Alguns mods acrescentam comandos à lista de controlos do DCS:

  • Input Command Injector (de Quaggles, muitas vezes com um pacote de atribuições da comunidade): os comandos extra ficam em Saved Games\DCS\InputCommands\<module>\Input\<profile>\joystick\default.lua (e keyboard), e o injetor na instalação do DCS (Scripts\Hooks) junta-os à lista própria do módulo quando o DCS carrega os controlos.
  • Módulos em Saved Games\DCS\Mods\aircraft: trazem as suas próprias listas de comandos.

A lista de comandos do JoyPro (Criar lista / Atualizar DB) lê-os como o DCS: a partir da pasta Saved Games que a sua instalação do DCS usa de facto (DCS.openbeta numa instalação OpenBeta), com os comandos do injetor juntos quando o injetor está instalado, e com os mesmos ids de comando que o DCS lhes dá. Quando os seus mods mudam, a página Início diz Os seus mods do DCS alteraram a lista de controlos; reconstrua a lista de comandos; um Atualizar DB traz os novos comandos.

Um comando que está nos seus ficheiros de atribuições do DCS mas ainda não está na lista de comandos (por exemplo de um mod que acrescentou depois de a lista ser criada) é reconhecido na mesma: o JoyPro tira o id e o nome exatos do ficheiro e marca-o dos seus ficheiros do DCS na página Relações, e a página Início sugere reconstruir a lista.

Ficheiro O que é
Saved Games\DCS\InputCommands\... os comandos extra do Input Command Injector (só leitura)
<data>\GameData\DcsCommandsFromYourFiles.tsv comandos encontrados nos seus ficheiros de atribuições do DCS que faltam na lista de comandos

#Os modos de exportação no DCS

Todos os modos trabalham sobre as atribuições que um ficheiro de dispositivo tem ativas no DCS: as predefinições do dispositivo, menos o que o ficheiro remove, mais o que acrescenta. O JoyPro escreve depois só as diferenças reais em relação às predefinições, tal como o próprio DCS faria.

Modo O que acontece na aeronave exportada
Só adicionar Nada é removido. Uma atribuição cujo botão o DCS já usa para outro comando (também uma predefinição do DCS) não é escrita e recebe uma marca "Não escrito no jogo".
Atualizar, manter atribuições do jogo As suas atribuições entram; as predefinições do DCS e as suas atribuições feitas no jogo ficam, exceto a atribuição de outro comando num botão que usa.
Atualizar, o meu perfil ganha Como acima, e cada comando que atribui perde os seus outros botões nessa aeronave (em todos os ficheiros de dispositivo e nos dispositivos ligados sem ficheiro; as predefinições do DCS contam).
Substituir nos meus dispositivos Os dispositivos que escreve recebem exatamente as suas atribuições na aeronave exportada, sem as predefinições do DCS.
+ Limpar também os meus outros dispositivos Os dispositivos ligados sem atribuições na aeronave perdem lá todas as atribuições, incluindo as predefinições do DCS.

Opções na página Exportar (em Opções e caminhos (para especialistas)):

  • Manter predefinições do teclado (ligado): não é escrito nenhum ficheiro de teclado. Desligado: as suas atribuições de teclado são escritas, e só são removidas as teclas predefinidas do DCS que elas ocupam; todas as outras teclas predefinidas ficam.
  • Os meus dispositivos perdem as atribuições predefinidas do DCS também em todas as outras aeronaves (desligado): com Substituir, os dispositivos escritos também são esvaziados em todas as aeronaves instaladas que não exportou. As camadas de entrada (camada UI, câmara, geral) nunca são tocadas.
Opções e caminhos (para especialistas) na página Exportar: as opções do DCS, os caminhos e os dispositivos ignoradosOpções e caminhos (para especialistas) na página Exportar: as opções do DCS, os caminhos e os dispositivos ignorados
Opções e caminhos (para especialistas) na página Exportar: as opções do DCS, os caminhos e os dispositivos ignorados

#O que nunca é tocado

  • Os dispositivos que não estão ligados mantêm os seus ficheiros byte a byte.
  • Os dispositivos ignorados da importação e o dispositivo vJoy para onde o JoyPro encaminha nunca são limpos.
  • O teclado nunca é limpo nem tomado, em nenhum modo; as atribuições de rato nunca são escritas.
  • As aeronaves que não marcou e as camadas de entrada (camada UI, câmara, a camada geral) mantêm os seus ficheiros.
  • As configurações de force feedback (ffDiffs) de um ficheiro de dispositivo que é esvaziado ficam.

#Atribuições predefinidas

O DCS dá a cada tipo de dispositivo as suas próprias predefinições por aeronave (um manche Warthog recebe predefinições diferentes de um manche genérico). O JoyPro conhece-as a partir dos perfis limpos que cria a partir do seu DCS com a lista de comandos: um por aeronave e tipo de dispositivo. As opções Substituir e Limpar também os meus outros dispositivos removem exatamente estas predefinições dos dispositivos que escrevem.

Para os dispositivos que o JoyPro não escreve, Configurações > DCS: atribuições predefinidas oferece duas alterações à própria instalação do DCS, ambas desligadas a menos que as ligue: retirar as predefinições de todos os ficheiros de joystick (cada original guardado como <file>.nocombo.bak), ou mover os ficheiros predefinidos específicos de dispositivo do DCS para a pasta de backups do JoyPro. Os ficheiros alterados falham a verificação de integridade dos servidores que a exigem; Restaurar ficheiros do DCS repõe todos os originais. Depois de uma atualização do DCS, o JoyPro volta a aplicar uma opção ligada ao arrancar.

Um ficheiro de dispositivo só contém as diferenças em relação às predefinições do DCS: ativo no DCS = as predefinições, menos o que o ficheiro remove, mais o que acrescenta. Cada modo de exportação decide que atribuições devem estar ativas; o JoyPro escreve depois só a diferença. Um exemplo numa aeronave:

Na aeronave O que o ficheiro de dispositivo recebe
Uma atribuição predefinida do DCS que mantém nada: já é uma predefinição (só aparece listada no .jp)
Uma atribuição predefinida do DCS que não quer uma linha "removed"
Uma atribuição sua que não é predefinida uma linha "added"
Uma atribuição predefinida com outro ajuste (curva, inversão) uma linha "changed"

#Aeronaves, curvas, force feedback

  • Por aeronave: cada relação mantém a sua ação por aeronave; a exportação escreve só as aeronaves marcadas.
  • Curvas de eixo: zona morta, saturação X e Y, curvatura ou uma curva do utilizador de 11 pontos, inversão e slider, escritos por aeronave como o próprio filtro do DCS (o que Axis Tune mostra). A Curva predefinida conta para todos os jogos; também se pode definir uma curva para o DCS ou para uma aeronave (Atribuições > Resposta do eixo).
  • Force feedback no jogo: Configurações > Force feedback do DCS define, por dispositivo, a troca de eixos, inverter X e inverter Y (engine dcs ffb set). Force feedback por telemetria: a página Force feedback instala o hook do JoyPro Saved Games\DCS\Scripts\Hooks\JoyProFfb.lua (o DCS tem de estar fechado; outros scripts como o SRS ou o Tacview continuam a funcionar).
  • HUD: o HUD mostra as atribuições da aeronave que pilota quando o hook do DCS está instalado (página HUD > Instalar hook do DCS: um pequeno ficheiro Lua mais uma linha protegida no Export.lua, com backup feito antes), ou escolha a aeronave à mão.
  • Monitor de jogos: uma atribuição que mude em Options > Controls do DCS é detetada depois de o DCS fechar; o JoyPro pergunta se a deve adotar. Só são comparadas as aeronaves cujos ficheiros mudaram, com as predefinições do dispositivo mais o seu diff.
Detalhes técnicos internos

#Por dentro da integração do DCS

flowchart LR
  P["O seu perfil"] --> E["engine dcs export"]
  C[("Perfis limpos<br/>(predefinições do DCS)")] --> E
  E --> D["device.diff.lua<br/>+ .jp"]
  E --> M["modifiers.lua"]
  D --> G["DCS: Options ><br/>Controls"]
  L["Layout: Colocar na<br/>kneeboard"] --> K["Páginas da<br/>kneeboard"]
Exportar escreve as aeronaves marcadas: por aeronave e dispositivo só as diferenças em relação às predefinições do DCS (device.diff.lua, a partir dos perfis limpos), ao lado um ficheiro .jp com nomes e grupos, e modifiers.lua. As páginas da kneeboard (Saved Games / DCS / Kneeboard) vêm da página Layout, não de Exportar.

Código: engine\EngineDcsImport.cs, engine\EngineDcsExport.cs, engine\EngineDcsExport.Modes.cs, engine\EngineDcsRefresh.cs, engine\DcsDeviceNames.cs, engine\DcsCommandNames.cs, engine\EngineDcsDefaultsStrip.cs.

  • Nomes de dispositivo: o DCS chama a um joystick <DirectInput instance name> {<instance GUID>}, com o nome de instância exatamente como o DirectInput o indica, incluindo espaços nas pontas. Os nomes próprios do JoyPro cortam esses espaços; DcsDeviceNames converte nos dois sentidos. A exportação dá a um ficheiro o nome bruto do dispositivo ligado, o nome de um ficheiro existente para um dispositivo que não está ligado, ou senão o nome do JoyPro. Os ficheiros que uma versão antiga do JoyPro escreveu com o nome cortado são lidos quando não existe nenhum ficheiro com o nome do DCS, e removidos depois da escrita (com backup).
  • Lista de comandos: engine dcs refresh id executa o Lua de entrada de cada módulo no próprio bin\luae.exe do DCS (sem janela do jogo), em várias execuções ao mesmo tempo; os nomes dos comandos em inglês vêm do l10n\en\LC_MESSAGES\input.mo da instalação, seja qual for o idioma do DCS. engine dcs refresh clean cria os perfis limpos: o próprio InputData.clearProfile do DCS com um manche fictício por tipo de dispositivo, numa pasta Saved Games temporária (a sua Config\Input nunca é alterada). Ficheiros: %LOCALAPPDATA%\JoyPro2\GameData\CleanProfile\DCS\<aircraft>.cf, ...\<aircraft>\<device type>.cf, KeyboardCleanProfile\DCS\<aircraft>.cf.
  • Importar: engine dcs import (--planes, --only-connected, --merge-same-name, --include-defaults, --include-keyboard, os interruptores de ajuste --import-*); engine dcs scan mostra o mesmo sem alterar o perfil.
  • Exportar: engine dcs export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --clean-all-aircraft true|false --planes <csv> --ignore-device <d>; --clear-keyboard-defaults true (só na linha de comandos) também remove todas as outras teclas predefinidas do DCS das aeronaves escritas. Backups: cada ficheiro para <file>.jpbak e para %LOCALAPPDATA%\JoyPro2\GameBackups antes da primeira escrita.
  • Verificação: engine dcs verify-clean deixa o próprio Lua do DCS listar cada atribuição predefinida ainda ativa nos seus joysticks (só leitura; --include-disconnected com manches fictícios, --dump-active para comparar antes e depois de uma exportação).
  • Atribuições predefinidas na instalação: engine dcs strip-defaults (apply|restore|status|auto, linha marcadora -- [[DCS_STRIP_JOYSTICK_DEFAULTS v1]], originais como .nocombo.bak, cada ficheiro alterado carregado pelo carregador do DCS antes de contar) e engine dcs device-luas (list|remove|restore; os ficheiros vão para <data>\DcsDefaults\DeviceLuas com um manifesto). Ambos recusam enquanto o DCS ou o seu atualizador estiverem a correr.
  • Force feedback: engine dcs ffb list, engine dcs ffb set, engine dcs ffb clear.
  • Hook do HUD: engine overlay dcs-hook status (install / remove): o DCS envia o tipo de unidade para 127.0.0.1:1992.

#Limites conhecidos

  • Só os módulos instalados recebem listas de comandos e perfis limpos.
  • Um dispositivo para o qual executou o assistente de eixos do DCS mantém a atribuição do assistente como predefinição (wizard.lua, por instância de dispositivo); o JoyPro não a altera.
  • As camadas de entrada que o DCS partilha entre aeronaves (General, camada UI, Combined Arms) não são escritas.
  • Testes: engine\tests\smoke\dcsexportmodes.ps1 (todos os modos, ida e volta, desfazer byte a byte), smoke\dcskeyboard.ps1, smoke\dcsdefaults.ps1; no jogo tools\e2e\games\DCS.ps1 e DCSCurves.ps1.

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