JoyPro2 Discord GitHub
Projeto

Do JoyPro 1 ao JoyPro 2

Mostrar:

O JoyPro 1 (2021 a 2023) era uma ferramenta para o DCS: criava relações entre as entradas de aeronaves diferentes e atribuía-as ao mesmo sítio no manche. O JoyPro 2 mantém exatamente essa ideia e o mesmo modelo de relação / atribuição / modificador (um perfil do JoyPro 1 abre-se no JoyPro 2), e reconstrói tudo à volta dela: uma interface nova, um motor que também funciona sozinho, dezenas de jogos, testes para cada função, e muita segurança.

#Os números

Todos os números são medidos no código-fonte dos dois projetos (ficheiros seguidos no git; linhas de código = linhas de C# não vazias que não são comentários). Os números do JoyPro 2 vêm da compilação deste site.

JoyPro 1 JoyPro 2
Desenvolvimento 2021-02-11 a 2023-11-15 desde 2026-09-30
Commits 336 1,406
Linhas de código C# 25,502 354,663 (13.9 x)
Ficheiros C# 77 954
Tipos (classes, records, enums ...) 106 3,059 (29 x)
Métodos 450 16,702 (37 x)
Testes automáticos (unidade, view model, renderização) 0 1,537 em 198 ficheiros de teste
Partes do teste de fumo do motor (motor real em pastas de teste) 0 87
Projetos na solução 2 12
Linhas de markup da interface 973 (WPF XAML) 17,250 (Avalonia AXAML)
Linhas de documentação (Markdown) 109 25,636
Jogos 1 (DCS), mais tarde IL-2 36 suportados pelo JoyPro, 57 títulos estudados
Idiomas da interface 1 39
Comandos do motor (linha de comandos) nenhum (só interface gráfica) 451 em 60 áreas, 19 opções globais
Controlos da interface documentados neste site 1097

Onde está o código no JoyPro 2 (linhas de código C#): motor 187,202, interface 80,286, testes da interface 56,600, force feedback 14,394.

flowchart LR
  W["Uma janela<br/>(ecrã e lógica<br/>numa só)"] --> D1["Ficheiros do DCS"]
JoyPro 1: uma janela que fazia tudo, para o DCS.
flowchart TB
  G["A janela"] --> E["O motor<br/>(faz cada ação)"]
  G --> F["Ajudante de<br/>force feedback"]
  G --> V["Ajudante do<br/>joystick virtual"]
  T["Monitor de jogos<br/>na área de notificação"] --> E
  E --> D2["36 jogos"]
  F ~~~ V
JoyPro 2: uma janela que passa cada ação ao motor, com ajudantes para o force feedback, o joystick virtual e o monitor de jogos.
Para iniciantes

#O que é melhor para si

  • Muitos jogos, um perfil. O JoyPro 1 era para o DCS. O JoyPro 2 importa e exporta 36 títulos de jogos: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 e 2024, X-Plane 11 e 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma, e mais. Uma relação guarda a mesma função em todos eles.
  • Comece com o que já tem. Importar lê as suas atribuições existentes de cada jogo; a configuração do primeiro arranque encontra os seus jogos sozinha.
  • Nada se estraga para sempre. Cada exportação faz primeiro um backup dos ficheiros do jogo, e Desfazer última exportação repõe-nos byte a byte. Cada alteração no JoyPro é guardada automaticamente e pode ser desfeita, mesmo depois de reiniciar (histórico do perfil).
  • Diz-lhe o que correria mal. A Verificação explica os problemas com as palavras do jogo e corrige-os com um clique.
  • Configura-se sozinho. Configurar tudo por mim põe as funções importantes no seu manche, acelerador e pedais. Vê a lista e prime Usar estes botões e Escrever no meu jogo.
  • Menos cliques. As sugestões, o Agrupamento automático, a Atribuição automática, o assistente de configuração e um assistente do JoyPro criam relações e atribuições por si; um "o seu estilo" aprendido segue a forma como o fez antes.
  • Nota as alterações. Quando muda uma atribuição dentro de um jogo, o JoyPro pergunta, depois de o jogo fechar, se a deve levar para o seu perfil.
  • O seu idioma. A interface fala 39 idiomas.
  • Mais do que atribuições. Imagens dos dispositivos e folhas de referência, um HUD e um overlay para streaming, force feedback a partir da telemetria, um joystick virtual para jogos que só leem um dispositivo, um comando simulado (comando Xbox virtual) para jogos que só conhecem um comando Xbox, uma base de dados de cockpits, estatísticas do que voa.
  • Ajuda em cada botão. F1 explica qualquer botão, as visitas apontam para os botões reais, e Palavras fáceis mantém tudo curto.
  • Sem runtimes extra para procurar. A versão é um único zip com tudo lá dentro; sem SlimDX, sem runtimes de C++.
Avançado

#Função a função

Área JoyPro 1 JoyPro 2
Relações à mão, ids do DCS à mão, com pesquisa em todos os jogos, sinónimos, o catálogo de funções, sugestões com motivos, Agrupamento automático, agrupar por descrição, assistente; "mesmo id, significado diferente" por aeronave do DCS
Atribuições gravar um botão ou eixo gravar, seguir a entrada, atribuir na imagem do dispositivo, Atribuição automática para qualquer combinação de dispositivos, assistente de configuração, Distribuir com IA
Ajuste de eixos curvatura, zona morta e saturação do DCS por jogo no seu próprio modelo de resposta, âmbitos por aeronave, calibração, modo de retenção
Modificadores sim sim, com uma página de modificadores, combinações, tradução por jogo (BMS shift, ...)
Exportar DCS (limpar, limpeza total) todos os jogos; quatro modos mais "limpar também", por aeronave, diferença mínima face às predefinições do DCS, marcas para atribuições não escritas, backups e desfazer
Importar DCS todos os jogos, com predefinições, teclado, fusão de dispositivos, reimportação de nomes/grupos/modificadores
Segurança "faça você mesmo um backup" backups automáticos com versões, recusa escrever enquanto um jogo está a correr, histórico do perfil com desfazer entre sessões, sandbox de escrita nos testes
Verificações validar a Verificação: cartões com as palavras do jogo, correções com um clique, causa a partir do histórico
Layouts exportar imagens de layout imagens de referência dos dispositivos (modelo exato por VID:PID e nome HID), folhas de referência, vistas 3D dos dispositivos
Overlay overlay no jogo editor do HUD, overlay, página de stream para o OBS, entradas em direto
Lista de jogos base de dados incluída (html) criada no seu PC a partir da sua própria instalação, atualizada depois das atualizações dos jogos
Monitorização nenhum monitor de configurações dos jogos com programa na área de notificação, pergunta depois de o jogo fechar
Force feedback nenhum force feedback por telemetria para DCS, IL-2, War Thunder e outros (JoyPro.Ffb)
Dispositivos virtuais nenhum modo vJoy / comando Xbox com HidHide, funções virtuais, importação do Joystick Gremlin
Idiomas Inglês 39
Atualizações descarregar à mão verificação de atualizações com notas de versão, instalação com verificação de checksum
Relatórios de problemas perguntar no Discord um ficheiro de suporte com registos, configurações e (a pedido) o perfil; pasta do utilizador substituída; nada é enviado
Detalhes técnicos internos

#Arquitetura e qualidade

  • Dividido em motor e GUI. O JoyPro 1 era uma única aplicação WPF com a lógica no código da janela. O JoyPro 2 tem um motor (engine.exe, .NET Framework 4.8, C# simples) que contém toda a lógica de perfil, importação/exportação e base de dados em 451 comandos, e uma GUI Avalonia (.NET 9) que executa o motor para cada ação. Os comandos interativos rápidos vão para um único engine serve de longa duração, por isso a GUI mantém-se rápida sem abdicar da separação. Tudo o que a GUI faz pode ser automatizado com scripts (veja a linha de comandos do motor).
  • Processos separados para tarefas permanentes: JoyPro.Ffb.exe (force feedback por telemetria), JoyPro.VJoy.exe (o reencaminhador do joystick virtual), JoyPro.Tray.exe (o monitor enquanto a GUI está fechada), cada um com limites de recursos e testes de resistência, para que passem despercebidos em segundo plano.
  • Testes: 1,537 testes automáticos (xUnit: lógica do motor, view models, renderizações fora do ecrã das páginas em claro e escuro), 87 partes do teste de fumo do motor que executam o motor real sobre pastas de teste, uma verificação de qualidade opcional com verificações de invariantes em dados reais, e execuções de ponta a ponta dentro do jogo para os jogos que o permitem. Os testes correm numa sandbox de escrita com uma verificação da impressão digital das pastas reais, por isso nenhum teste pode tocar nas pastas reais dos jogos.
  • Dados: as listas de comandos dos jogos são criadas no PC do utilizador a partir do jogo instalado, em %LOCALAPPDATA%\JoyPro2\GameData; o JoyPro só inclui os seus próprios dados (catálogo de funções, catálogo de dispositivos, tabelas de conversão, base de dados de cockpits).
  • Documentação gerada a partir do código-fonte: a matriz de suporte dos jogos vem do código (engine games support), a referência da CLI de engine --help, e este site do AXAML, dos view models e da documentação.