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/>виртуального джойстика"] 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 из телеметрии, виртуальный джойстик для игр, которые читают только одно устройство, имитация контроллера (виртуальный геймпад 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 | один файл поддержки с журналами, настройками и (по запросу) профилем; папка пользователя заменена; ничего не загружается |
Технические подробности
#Архитектура и качество
- Разделение на движок и интерфейс. JoyPro 1 был одним WPF-приложением с логикой в коде окна. У JoyPro 2 есть движок (
engine.exe, .NET Framework 4.8, чистый C#), который содержит всю логику профиля, импорта/экспорта и базы данных в виде 451 команд, и интерфейс на Avalonia (.NET 9), который запускает движок для каждого действия. Быстрые интерактивные команды идут в один постоянно работающийengine serve, поэтому интерфейс остаётся быстрым, не отказываясь от разделения. Всё, что делает интерфейс, можно выполнить скриптом (см. командную строку движка). - Отдельные процессы для постоянных задач:
JoyPro.Ffb.exe(Force Feedback по телеметрии),JoyPro.VJoy.exe(передача на виртуальный джойстик),JoyPro.Tray.exe(отслеживание, пока интерфейс закрыт), каждый с бюджетом ресурсов и длительными тестами нагрузки, чтобы в фоне они оставались незаметными. - Тесты: 1,537 автоматических тестов (xUnit: логика движка, модели представлений, внеэкранная отрисовка страниц в светлой и тёмной теме), 87 частей дымового теста движка, которые запускают настоящий движок на тестовых папках, необязательный контроль качества с проверками инвариантов на реальных данных и сквозные прогоны в игре для игр, которые это поддерживают. Тесты работают в песочнице записи с проверкой отпечатка реальных папок, поэтому ни один тест не может затронуть настоящие папки игр.
- Данные: списки команд игр строятся на ПК пользователя из установленной игры в
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro поставляет только свои собственные данные (каталог функций, каталог устройств, таблицы преобразования, база данных кабин). - Документация создаётся из исходного кода: таблица поддержки игр берётся из кода (
engine games support), справка по командной строке — изengine --help, а этот сайт — из AXAML, моделей представлений и документации.
#См. также
- Состояние вики: насколько полна эта документация
- Поддержка игр: каждая игра и что JoyPro для неё делает