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"]
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
#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++.
#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 |
#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 unicoengine servesempre 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 daengine --help, e questo sito dall'AXAML, dai view model e dalla documentazione.
#Vedi anche
- Stato del wiki: quanto è completa questa documentazione
- Supporto dei giochi: ogni gioco con cosa fa JoyPro per lui