JoyPro2 Discord GitHub
專案

從 JoyPro 1 到 JoyPro 2

顯示:

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 倍)
C# 檔案 77 954
型別(類別、記錄、列舉……) 106 3,059(29 倍)
方法 450 16,702(37 倍)
自動化測試(單元、檢視模型、算繪) 0 1,537 項,分布在 198 個測試檔案中
引擎冒煙測試部分(真實引擎搭配測試資料夾) 0 87
方案中的專案 2 12
介面標記行數 973(WPF XAML) 17,250(Avalonia AXAML)
文件行數(Markdown) 109 25,636
遊戲 1 款(DCS),後來加上 IL-2 JoyPro 支援 36 款,研究過 57 款
介面語言 1 39
引擎指令(命令列) 無(僅 GUI) 451 個,分為 60 個領域,19 個全域選項
本網站記載的 GUI 控制項 1097

JoyPro 2 的程式碼分布(C# 程式碼行數):引擎 187,202、GUI 80,286、GUI 測試 56,600、力回饋 14,394。

flowchart LR
  W["一個視窗<br/>(畫面和邏輯<br/>合而為一)"] --> D1["DCS 檔案"]
JoyPro 1:一個視窗包辦一切,用於 DCS。
flowchart TB
  G["視窗"] --> E["引擎<br/>(執行每個動作)"]
  G --> F["力回饋<br/>輔助程式"]
  G --> V["虛擬 joystick<br/>輔助程式"]
  T["系統匣中的<br/>監看程式"] --> E
  E --> D2["36 款遊戲"]
  F ~~~ V
JoyPro 2:視窗把每個動作交給引擎,另有力回饋、虛擬搖桿和監看程式的輔助程式。
給新手

#對您更好的地方

  • 多款遊戲,一個設定檔。 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 手動搜尋所有遊戲、同義詞、功能目錄、附理由的建議、自動群組、依說明分組、助理;每架 DCS 飛機的「相同 ID,不同意義」
綁定 錄製按鈕或軸 錄製、跟隨輸入、在裝置圖片上綁定、任何裝置組合的自動指派、設定精靈、用 AI 配置
軸調校 DCS 曲率、死區、飽和度 每個遊戲用自己的回應模型,依飛機設定範圍、校準、段位模式
修飾鍵 是 有,附修飾鍵頁面、組合、依遊戲轉換(BMS shift 等)
匯出 DCS(清理、全部清除) 所有遊戲;四種模式加上「同時清除」、依飛機、與 DCS 預設值的最小差異、標示未寫入的綁定、備份與復原
匯入 DCS 所有遊戲,含預設值、鍵盤、裝置合併、重新匯入名稱/群組/修飾鍵
安全 「請自己備份」 自動版本化備份、遊戲執行中時拒絕寫入、可跨工作階段復原的設定檔歷程記錄、測試中的寫入沙箱
檢查 驗證 檢查:以遊戲用語呈現的卡片、一鍵修正、從歷程記錄找出原因
配置圖 匯出配置圖圖片 裝置參考圖片(依 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),CLI 參考來自 engine --help,而本網站則來自 AXAML、檢視模型和文件。