JoyPro2 Discord GitHub
Progetto

Da JoyPro 1 a JoyPro 2

Mostra:

JoyPro 1 (dal 2021 al 2023) era uno strumento per DCS: creava relazioni tra gli input di velivoli diversi e li assegnava allo stesso punto della cloche. JoyPro 2 mantiene esattamente quell'idea e lo stesso modello relazione / assegnazione / modificatore (un profilo di JoyPro 1 si apre in JoyPro 2), e ricostruisce tutto intorno: una nuova interfaccia, un motore che funziona anche da solo, decine di giochi, test per ogni funzione e molta sicurezza.

#I numeri

Tutti i numeri sono misurati sul codice sorgente di entrambi i progetti (file tracciati in git; righe di codice = righe C# non vuote che non sono commenti). I numeri di JoyPro 2 provengono dalla build di questo sito.

JoyPro 1 JoyPro 2
Sviluppo dal 2021-02-11 al 2023-11-15 dal 2026-09-30
Commit 336 1,406
Righe di codice C# 25,502 354,663 (13.9 x)
File C# 77 954
Tipi (classi, record, enum ...) 106 3,059 (29 x)
Metodi 450 16,702 (37 x)
Test automatici (unità, view model, rendering) 0 1,537 in 198 file di test
Parti dello smoke test del motore (motore reale su cartelle di prova) 0 87
Progetti nella soluzione 2 12
Righe di markup dell'interfaccia 973 (WPF XAML) 17,250 (Avalonia AXAML)
Righe di documentazione (Markdown) 109 25,636
Giochi 1 (DCS), poi IL-2 36 gestiti da JoyPro, 57 titoli studiati
Lingue dell'interfaccia 1 39
Comandi del motore (riga di comando) nessuno (solo interfaccia grafica) 451 in 60 aree, 19 opzioni globali
Controlli dell'interfaccia documentati su questo sito 1097

Dove si trova il codice in JoyPro 2 (righe di codice C#): motore 187,202, interfaccia 80,286, test dell'interfaccia 56,600, force feedback 14,394.

flowchart LR
  W["Una sola finestra<br/>(schermata e logica<br/>insieme)"] --> D1["File di DCS"]
JoyPro 1: una sola finestra che faceva tutto, per DCS.
flowchart TB
  G["La finestra"] --> E["Il motore<br/>(esegue ogni azione)"]
  G --> F["Aiutante<br/>force feedback"]
  G --> V["Aiutante<br/>joystick virtuale"]
  T["Monitoraggio<br/>nell'area di notifica"] --> E
  E --> D2["36 giochi"]
  F ~~~ V
JoyPro 2: una finestra che passa ogni azione al motore, con aiutanti per il force feedback, il joystick virtuale e il monitoraggio.
Per principianti

#Cosa c'è di meglio per te

  • Molti giochi, un profilo. JoyPro 1 era per DCS. JoyPro 2 importa ed esporta 36 titoli di giochi: 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 altri. Una relazione contiene la stessa funzione in tutti questi giochi.
  • Parti da quello che hai. L'importazione legge le assegnazioni che hai già in ogni gioco; la configurazione al primo avvio trova da sola i tuoi giochi.
  • Niente si può rompere per sempre. Ogni esportazione fa prima un backup dei file del gioco, e Annulla ultima esportazione li rimette byte per byte. Ogni modifica in JoyPro viene salvata automaticamente e si può annullare, anche dopo un riavvio (cronologia del profilo).
  • Ti dice cosa andrebbe storto. La Verifica spiega i problemi con le parole del gioco e li corregge con un clic.
  • Si configura da solo. Configura tutto per me mette le funzioni importanti sulla tua cloche, sulla tua manetta e sulla tua pedaliera. Tu guardi l'elenco e premi Usa questi pulsanti e Scrivi nel mio gioco.
  • Meno clic. Suggerimenti, Raggruppamento automatico, Assegnazione automatica, la configurazione guidata e un assistente JoyPro creano relazioni e assegnazioni per te; un "tuo stile" appreso segue come hai fatto prima.
  • Si accorge delle modifiche. Quando cambi un'assegnazione dentro un gioco, JoyPro chiede dopo la chiusura del gioco se riprenderla nel tuo profilo.
  • La tua lingua. L'interfaccia parla 39 lingue.
  • Più che assegnazioni. Immagini dei dispositivi e schede riepilogo, un HUD e un overlay per lo streaming, force feedback dalla telemetria, un joystick virtuale per i giochi che leggono un solo dispositivo, un finto controller (pad Xbox virtuale) per i giochi che conoscono solo un controller Xbox, un database dei cockpit, statistiche su cosa piloti.
  • Aiuto su ogni pulsante. F1 spiega qualsiasi pulsante, i tour indicano i pulsanti veri, e Parole facili tiene i testi brevi.
  • Nessun runtime extra da cercare. La release è un solo zip con tutto dentro; niente SlimDX, niente runtime C++.
Avanzate

#Funzione per funzione

Ambito JoyPro 1 JoyPro 2
Relazioni a mano, id DCS a mano con ricerca in ogni gioco, sinonimi, il catalogo delle funzioni, suggerimenti con motivazioni, Raggruppamento automatico, raggruppa per descrizione, assistente; "stesso id, significato diverso" per ogni velivolo DCS
Assegnazioni registrare un pulsante o un asse registrare, Segui input, assegnare sull'immagine del dispositivo, Assegnazione automatica per qualsiasi combinazione di dispositivi, configurazione guidata, Disponi con l'AI
Regolazione degli assi curvatura DCS, zona morta, saturazione per ogni gioco nel suo modello di risposta, ambiti per velivolo, calibrazione, modalità tacca
Modificatori sì sì, con una pagina dei modificatori, combinazioni, traduzione per gioco (shift di BMS, ...)
Esporta DCS (clean, nuke) ogni gioco; quattro modalità più "cancella anche", per velivolo, differenza minima rispetto alle impostazioni predefinite di DCS, segni per le assegnazioni non scritte, backup e annulla
Importa DCS ogni gioco, con impostazioni predefinite, tastiera, unione dei dispositivi, reimportazione di nomi/gruppi/modificatori
Sicurezza "fatti un backup da solo" backup automatici con versioni, si rifiuta di scrivere mentre un gioco è in esecuzione, cronologia del profilo con annulla tra le sessioni, sandbox di scrittura nei test
Controlli validate la Verifica: schede con le parole del gioco, correzioni con un clic, causa trovata nella cronologia
Layout esportare immagini del layout immagini di riferimento dei dispositivi (modello esatto tramite VID:PID e nome HID), schede riepilogo, viste 3D dei dispositivi
Overlay overlay nel gioco designer dell'HUD, overlay, pagina stream per OBS, input in tempo reale
Elenco dei giochi database fornito (html) creato sul tuo PC dalla tua installazione, aggiornato dopo gli aggiornamenti dei giochi
Monitoraggio nessuno monitoraggio delle configurazioni dei giochi con programma nell'area di notifica, chiede dopo la chiusura del gioco
Force feedback nessuno force feedback dalla telemetria per DCS, IL-2, War Thunder e altri (JoyPro.Ffb)
Dispositivi virtuali nessuno modalità vJoy / pad Xbox con HidHide, funzioni virtuali, importazione da Joystick Gremlin
Lingue Inglese 39
Aggiornamenti download a mano controllo degli aggiornamenti con note di rilascio, installazione verificata tramite checksum
Segnalazioni di problemi chiedere su Discord un file di supporto con log, impostazioni e (su richiesta) il profilo; cartella utente sostituita; niente viene caricato online
Dettagli tecnici interni

#Architettura e qualità

  • Diviso in motore e interfaccia. JoyPro 1 era un'unica applicazione WPF con la logica nel codice della finestra. JoyPro 2 ha un motore (engine.exe, .NET Framework 4.8, C# semplice) che contiene tutta la logica di profilo, importazione/esportazione e database come 451 comandi, e un'interfaccia Avalonia (.NET 9) che esegue il motore per ogni azione. I comandi interattivi rapidi vanno a un unico engine serve sempre in esecuzione, così l'interfaccia resta veloce senza rinunciare alla separazione. Tutto ciò che fa l'interfaccia si può automatizzare con script (vedi la riga di comando del motore).
  • Processi separati per i compiti permanenti: JoyPro.Ffb.exe (force feedback dalla telemetria), JoyPro.VJoy.exe (l'inoltro del joystick virtuale), JoyPro.Tray.exe (il monitoraggio mentre l'interfaccia è chiusa), ognuno con limiti di risorse e test di durata, così in background restano impercettibili.
  • Test: 1,537 test automatici (xUnit: logica del motore, view model, rendering fuori schermo delle pagine in chiaro e scuro), 87 parti dello smoke test del motore che eseguono il motore reale su cartelle di prova, un controllo di qualità facoltativo con verifiche delle invarianti su dati reali, ed esecuzioni end-to-end nel gioco per i giochi che lo permettono. I test girano in una sandbox di scrittura con un controllo dell'impronta delle cartelle reali, così nessun test può toccare le vere cartelle dei giochi.
  • Dati: gli elenchi comandi dei giochi vengono creati sul PC dell'utente dal gioco installato in %LOCALAPPDATA%\JoyPro2\GameData; JoyPro fornisce solo i propri dati (catalogo delle funzioni, catalogo dei dispositivi, tabelle di conversione, database dei cockpit).
  • Documentazione generata dal codice sorgente: la tabella del supporto dei giochi viene dal codice (engine games support), il riferimento della CLI da engine --help, e questo sito dall'AXAML, dai view model e dalla documentazione.