JoyPro 1 (od 2021 do 2023) był narzędziem do DCS: tworzył relacje między wejściami różnych maszyn i przypisywał je do tego samego miejsca na drążku. JoyPro 2 zachowuje dokładnie tę ideę i ten sam model relacja / przypisanie / modyfikator (profil JoyPro 1 otwiera się w JoyPro 2) i przebudowuje wszystko wokół niego: nowy interfejs, silnik, który działa też samodzielnie, dziesiątki gier, testy każdej funkcji i dużo bezpieczeństwa.
#Liczby
Wszystkie liczby zmierzono na kodzie źródłowym obu projektów (pliki śledzone w git; linie kodu = niepuste linie C#, które nie są komentarzami). Liczby JoyPro 2 pochodzą z kompilacji tej strony.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Rozwój | od 2021-02-11 do 2023-11-15 | od 2026-09-30 |
| Commity | 336 | 1,406 |
| Linie kodu C# | 25,502 | 354,663 (13.9 x) |
| Pliki C# | 77 | 954 |
| Typy (klasy, rekordy, wyliczenia ...) | 106 | 3,059 (29 x) |
| Metody | 450 | 16,702 (37 x) |
| Testy automatyczne (jednostkowe, modelu widoku, renderowania) | 0 | 1,537 w 198 plikach testowych |
| Części testu dymnego silnika (prawdziwy silnik na folderach testowych) | 0 | 87 |
| Projekty w rozwiązaniu | 2 | 12 |
| Linie znaczników interfejsu | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Linie dokumentacji (Markdown) | 109 | 25,636 |
| Gry | 1 (DCS), później IL-2 | 36 obsługiwanych przez JoyPro, 57 zbadanych tytułów |
| Języki interfejsu | 1 | 39 |
| Polecenia silnika (wiersz poleceń) | brak (tylko GUI) | 451 w 60 obszarach, 19 opcji globalnych |
| Elementy sterowania GUI opisane na tej stronie | 1097 |
Gdzie jest kod w JoyPro 2 (linie kodu C#): silnik 187,202, GUI 80,286, testy GUI 56,600, force feedback 14,394.
flowchart LR W["Jedno okno<br/>(ekran i logika<br/>w jednym)"] --> D1["Pliki DCS"]
flowchart TB G["Okno"] --> E["Silnik<br/>(wykonuje każdą akcję)"] G --> F["Pomocnik<br/>force feedback"] G --> V["Pomocnik<br/>wirtualnego joysticka"] T["Obserwator<br/>w zasobniku"] --> E E --> D2["36 gier"] F ~~~ V
Dla początkujących
#Co jest lepsze dla Ciebie
- Wiele gier, jeden profil. JoyPro 1 był dla DCS. JoyPro 2 importuje i eksportuje 36 tytułów gier: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 i 2024, X-Plane 11 i 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma i inne. Jedna relacja zawiera tę samą funkcję we wszystkich z nich.
- Zacznij od tego, co masz. Import odczytuje Twoje istniejące przypisania z każdej gry; konfiguracja przy pierwszym uruchomieniu sama znajduje Twoje gry.
- Nic nie zepsuje się na dobre. Każdy eksport najpierw robi kopię zapasową plików gry, a Cofnij ostatni eksport przywraca je bajt po bajcie. Każda zmiana w JoyPro jest zapisywana automatycznie i można ją cofnąć, nawet po ponownym uruchomieniu (historia profilu).
- Mówi, co poszłoby nie tak. Sprawdzanie objaśnia problemy słowami gry i naprawia je jednym kliknięciem.
- Konfiguruje się sam. Ustaw wszystko za mnie umieszcza ważne funkcje na Twoim drążku, przepustnicy i pedałach. Patrzysz na listę i naciskasz Użyj tych przycisków oraz Zapisz w mojej grze.
- Mniej klikania. Sugestie, Autogrupowanie, Autoprzypisanie, kreator konfiguracji i asystent JoyPro tworzą za Ciebie relacje i przypisania; wyuczony „Twój styl” podąża za Twoimi wcześniejszymi wyborami.
- Zauważa zmiany. Gdy zmienisz przypisanie w grze, JoyPro po zamknięciu gry zapyta, czy przejąć to do Twojego profilu.
- Twój język. Interfejs mówi w 39 językach.
- Więcej niż przypisania. Obrazy urządzeń i ściągi, HUD i nakładka do streamu, force feedback z telemetrii, wirtualny joystick dla gier, które czytają tylko jedno urządzenie, udawany kontroler (wirtualny pad Xbox) dla gier, które znają tylko kontroler Xbox, baza kokpitów, statystyki tego, czym latasz.
- Pomoc przy każdym przycisku. F1 objaśnia każdy przycisk, przewodniki wskazują prawdziwe przyciski, a Proste słowa skracają teksty.
- Bez szukania dodatkowych środowisk uruchomieniowych. Wydanie to jeden plik zip ze wszystkim w środku; bez SlimDX, bez środowisk uruchomieniowych C++.
Zaawansowane
#Funkcja po funkcji
| Obszar | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Relacje | ręcznie, identyfikatory DCS | ręcznie z wyszukiwaniem we wszystkich grach, synonimy, katalog funkcji, sugestie z uzasadnieniem, Autogrupowanie, grupowanie po opisie, asystent; „ten sam identyfikator, inne znaczenie” dla każdej maszyny DCS |
| Przypisania | nagranie przycisku lub osi | nagrywanie, podążanie za wejściem, przypisywanie na obrazie urządzenia, Autoprzypisanie dla dowolnego zestawu urządzeń, kreator konfiguracji, Rozmieść z AI |
| Strojenie osi | krzywizna, martwa strefa, nasycenie w DCS | dla każdej gry w jej własnym modelu reakcji, zakresy dla poszczególnych maszyn, kalibracja, tryb zapadek (detent) |
| Modyfikatory | tak | tak, ze stroną modyfikatorów, kombinacjami, tłumaczeniem dla każdej gry (shift w BMS, ...) |
| Eksportuj | DCS (clean, nuke) | każda gra; cztery tryby plus „wyczyść też”, dla każdej maszyny, minimalna różnica względem domyślnych ustawień DCS, oznaczenia niezapisanych przypisań, kopie zapasowe i cofanie |
| Importuj | DCS | każda gra, z ustawieniami domyślnymi, klawiaturą, scalaniem urządzeń, ponownym importem nazw/grup/modyfikatorów |
| Bezpieczeństwo | „zrób sobie kopię zapasową” | automatyczne kopie zapasowe z wersjami, odmowa zapisu, gdy gra działa, historia profilu z cofaniem między sesjami, piaskownica zapisu w testach |
| Sprawdzanie | walidacja | sprawdzanie: karty językiem gry, poprawki jednym kliknięciem, przyczyna z historii |
| Układy | eksport obrazów układu | obrazy referencyjne urządzeń (dokładny model po VID:PID i nazwie HID), ściągi, widoki 3D urządzeń |
| Nakładka | nakładka w grze | projektant HUD, nakładka, strona do streamu dla OBS, wejścia na żywo |
| Lista gier | dołączona baza danych (html) | budowana na Twoim PC z Twojej instalacji, odświeżana po aktualizacjach gry |
| Obserwowanie | brak | obserwator konfiguracji gier z programem w zasobniku, pyta po zamknięciu gry |
| Force feedback | brak | force feedback z telemetrii dla DCS, IL-2, War Thunder i innych (JoyPro.Ffb) |
| Urządzenia wirtualne | brak | tryb vJoy / pada Xbox z HidHide, funkcje wirtualne, import z Joystick Gremlin |
| Języki | angielski | 39 |
| Aktualizacje | ręczne pobieranie | sprawdzanie aktualizacji z informacjami o wydaniu, instalacja ze sprawdzeniem sumy kontrolnej |
| Raporty problemów | pytanie na Discordzie | jeden plik wsparcia z logami, ustawieniami i (na życzenie) profilem; folder użytkownika zamieniony; nic nie jest wysyłane |
Szczegóły techniczne
#Architektura i jakość
- Podział na silnik i GUI. JoyPro 1 było jedną aplikacją WPF z logiką w kodzie okna. JoyPro 2 ma silnik (
engine.exe, .NET Framework 4.8, czysty C#), który zawiera całą logikę profili, importu/eksportu i bazy danych jako 451 poleceń, oraz GUI w Avalonia (.NET 9), które uruchamia silnik przy każdej akcji. Szybkie polecenia interaktywne trafiają do jednego, stale działającegoengine serve, więc GUI pozostaje szybkie bez rezygnacji z podziału. Wszystko, co robi GUI, można zautomatyzować skryptem (zobacz wiersz poleceń silnika). - Osobne procesy do stałych zadań:
JoyPro.Ffb.exe(force feedback z telemetrii),JoyPro.VJoy.exe(przekaźnik wirtualnego joysticka),JoyPro.Tray.exe(obserwator, gdy GUI jest zamknięte), każdy z limitami zasobów i testami długotrwałymi, aby w tle pozostawały niezauważalne. - Testy: 1,537 testów automatycznych (xUnit: logika silnika, modele widoków, renderowanie stron poza ekranem w trybie jasnym i ciemnym), 87 części testu dymnego silnika, które uruchamiają prawdziwy silnik na folderach testowych, opcjonalna bramka jakości ze sprawdzaniem niezmienników na prawdziwych danych oraz testy end-to-end w grze dla gier, które na to pozwalają. Testy działają w piaskownicy zapisu ze sprawdzaniem odcisku prawdziwych folderów, więc żaden test nie może dotknąć prawdziwych folderów gier.
- Dane: listy poleceń gier są budowane na PC użytkownika z zainstalowanej gry do
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro dostarcza tylko własne dane (katalog funkcji, katalog urządzeń, tabele konwersji, bazę danych kokpitów). - Dokumentacja generowana ze źródeł: tabela obsługi gier pochodzi z kodu (
engine games support), opis CLI zengine --help, a ta strona z AXAML, modeli widoków i dokumentacji.
#Powiązane
- Stan wiki: na ile ta dokumentacja jest kompletna
- Obsługa gier: każda gra i to, co JoyPro dla niej robi