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"]
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
#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++.
#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 |
#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 únicoengine servede 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 deengine --help, e este site do AXAML, dos view models e da documentação.
#Relacionado
- Estado da wiki: quão completa está esta documentação
- Suporte de jogos: cada jogo com o que o JoyPro faz por ele