JoyPro 1 (от 2021 до 2023 г.) беше инструмент за DCS: създаваше връзки между входовете на различни самолети и ги назначаваше на едно и също място на ръчката. JoyPro 2 запазва точно тази идея и същия модел връзка / назначение / модификатор (профил от JoyPro 1 се отваря в JoyPro 2) и изгражда наново всичко около нея: нов интерфейс, ядро, което работи и самостоятелно, десетки игри, тестове за всяка функция и много безопасност.
#Числата
Всички числа са измерени върху изходния код на двата проекта (файлове, следени в git; редове код = непразни редове на C#, които не са коментари). Числата на JoyPro 2 са от компилацията на този сайт.
| JoyPro 1 | JoyPro 2 | |
|---|---|---|
| Разработка | 2021-02-11 до 2023-11-15 | от 2026-09-30 |
| Комити | 336 | 1,406 |
| Редове код на C# | 25,502 | 354,663 (13.9 x) |
| C# файлове | 77 | 954 |
| Типове (класове, записи, изброявания ...) | 106 | 3,059 (29 x) |
| Методи | 450 | 16,702 (37 x) |
| Автоматизирани тестове (модулни, на модела на изгледа, на изобразяването) | 0 | 1,537 в 198 тестови файла |
| Части на бързия тест на ядрото (истинското ядро върху тестови папки) | 0 | 87 |
| Проекти в решението | 2 | 12 |
| Редове с описание на интерфейса | 973 (WPF XAML) | 17,250 (Avalonia AXAML) |
| Редове документация (Markdown) | 109 | 25,636 |
| Игри | 1 (DCS), по-късно IL-2 | 36 поддържани от JoyPro, 57 проучени заглавия |
| Езици на интерфейса | 1 | 39 |
| Команди на ядрото (команден ред) | няма (само графичен интерфейс) | 451 в 60 области, 19 глобални опции |
| Елементи на интерфейса, описани в този сайт | 1097 |
Къде се намира кодът в JoyPro 2 (редове C# код): ядро 187,202, графичен интерфейс 80,286, тестове на интерфейса 56,600, обратна сила 14,394.
flowchart LR W["Един прозорец<br/>(екран и логика<br/>в едно)"] --> D1["Файлове на DCS"]
flowchart TB G["Прозорецът"] --> E["Ядрото<br/>(изпълнява всяко действие)"] G --> F["Помощник за<br/>обратната сила"] G --> V["Помощник за<br/>виртуалния joystick"] T["Наблюдател<br/>в системната област"] --> E E --> D2["36 игри"] F ~~~ V
#Какво е по-добро за Вас
- Много игри, един профил. JoyPro 1 беше за DCS. JoyPro 2 импортира и експортира 36 игри: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 и 2024, X-Plane 11 и 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma и други. Една връзка съдържа една и съща функция във всички тях.
- Започнете от това, което имате. Импортирането прочита съществуващите Ви назначения от всяка игра; настройката при първото стартиране сама намира игрите Ви.
- Нищо не може да се развали завинаги. Всяко експортиране първо прави резервно копие на файловете на играта, а Отмяна на последното експортиране ги връща байт по байт. Всяка промяна в JoyPro се запазва автоматично и може да бъде отменена, дори след рестартиране (история на профила).
- Казва Ви какво би се объркало. Проверката обяснява проблемите с думите на играта и ги поправя с едно щракване.
- Настройва се сам. Настрой всичко вместо мен поставя важните функции на Вашата ръчка, газ и педали. Разглеждате списъка и натискате Използвай тези бутони и Запиши в моята игра.
- По-малко щракане. Предложенията, Авто групиране, Авто назначаване, съветникът за настройка и помощникът на JoyPro изграждат връзки и назначения вместо Вас; наученият „Ваш стил“ следва начина, по който сте го правили преди.
- Забелязва промените. Когато промените назначение в самата игра, JoyPro пита след затварянето на играта дали да го вземе в профила Ви.
- Вашият език. Интерфейсът говори 39 езика.
- Повече от назначения. Снимки на устройствата и бележници, HUD и наслагване за стрийм, обратна сила от телеметрията, виртуален joystick за игри, които четат само едно устройство, симулиран контролер (виртуален Xbox геймпад) за игри, които познават само Xbox контролер, база данни с кабини, статистика за това, с какво летите.
- Помощ за всеки бутон. F1 обяснява всеки бутон, обиколките сочат истинските бутони, а Прости думи поддържа текстовете кратки.
- Без допълнителни среди за изпълнение за търсене. Изданието е един zip архив с всичко вътре; без SlimDX, без C++ среди за изпълнение.
#Функция по функция
| Област | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Връзки | на ръка, DCS id | на ръка с търсене във всяка игра, синоними, каталога с функции, предложения с причини, Авто групиране, групиране по описание, асистент; „същото id, различно значение“ за всеки самолет в DCS |
| Назначения | записване на бутон или ос | записване, следване на входа, назначаване върху снимката на устройството, Авто назначаване за всяка комбинация от устройства, съветник за настройка, Подреди с AI |
| Настройка на осите | кривина, мъртва зона, насищане в DCS | за всяка игра в собствения ѝ модел на отклик, обхвати за всеки самолет, калибриране, режим с детент |
| Модификатори | да | да, със страница за модификатори, комбинации, превод за всяка игра (BMS shift, ...) |
| Експортиране | DCS (clean, nuke) | всяка игра; четири режима плюс „изчистване и на другите“, за всеки самолет, минимална разлика спрямо стойностите по подразбиране на DCS, отметки за назначения, които не са записани, резервни копия и отмяна |
| Импортиране | DCS | всяка игра, със стойности по подразбиране, клавиатура, сливане на устройства, повторно импортиране на имена/групи/модификатори |
| Безопасност | „направете си резервно копие сами“ | автоматични резервни копия с версии, отказва да записва, докато играта работи, история на профила с отмяна между сесиите, пясъчник за запис при тестовете |
| Проверки | validate | Проверката: карти с думите на играта, поправки с едно щракване, причина от историята |
| Оформления | експортиране на снимки на оформлението | референтни снимки на устройства (точен модел по VID:PID и HID име), бележници, 3D изгледи на устройства |
| Наслагване | наслагване в играта | HUD дизайнер, наслагване, страница за стрийм за OBS, входове на живо |
| Списък с игри | доставена база данни (html) | изгражда се на вашия компютър от собствената ви инсталация, опреснява се след актуализации на игрите |
| Следене | няма | наблюдател на конфигурациите на игрите с хост в системната област, пита след излизане от играта |
| Обратна сила | няма | обратна сила от телеметрията за DCS, IL-2, War Thunder и други (JoyPro.Ffb) |
| Виртуални устройства | няма | vJoy / режим Xbox геймпад с HidHide, виртуални функции, импортиране от Joystick Gremlin |
| Езици | Английски | 39 |
| Актуализации | изтегляне на ръка | проверка за актуализации с бележки към изданието, инсталиране с проверка на контролната сума |
| Доклади за проблеми | питайте в Discord | един файл за поддръжка с логове, настройки и (при поискване) профила; потребителската папка е заменена; нищо не се качва |
#Архитектура и качество
- Разделение на ядро и GUI. JoyPro 1 беше едно WPF приложение с логиката в кода на прозореца. JoyPro 2 има ядро (
engine.exe, .NET Framework 4.8, обикновен C#), което съдържа цялата логика за профила, импортирането/експортирането и базата данни като 451 команди, и Avalonia GUI (.NET 9), който стартира ядрото за всяко действие. Бързите интерактивни команди отиват към един дълго работещengine serve, така че GUI остава бърз, без да се отказва от разделението. Всичко, което прави GUI, може да се автоматизира със скрипт (вижте командния ред на ядрото). - Отделни процеси за постоянните задачи:
JoyPro.Ffb.exe(обратна сила от телеметрията),JoyPro.VJoy.exe(препращането към виртуалния joystick),JoyPro.Tray.exe(наблюдателят, докато GUI е затворен), всеки с ограничения на ресурсите и дълготрайни тестове, така че да остават незабележими във фонов режим. - Тестове: 1,537 автоматични теста (xUnit: логика на ядрото, модели на изгледи, рендерирания извън екрана на страниците в светла и тъмна тема), 87 части на димния тест на ядрото, които пускат истинското ядро срещу тестови папки, включваема по желание проверка на качеството с проверки на инварианти върху реални данни и тестове от край до край в играта за игрите, които го поддържат. Тестовете се изпълняват в пясъчник за запис с проверка на отпечатъка на реалните папки, така че никой тест да не може да докосне истинските папки на игрите.
- Данни: списъците с команди на игрите се изграждат на компютъра на потребителя от инсталираната игра в
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro доставя само собствените си данни (каталог с функции, каталог с устройства, таблици за преобразуване, база данни с кабини). - Документация, генерирана от изходния код: матрицата за поддръжка на игрите идва от кода (
engine games support), справочникът на командния ред отengine --help, а този сайт от AXAML, моделите на изгледи и документацията.
#Свързани
- Състояние на уикито: колко пълна е тази документация
- Поддръжка на игри: всяка игра с това, което JoyPro прави за нея