JoyPro 1 (2021 až 2023) bol nástroj pre DCS: vytváral vzťahy medzi vstupmi rôznych lietadiel a priraďoval ich na rovnaké miesto na páke. JoyPro 2 zachováva presne túto myšlienku a rovnaký model vzťah / väzba / modifikátor (profil z JoyPro 1 sa otvorí v JoyPro 2) a všetko okolo neho stavia nanovo: nové rozhranie, nástroj, ktorý beží aj samostatne, desiatky hier, testy pre každú funkciu a veľa bezpečnosti.
#Čísla
Všetky čísla sú merané na zdrojovom kóde oboch projektov (súbory sledované v git; riadky kódu = neprázdne riadky C#, ktoré nie sú komentáre). Čísla JoyPro 2 pochádzajú zo zostavenia tejto stránky.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Vývoj | 2021-02-11 až 2023-11-15 | od 2026-09-30 |
| Commity | 336 | 1,406 |
| Riadky kódu C# | 25,502 | 354,663 (13.9 x) |
| Súbory C# | 77 | 954 |
| Typy (triedy, záznamy, enumerácie ...) | 106 | 3,059 (29 x) |
| Metódy | 450 | 16,702 (37 x) |
| Automatické testy (unit, view model, vykresľovanie) | 0 | 1,537 v 198 testovacích súboroch |
| Časti smoke testu nástroja (skutočný nástroj na testovacích priečinkoch) | 0 | 87 |
| Projekty v riešení (solution) | 2 | 12 |
| Riadky značiek rozhrania | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Riadky dokumentácie (Markdown) | 109 | 25,636 |
| Hry | 1 (DCS), neskôr IL-2 | 36 podporovaných v JoyPro, 57 preskúmaných titulov |
| Jazyky rozhrania | 1 | 39 |
| Príkazy nástroja (príkazový riadok) | žiadne (len GUI) | 451 v 60 oblastiach, 19 globálnych možností |
| Ovládacie prvky GUI zdokumentované na tejto stránke | 1097 |
Kde v JoyPro 2 žije kód (riadky kódu C#): nástroj 187,202, GUI 80,286, testy GUI 56,600, Force Feedback 14,394.
flowchart LR W["Jedno okno<br/>(obrazovka a logika<br/>v jednom)"] --> D1["Súbory DCS"]
flowchart TB G["Okno"] --> E["Nástroj<br/>(vykonáva každú akciu)"] G --> F["Pomocník pre<br/>Force Feedback"] G --> V["Pomocník pre<br/>virtuálny joystick"] T["Sledovanie<br/>v oznamovacej oblasti"] --> E E --> D2["36 hier"] F ~~~ V
Pre začiatočníkov
#Čo je pre vás lepšie
- Veľa hier, jeden profil. JoyPro 1 bol pre DCS. JoyPro 2 importuje a exportuje 36 herných titulov: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 a 2024, X-Plane 11 a 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma a ďalšie. Jeden vzťah obsahuje rovnakú funkciu vo všetkých z nich.
- Začnite z toho, čo máte. Import načíta vaše existujúce väzby z každej hry; nastavenie pri prvom spustení nájde vaše hry samo.
- Nič sa nemôže pokaziť natrvalo. Každý export najprv zálohuje súbory hry a Vrátiť posledný export ich vráti bajt po bajte. Každá zmena v JoyPro sa ukladá automaticky a dá sa vrátiť späť, aj po reštarte (história profilu).
- Povie vám, čo by sa pokazilo. Kontrola vysvetlí problémy slovami hry a opraví ich jedným kliknutím.
- Nastaví sa samo. Nastaviť všetko za mňa dá dôležité funkcie na vašu páku, plyn a pedále. Pozriete si zoznam a stlačíte Použiť tieto tlačidlá a Zapísať do mojej hry.
- Menej klikania. Návrhy, Automatické zoskupenie, Automatické priradenie, sprievodca nastavením a asistent JoyPro vytvárajú vzťahy a väzby za vás; naučený „váš štýl“ sa riadi tým, ako ste to robili predtým.
- Všimne si zmeny. Keď niečo v hre priradíte inak, JoyPro sa po zatvorení hry opýta, či to má prevziať do vášho profilu.
- Váš jazyk. Rozhranie hovorí 39 jazykmi.
- Viac než väzby. Obrázky zariadení a ťaháky, HUD a prekrytie pre stream, Force Feedback z telemetrie, virtuálny joystick pre hry, ktoré čítajú iba jedno zariadenie, napodobený gamepad (virtuálny gamepad Xbox) pre hry, ktoré poznajú iba gamepad Xbox, databáza kokpitov, štatistiky toho, na čom lietate.
- Pomoc pri každom tlačidle. F1 vysvetlí každé tlačidlo, prehliadky ukazujú na skutočné tlačidlá a Jednoduché slová to držia stručné.
- Žiadne ďalšie runtime knižnice na zháňanie. Vydanie je jeden zip so všetkým vnútri; žiadne SlimDX, žiadne runtime knižnice C++.
Pokročilé
#Funkcia po funkcii
| Oblasť | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Vzťahy | ručne, ID z DCS | ručne s vyhľadávaním vo všetkých hrách, synonymá, katalóg funkcií, návrhy s dôvodmi, Automatické zoskupenie, zoskupenie podľa popisu, asistent; "rovnaké ID, iný význam" pre každé lietadlo DCS |
| Väzby | zachytiť tlačidlo alebo os | zachytiť, sledovať vstup, priradiť na obrázku zariadenia, Automatické priradenie pre ľubovoľnú kombináciu zariadení, sprievodca nastavením, Rozložiť pomocou AI |
| Ladenie osí | zakrivenie, mŕtva zóna, saturácia v DCS | pre každú hru v jej vlastnom modeli odozvy, rozsahy pre jednotlivé lietadlá, kalibrácia, režim zarážky |
| Modifikátory | áno | áno, so stránkou modifikátorov, kombináciami, prekladom pre každú hru (BMS shift, ...) |
| Export | DCS (clean, nuke) | každá hra; štyri režimy plus "vymazať aj", pre jednotlivé lietadlá, minimálny rozdiel voči predvoleným nastaveniam DCS, označenia nezapísaných väzieb, zálohy a vrátenie späť |
| Importovať | DCS | každá hra, s predvolenými nastaveniami, klávesnicou, zlúčením zariadení, opätovným importom názvov/skupín/modifikátorov |
| Bezpečnosť | "urobte si zálohu sami" | automatické zálohy s verziami, odmietne zapisovať, kým hra beží, história profilu so späť aj medzi reláciami, izolované zápisy (sandbox) v testoch |
| Kontroly | validácia | kontrola: karty slovami hry, opravy jedným kliknutím, príčina z histórie |
| Rozloženia | export obrázkov rozloženia | referenčné obrázky zariadení (presný model podľa VID:PID a názvu HID), ťaháky, 3D pohľady na zariadenia |
| Prekrytie | prekrytie v hre | Návrhár HUD, prekrytie, stránka streamu pre OBS, živé vstupy |
| Zoznam hier | dodávaná databáza (html) | zostavený na vašom PC z vašej vlastnej inštalácie, obnovený po aktualizáciách hry |
| Sledovanie | žiadne | sledovanie konfigurácie hier s programom v oznamovacej oblasti, opýta sa po ukončení hry |
| Force feedback | žiadne | Force Feedback z telemetrie pre DCS, IL-2, War Thunder a ďalšie (JoyPro.Ffb) |
| Virtuálne zariadenia | žiadne | režim vJoy / gamepad Xbox s HidHide, virtuálne funkcie, import z Joystick Gremlin |
| Jazyky | angličtina | 39 |
| Aktualizácie | stiahnuť ručne | kontrola aktualizácií s poznámkami k vydaniu, inštalácia overená kontrolným súčtom |
| Hlásenia problémov | opýtať sa na Discorde | jeden súbor pre podporu s protokolmi, nastaveniami a (na požiadanie) profilom; používateľský priečinok nahradený; nič sa neodosiela |
Technické podrobnosti
#Architektúra a kvalita
- Rozdelené na nástroj a GUI. JoyPro 1 bola jedna aplikácia WPF s logikou v kóde okna. JoyPro 2 má nástroj (
engine.exe, .NET Framework 4.8, čisté C#), ktorý obsahuje celú logiku profilu, importu/exportu a databázy ako 451 príkazov, a GUI v Avalonia (.NET 9), ktoré pre každú akciu spúšťa nástroj. Rýchle interaktívne príkazy idú do jedného dlho bežiacehoengine serve, takže GUI zostáva rýchle bez toho, aby sa vzdalo oddelenia. Všetko, čo robí GUI, sa dá skriptovať (pozrite príkazový riadok nástroja). - Samostatné procesy pre trvalé úlohy:
JoyPro.Ffb.exe(Force Feedback z telemetrie),JoyPro.VJoy.exe(preposielanie do virtuálneho joysticku),JoyPro.Tray.exe(sledovanie, keď je GUI zatvorené), každý s limitmi prostriedkov a dlhodobými záťažovými testami, aby na pozadí zostali nepostrehnuteľné. - Testy: 1,537 automatických testov (xUnit: logika nástroja, view modely, vykreslenia stránok mimo obrazovky vo svetlom aj tmavom režime), 87 častí smoke testu nástroja, ktoré spúšťajú skutočný nástroj nad testovacími priečinkami, voliteľná kontrolná brána s kontrolami invariantov na skutočných dátach a celkové behy priamo v hre pre hry, ktoré to podporujú. Testy bežia v izolovanom zápisovom prostredí (sandbox) s kontrolou odtlačku skutočných priečinkov, takže žiadny test sa nemôže dotknúť skutočných priečinkov hier.
- Dáta: zoznamy príkazov hier sa zostavujú na PC používateľa z nainštalovanej hry do
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro dodáva iba vlastné dáta (katalóg funkcií, katalóg zariadení, prevodové tabuľky, databázu kokpitov). - Dokumentácia generovaná zo zdrojového kódu: matica podpory hier pochádza z kódu (
engine games support), referencia CLI zengine --helpa tento web z AXAML, view modelov a dokumentácie.
#Súvisiace
- Stav wiki: nakoľko je táto dokumentácia úplná
- Podpora hier: každá hra s tým, čo pre ňu JoyPro robí