G-Rebels 是一款以 Unreal Engine 5 打造的賽博龐克飛行戰鬥遊戲:您駕駛 VTOL 飛越巨型城市。遊戲會把您開啟的每支搖桿放到一個 頻道(0 到 5)上,並在兩個存檔中依頻道保存每個軸的角色(俯仰、滾轉、偏航、推力、平移、上升 / 下降)和按鈕綁定。JoyPro 會把這些角色和綁定讀入您的設定檔並寫回;鍵盤、遊戲手把和滑鼠則維持遊戲原本的設定。
G-Rebels 原生(使用自己的綁定檔案)
- 支援
- 原生(使用自己的綁定檔案)
- 引擎指令
engine grebels- 綁定檔案
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav(GVAS,就地修改軸的角色)+EnhancedInputUserSettings.sav(按鈕)- 遊戲讀取的輸入
- 每支 joystick 讀取 96 個按鈕、24 個軸,不讀取帽子開關(有文件說明)
- 指令清單來源
- JoyPro 自己的表(軸的角色、按鈕)
- 遊戲內測試
- 通過 18/18 個步驟(2026-10-11)
- ✓ 匯入
- ✓ 匯出
- ✗ 鍵盤綁定
- ✗ 修飾鍵
- ✓ 在您的電腦上建立指令清單
- ✓ 遊戲監看
- ✗ 軸曲線與死區G-Rebels:僅支援反轉。
- ✗ 遊戲操作設定
- ✗ 遊戲內力回饋設定
- ✗ 由遙測資料產生力回饋
- ✗ 遙測錄製
- ✓ 虛擬 joystick(vJoy)
- ◐ 虛擬 Xbox 手把
- ✓ 虛擬功能
- ◐ 設定精靈 / 自動指派
- ✗ 座艙
- ✓ 速查表
- ✓ 遊戲內測試
摘自支援矩陣(由引擎程式碼產生): 所有遊戲.
#3 個步驟就能用
- 全部幫我設定好
在「開始」頁面 - 使用這些按鈕
先查看清單 - 寫入我的遊戲
保持 G-Rebels 關閉
事前準備,在遊戲中為每個裝置各做一次:在 OPTIONS > INPUT > DEVICES 下為它指定頻道。在它的 JST 頁籤上變更一個軸角色。綁定一個按鈕。(詳情如下。)
接著:您的綁定會顯示在裝置的 JST 頁籤上。
您之前在 G-Rebels 中綁定過按鈕嗎?那麼「開始」頁面會提供 匯入,然後填補空缺。您的綁定會保留,只有空閒的按鈕會被指派新功能。請參閱 快速入門:讓我的搖桿能用。
#JoyPro 為 G-Rebels 做了什麼
- 匯入:每個頻道的軸角色(哪個搖桿軸是俯仰、滾轉、偏航、推力、側向平移、上升 / 下降)連同反向設定,以及 JoyPro 認得的按鈕綁定,都會以您的實體裝置進入您的設定檔。
- 關聯:G-Rebels 中的「Pitch」可以和您其他遊戲中的俯仰是同一個關聯。
- 匯出:JoyPro 會在您裝置的頻道上設定軸角色和按鈕綁定。它永遠不會新增頻道或裝置:這部分您要在遊戲中自己做一次。
#匯入您的 G-Rebels 綁定
- 開啟 開始 頁面。如果 G-Rebels 卡片要求指令清單,請按 建立清單:JoyPro 會寫入自己的遊戲軸角色和按鈕表。
- 在 G-Rebels 卡片上按 匯入,保留 加入我的設定檔(建議),然後按 立即匯入。
- 查看我的關聯 會開啟匯入的內容。


#建立並檢查關聯
在 關聯 頁面將您的關聯綁定到 G-Rebels 動作(請參閱 關聯流程),然後在「匯出」頁面執行 檢查。G-Rebels 每個軸只允許一個角色,每個動作和頻道只允許一個按鈕;檢查功能會顯示哪裡有兩個關聯想用同一個輸入。
#匯出到 G-Rebels
- 關閉 G-Rebels。 遊戲執行期間 JoyPro 會拒絕寫入。
- 開啟 匯出,並勾選 G-Rebels 卡片。
- 如果您是用 JoyPro 設定搖桿,請保留 取代我的裝置上的綁定 和 同時清除我的其他裝置。然後在卡片上按 立即匯出。


開啟 OPTIONS > INPUT > CONTROLS 以及您裝置的 JST<channel> 頁籤(頻道 0 為 JST0)。在 AXIS 下,每個搖桿軸(X、Y、Z、RX、RY、RZ、Slider、Dial)會顯示 JoyPro 設定的角色(YAW、THRUST、ROLL、PITCH、SIDE STRAFE、UP / DOWN 或 NONE)。在 BUTTONS 下,已綁定的動作會顯示您的按鈕,例如「Enhanced Raw Input Controller 0 Button 5」。
#您在 G-Rebels 中需要自己做的事
在第一次匯出前,每個裝置各做一次:
- 開啟裝置:OPTIONS > INPUT > DEVICES 會列出每支搖桿,並標示 DEACTIVATED。為您要使用的每個裝置指定一個頻道(0 - CHANNEL ... 5 - CHANNEL)。沒有頻道的裝置會在匯出時被略過,並顯示「請在 OPTIONS > INPUT > DEVICES 中開啟它」。
- 在裝置的 JST 頁籤上 變更一個軸角色。遊戲要到這時才會儲存該頻道的軸設定列;JoyPro 只會直接修改這些列,永遠不會新增。只開啟頁籤不會儲存任何內容。
- 在遊戲中 綁定一個按鈕 一次。按鈕檔案會在第一次綁定時出現。
#常見問題
- 軸角色沒有被寫入:該頻道還沒有已儲存的軸設定列。請在遊戲中該頻道的 JST 頁籤上變更一個軸角色,關閉遊戲,然後重新匯出。
- 缺少一個按鈕綁定:目前在遊戲的按鈕中只確認了 Primary Fire;其他動作會在得知名稱後陸續加入。
- 多個 Raw Input 裝置共用按鍵:使用 虛擬 Joystick 把整套 HOTAS 放到一個裝置上;這樣就只需要一個頻道。
#JoyPro 讀取和寫入的檔案
| 檔案 | 這是什麼 |
|---|---|
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\SaveOptions.sav |
裝置及其頻道(依 HID 路徑),以及每個頻道每個軸的一列軸設定:角色、反向、死區、倍數 |
%LOCALAPPDATA%\G_Rebels\Saved\SaveGames\EnhancedInputUserSettings.sav |
按鈕綁定,每個動作和頻道一個對應 |
...\SaveOptions.sav.joypro-meta.json |
JoyPro 保存的已匯出綁定資料(名稱、群組),下次匯入時會讀回 |
兩個存檔在首次寫入前都會備份(旁邊的 .jpbak 和 JoyPro 的備份庫)。
#G-Rebels 的匯出模式
每個軸一個角色,每個動作和頻道一個按鍵。軸角色和按鈕適用相同的規則。
| 模式 | 會發生什麼 |
|---|---|
| 僅新增 | 角色只會放到尚未有角色的軸上;已有其他角色的軸會被略過,並標示為「未寫入遊戲」。 |
| 更新,保留遊戲的綁定 | 設定檔的角色會放到其軸上(原本在那裡的角色會移除);該角色在其他軸上保留。按鈕:該按鍵上其他動作的對應會移除。 |
| 更新,以我的設定檔為準 | 同上,而且該角色在已連接頻道上的其他軸會設為 NONE。 |
| 取代我的裝置上的綁定 | 已寫入頻道上的其他所有角色都會變成 NONE。 |
| + 同時清除我的其他裝置 | JoyPro 不寫入的已啟用、已連接頻道也一樣。 |
#永遠不會變更的內容
- 鍵盤、遊戲手把、滑鼠和遊戲的其他選項。
- 裝置未連接的頻道會保留它的角色。
- 匯入時忽略的裝置,以及 JoyPro 轉送輸入的 vJoy 裝置。
- 遊戲的裝置清單:JoyPro 永遠不會開啟或關閉裝置,也不會新增頻道。
#軸與其他設定
#G-Rebels 整合的內部運作
flowchart LR D["G-Rebels:DEVICES<br/>裝置在頻道 0-5"] --> S P["您的設定檔<br/>(關聯 + 綁定)"] --> E["engine grebels export"] E --> S["SaveOptions.sav<br/>每個頻道的<br/>軸角色 + 反向"] E --> B["EnhancedInputUserSettings.sav<br/>每個頻道的按鈕綁定"] S --> G["G-Rebels:CONTROLS ><br/>該頻道的 JST 分頁"] B --> G
程式碼:engine\Games\GRebelsIntegration.cs、engine\Games\GRebelsSaveOptions.cs、engine\Games\GvasKeyMappings.cs。
- SaveOptions.sav:Unreal GVAS(UE 5.8,帶有型別樹的屬性標籤)。
Joysticks保存S_Controller_Save { DeviceID (HID path), Enabled, MultiID (channel) };AxisOptions保存S_Input_Axis_Save { Key, Offset, Multiplier, Role, Inverted, DeadZone },按鍵如RawInput_Controller0_AxisY,角色則為列舉值(0 Yaw、1 Thrust、2 Roll、3 Pitch、4 Side strafe、5 Up/down、6 None)。沒有校驗碼:JoyPro 會就地編輯固定大小的值。 - EnhancedInputUserSettings.sav:Unreal Enhanced Input 的玩家對應按鍵。對應名稱為
<ACTION>JST<channel>(PRIMARYFIREJST0),按鍵為RawInput_Controller<channel>_Button<n>,n 為 DirectInput 按鈕編號。對應清單會被改寫;其他每個位元組都保持不變。 - 裝置:依 HID 路徑比對到遊戲指定給它們的頻道。
- 指令清單:JoyPro 自己的表(
DB\GRebels\actions.tsv,軸角色和按鈕;不讀取遊戲的檔案)。engine grebels refresh-db會將它寫入遊戲資料資料夾;已存在的列保留原有項目。 - 指令:
engine grebels paths、engine grebels catalog、engine grebels scan、engine grebels import、engine grebels export--mode clean|add|merge|merge-overwrite --nuke-untouched-devices --dry-run。
#已知限制
- 帽子開關、死區和靈敏度不會寫入。
- 按鈕中只有 Primary Fire 已在遊戲中確認。
- 永遠不會新增項目:頻道、軸設定列和按鈕檔案都必須由遊戲建立。
- 測試:
engine\tests\smoke\grebels.ps1;遊戲內為tools\e2e\games\GRebelsSettings.ps1(兩次啟動:第一次讓 vJoy 取得頻道並儲存軸設定列,第二次檢查隨機角色和 JST0 上的 Primary Fire;之後會還原存檔資料夾)。
此遊戲的所有技術說明(由儲存庫產生): g-rebels.md.