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 |
| Команди рушія (командний рядок) | немає (лише GUI) | 451 у 60 областях, 19 глобальних параметрів |
| Елементи керування GUI, описані на цьому сайті | 1097 |
Де живе код у JoyPro 2 (рядки коду C#): рушій 187,202, GUI 80,286, тести GUI 56,600, Force Feedback 14,394.
flowchart LR W["Одне вікно<br/>(екран і логіка<br/>разом)"] --> D1["Файли DCS"]
flowchart TB G["Вікно"] --> E["Рушій<br/>(виконує кожну дію)"] G --> F["Помічник<br/>Force Feedback"] 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 і оверлей для стриму, Force Feedback з телеметрії, віртуальний joystick для ігор, які читають лише один пристрій, удаваний контролер (віртуальний геймпад Xbox) для ігор, які знають лише контролер Xbox, база даних кабін, статистика того, на чому ви літаєте.
- Довідка до кожної кнопки. F1 пояснює будь-яку кнопку, тури вказують на справжні кнопки, а Прості слова роблять усе коротким.
- Не треба шукати додаткові середовища виконання. Випуск — це один zip з усім усередині; без SlimDX, без середовищ виконання C++.
Розширені
#Функція за функцією
| Область | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Зв'язки | вручну, id DCS | вручну з пошуком по всіх іграх, синоніми, каталог функцій, пропозиції з поясненнями, Автогрупування, групування за описом, помічник; «той самий id, інше значення» для кожного літака DCS |
| Прив'язки | записати кнопку або вісь | запис, стеження за введенням, прив'язка на зображенні пристрою, Автопризначення для будь-якої комбінації пристроїв, майстер налаштування, Розкласти з ШІ |
| Налаштування осей | кривизна DCS, мертва зона, насичення | для кожної гри у її власній моделі відгуку, області дії для кожного літака, калібрування, режим упору |
| Модифікатори | так | так, зі сторінкою модифікаторів, комбінаціями, перекладом для кожної гри (BMS shift, ...) |
| Експорт | DCS (clean, nuke) | кожна гра; чотири режими плюс «очистити й інші», для кожного літака, мінімальна різниця зі стандартними прив'язками DCS, позначки для незаписаних прив'язок, резервні копії та скасування |
| Імпорт | DCS | кожна гра, зі стандартними прив'язками, клавіатурою, об'єднанням пристроїв, повторним імпортом назв/груп/модифікаторів |
| Безпека | «зробіть резервну копію самі» | автоматичні резервні копії з версіями, відмова записувати, поки гра запущена, історія профілю зі скасуванням між сеансами, пісочниця для запису в тестах |
| Перевірки | validate | Перевірка: картки мовою гри, виправлення одним клацанням, причина з історії |
| Розкладки | експорт зображень розкладки | довідкові зображення пристроїв (точна модель за VID:PID і назвою HID), шпаргалки, 3D-види пристроїв |
| Оверлей | оверлей у грі | конструктор HUD, оверлей, сторінка трансляції для OBS, живі входи |
| Список ігор | вбудована база даних (html) | створюється на вашому ПК з вашої власної інсталяції, оновлюється після оновлень гри |
| Стеження | немає | стеження за конфігураціями гри з хостом в області сповіщень, питає після виходу з гри |
| Force Feedback | немає | Force Feedback на основі телеметрії для 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 команд, і GUI на Avalonia (.NET 9), який запускає рушій для кожної дії. Швидкі інтерактивні команди йдуть до одного довготривалогоengine serve, тож GUI лишається швидким, не відмовляючись від поділу. Усе, що робить GUI, можна автоматизувати скриптами (див. командний рядок рушія). - Окремі процеси для постійних завдань:
JoyPro.Ffb.exe(Force Feedback на основі телеметрії),JoyPro.VJoy.exe(ретранслятор віртуального joystick),JoyPro.Tray.exe(стеження, поки GUI закрито), кожен із бюджетом ресурсів і тривалими навантажувальними тестами, щоб у фоні їх не було помітно. - Тести: 1,537 автоматичних тестів (xUnit: логіка рушія, моделі представлення, позаекранні рендери сторінок у світлій і темній темі), 87 частин димового тесту рушія, які запускають справжній рушій на тестових папках, необов'язковий контроль якості з перевірками інваріантів на реальних даних, а також наскрізні прогони в самій грі для ігор, які це підтримують. Тести працюють у пісочниці для запису з перевіркою відбитка справжніх папок, тож жоден тест не може зачепити справжні папки ігор.
- Дані: списки команд ігор створюються на ПК користувача зі встановленої гри в
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro постачає лише власні дані (каталог функцій, каталог пристроїв, таблиці перетворення, базу даних кабін). - Документація генерується з вихідного коду: матриця підтримки ігор береться з коду (
engine games support), довідка CLI — зengine --help, а цей сайт — з AXAML, моделей представлення та документації.
#Пов'язане
- Стан вікі: наскільки повна ця документація
- Підтримка ігор: кожна гра і що JoyPro для неї робить