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 |
| Комити (commits) | 336 | 1,406 |
| Линии C# код | 25,502 | 354,663 (13.9 x) |
| C# датотеки | 77 | 954 |
| Типови (класи, записи, енумерации ...) | 106 | 3,059 (29 x) |
| Методи | 450 | 16,702 (37 x) |
| Автоматски тестови (unit, view model, рендерирање) | 0 | 1,537 во 198 тест-датотеки |
| Делови од smoke тестот на моторот (вистинскиот мотор врз тест-папки) | 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 го објаснува секое копче, турите покажуваат на вистинските копчиња, а Едноставни зборови ги држи текстовите кратки.
- Без дополнителни runtime-библиотеки за барање. Изданието е еден zip со сè внатре; без SlimDX, без C++ runtime-библиотеки.
Напредно
#Функција по функција
| Област | JoyPro 1 | JoyPro 2 |
|---|---|---|
| Релации | рачно, DCS id | рачно, со пребарување низ секоја игра, синоними, каталогот на функции, предлози со причини, Авто групирање, групирање по опис, асистент; „ист id, различно значење“ по DCS летало |
| Доделби | снимање копче или оска | снимање, следење на влезот, доделување на сликата на уредот, Авто доделување за секоја комбинација на уреди, волшебник за поставување, Распореди со AI |
| Подесување на оските | DCS кривина, мртва зона, заситување | по игра во нејзиниот сопствен модел на одзив, опсези по летало, калибрација, режим на запирач |
| Модификатори | да | да, со страница за модификатори, комбинации, превод по игра (BMS shift, ...) |
| Извоз | DCS (clean, nuke) | секоја игра; четири режими плус „исчисти ги и моите други уреди“, по летало, минимална разлика до стандардните поставки на DCS, ознаки за доделби што не се запишани, резервни копии и поништување |
| Увези | DCS | секоја игра, со стандардни поставки, тастатура, спојување уреди, повторен увоз на имиња/групи/модификатори |
| Безбедност | „направете резервна копија сами“ | автоматски резервни копии со верзии, одбива да запишува додека играта работи, историја на профилот со поништување низ сесии, sandbox за запишување во тестовите |
| Проверки | 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 команди, и Avalonia GUI (.NET 9) што го извршува моторот за секоја акција. Брзите интерактивни команди одат до еденengine serveшто работи долго, па GUI останува брз без да се откаже од поделбата. Сè што прави GUI може да се скриптира (видете командната линија на моторот). - Посебни процеси за трајни задачи:
JoyPro.Ffb.exe(force feedback од телеметрија),JoyPro.VJoy.exe(препраќачот на виртуелниот joystick),JoyPro.Tray.exe(следењето додека GUI е затворен), секој со буџети за ресурси и тестови за издржливост, за да останат незабележливи во позадина. - Тестови: 1,537 автоматски тестови (xUnit: логика на моторот, модели на прикази, рендери на страниците надвор од екранот во светла и темна тема), 87 делови од smoke тестот на моторот што го извршуваат вистинскиот мотор врз тест-папки, опционална порта за квалитет со проверки на инваријанти врз вистински податоци, и end-to-end тестови во играта за игрите што го поддржуваат тоа. Тестовите работат во sandbox за запишување со проверка на отпечатокот на вистинските папки, па ниту еден тест не може да ги допре вистинските папки на игрите.
- Податоци: списоците со команди на игрите се градат на компјутерот на корисникот од инсталираната игра во
%LOCALAPPDATA%\JoyPro2\GameData; JoyPro ги испорачува само своите податоци (каталог на функции, каталог на уреди, табели за конверзија, база на податоци за кокпити). - Документација генерирана од изворниот код: матрицата за поддршка на игрите доаѓа од кодот (
engine games support), референцата за CLI одengine --help, а оваа страница од AXAML, моделите на прикази и документацијата.
#Поврзано
- Статус на викито: колку е комплетна оваа документација
- Поддршка за игри: секоја игра и што прави JoyPro за неа