JoyPro2 Discord GitHub
遊戲

Star Citizen

顯示:

Star Citizen 把您所有的控制設定存在一個檔案 actionmaps.xml 中,並把您的搖桿編號為 joystick 欄位 js1 到 js8。JoyPro 會把這個檔案中的艦船綁定讀入您的設定檔,並就地寫回:只有艦船動作及其軸設定會改變,其他每一行都維持遊戲寫入的樣子。裝置會保留遊戲已經分配給它的欄位,所以您的綁定不會從一支搖桿跳到另一支。

Star Citizen 原生(使用自己的綁定檔案)
支援
原生(使用自己的綁定檔案)
引擎指令
engine starcitizen
綁定檔案
LIVE\user\client\0\Profiles\default\actionmaps.xml + attributes.xml(XML)
指令清單來源
Data.p4k(defaultProfile.xml)和您的設定檔
遊戲內測試
通過 54/54 個步驟(2026-10-10)
  • ✓ 匯入
  • ✓ 匯出
  • ✓ 鍵盤綁定
  • ✓ 修飾鍵
  • ✓ 在您的電腦上建立指令清單
  • ✓ 遊戲監看
  • ✓ 軸曲線與死區
  • ✓ 遊戲操作設定
  • ✗ 遊戲內力回饋設定
  • ✗ 由遙測資料產生力回饋
  • ✗ 遙測錄製
  • ✓ 虛擬 joystick(vJoy)
  • ◐ 虛擬 Xbox 手把
  • ✓ 虛擬功能
  • ✓ 設定精靈 / 自動指派
  • ✓ 座艙
  • ✓ 速查表
  • ✓ 遊戲內測試

摘自支援矩陣(由引擎程式碼產生): 所有遊戲.

給新手

#3 個步驟就能用

  1. 全部幫我設定好
    在「開始」頁面
  2. 使用這些按鈕
    先查看清單
  3. 寫入我的遊戲
    保持 Star Citizen 關閉

之前:插上您使用的每個裝置。

接著:您的綁定就會出現在 Options > Controls 中。

您之前在 Star Citizen 中綁定過按鈕嗎?那麼開始頁面會提供 匯入,然後填補空缺。您的綁定會保留,只有空著的按鈕會被指派新功能。請參閱快速入門:讓我的搖桿能用。

#JoyPro 能為 Star Citizen 做什麼

  • 匯入:您在搖桿、油門和腳舵上的艦船綁定會帶入您的設定檔,並包含死區、曲線和反向。遊戲自己在 js1 上的預設 joystick 綁定也會一併帶入,這樣之後匯出時就不會遺失。
  • 關聯:一個關聯就是每款遊戲中的同一個功能。「Landing gear」在 Star Citizen、DCS 和 Elite Dangerous 中可以是同一個開關。
  • 匯出:JoyPro 會就地編輯 actionmaps.xml。步行、載具和選單的綁定,以及滑鼠和手把綁定,都維持原樣。

#匯入您的 Star Citizen 綁定

  1. 開啟 開始。如果 Star Citizen 卡片要求指令清單,請按 建立清單:JoyPro 會從您的安裝讀取遊戲的動作(Data.p4k,唯讀)。遊戲更新後,按卡片上的 更新 即可加入新的動作。
  2. 按 Star Citizen 卡片上的 匯入。保持 加入我的設定檔。只有在您也想把艦船按鍵放進 JoyPro 時,才勾選 同時取得鍵盤按鍵。
  3. 按 立即匯入。查看我的關聯 會開啟匯入的內容。
顯示您遊戲的「開始」頁面顯示您遊戲的「開始」頁面
顯示您遊戲的「開始」頁面 (圖片顯示的是英文版應用程式。)

#建立並檢查關聯

每個艦船動作都是關聯中的一個項目。用關聯流程把您其他遊戲的相同功能連在一起,然後在匯出頁面按 檢查:它會搶在遊戲之前,找出在您的艦船上同時做兩件事的按鈕。

#匯出到 Star Citizen

  1. 關閉 Star Citizen。 遊戲結束時會重寫 actionmaps.xml,所以遊戲執行時 JoyPro 會拒絕寫入。
  2. 開啟 匯出,勾選 Star Citizen 卡片。
  3. 如果您是用 JoyPro 設定搖桿,請保留 取代我的裝置上的綁定 和 同時清除我的其他裝置。然後在卡片上按 立即匯出。
「匯出」頁面「匯出」頁面
「匯出」頁面
在遊戲中: 您在 Star Citizen 中會看到什麼

啟動遊戲,從主選單開啟 Options > Controls。選擇您的裝置(Joystick / HOTAS 1、2 ...):它的死區和飽和度就是您在 JoyPro 中設定的值;Inversion Settings 和 Joystick Sensitivity Curves(Flight > Flight Movement)會顯示您的反向、指數和曲線。您的艦船綁定位於每個裝置的 joystick 欄位上。被 JoyPro 關閉的遊戲預設值會顯示為空白。選單顯示的飽和度會比檔案中的值高 0.01(0.87 會顯示為 0.88);遊戲保留的是精確的值。

#您需要在 Star Citizen 中自己做的事

  • 綁定方面不需要再做其他事。匯出前請插上您使用的每個裝置:未連接的裝置會保留它的欄位和綁定,但 JoyPro 無法給它新的綁定。
  • 如果遊戲位於偵測到的資料夾以外的其他位置,請在匯出頁面的 選項與路徑(進階) 下設定一次路徑,或在 設定 > 遊戲 中連結資料夾。

#常見問題

  • 「Star Citizen 正在執行」:結束遊戲(也要從啟動器結束),然後再匯出一次。
  • 綁定跑到錯誤的搖桿上:保持 SC:優先採用本機順序 開啟(預設值)。關閉時,欄位會依照 Windows 回報裝置的順序排列,這可能會把某個裝置的所有綁定移到另一個 js 編號。
  • 有裝置沒分到欄位:遊戲有八個 joystick 欄位。JoyPro 會把同一支搖桿的重複項目(遊戲的名稱和 JoyPro 的名稱)合併成一個欄位,但超過八個已連接且有綁定的裝置就放不下了。
  • 預設綁定又回到 js1 上:當 js1 上的裝置在匯出時未連接,它就會回來。請連接該裝置,然後用「取代」再匯出一次。
進階

#JoyPro 讀取和寫入的檔案

檔案 這是什麼
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml 您的重新綁定、joystick 插槽(<options type="joystick" instance="1..8" Product="...">)、每個插槽的選項群組(反向、指數、曲線、靈敏度)以及裝置選項(每個實體軸的死區、飽和度)
...\Profiles\default\attributes.xml 遊戲全域設定(<Attr name="..." value="..."/>),只包含與遊戲預設值不同的值
...\Profiles\default\actionmaps.jp JoyPro 對寫入檔案的副本,以註解記錄關聯名稱,供下次匯入讀回
...\Profiles\default\actionmaps.xml.joypro.json JoyPro 上次寫入的軸設定,讓「更新」能分辨哪些值是您在遊戲中改的、哪些是它自己寫的
actionmaps.xml.jpbak、attributes.xml.jpbak 匯出第一次寫入前的副本,以及 JoyPro 的版本化備份區

匯出會就地編輯 actionmaps.xml:只有 JoyPro 寫入的飛船重新綁定和軸重新綁定的軸設定會改變。其他動作對應表、滑鼠和手把的重新綁定、啟動模式、修飾鍵、其他選項群組和裝置選項都逐位元組保持不變。沒有 Star Citizen 綁定的設定檔不會更動檔案。

#joystick 插槽

Star Citizen 以插槽來命名每個 joystick 綁定:js1_button3、js2_x。檔案會依裝置的 DirectInput 產品名稱和產品 GUID,列出哪個裝置佔用哪個插槽。

  • 優先採用本機順序(預設開啟):檔案中已列出的已連接裝置保留原本的插槽。其他裝置依 Windows 回報的順序填入空的插槽。
  • 一個裝置,一個插槽:同一支搖桿被列出兩次(分別以遊戲的名稱和 JoyPro 的執行個體名稱,或是舊的第二筆項目)時只佔一個插槽。匯出會移除重複的項目,並把它們的綁定移到該裝置保留的插槽。未連接裝置的項目保留。
  • 兩個同型號的已連接裝置會分開處理。
  • 更換插槽的裝置會帶走它的選項群組(反向、曲線)。沒有分到插槽的裝置會失去舊插槽的群組,並出現警告。

#Star Citizen 的匯出模式

每種模式都只變更飛船動作。步行、載具和選單的對應表逐位元組保持不變。

模式 遊戲中會發生什麼
僅新增 遊戲的綁定都不變。如果某個動作的 joystick 插槽已有重新綁定或生效中的預設值,就保留它。如果某個綁定所在的輸入已被另一個飛船動作使用,該綁定不會寫入,並標示「未寫入遊戲」。
更新,保留遊戲的綁定 您的輸入會放進該動作的 joystick 插槽(Star Citizen 每個動作、每種輸入類型各有一個插槽)。如果您把某個輸入指派給另一個飛船動作,遊戲在該輸入上的綁定會被解除:它的重新綁定會被移除;如果該動作有預設值,則改成空的 js1_ ,讓預設值不會回來。
更新,以我的設定檔為準 同上;開啟鍵盤選項時,您綁定的動作也會失去它的鍵盤重新綁定。
取代我的裝置上的綁定 寫入的裝置只保留您的飛船綁定。如果有裝置在 js1 上,您設定檔中沒有的遊戲 js1 預設值會被關閉。
+ 同時清除我的其他裝置 設定檔中沒有綁定的已連接裝置會失去它們的飛船綁定;未使用 js1 時,js1 的預設值會被關閉。

「匯出」頁面上的選項(位於 選項與路徑(進階) 下):

  • SC:保留鍵盤預設值(開啟):鍵盤保留遊戲的預設按鍵。關閉:寫入您的鍵盤綁定,並解除它們所佔用的預設按鍵。
  • SC:優先採用本機順序(開啟):請參閱上方的 joystick 插槽。
匯出頁面上的「選項與路徑(進階)」匯出頁面上的「選項與路徑(進階)」
匯出頁面上的「選項與路徑(進階)」

#遊戲的預設 joystick 綁定

Star Citizen 有預設的 joystick 綁定,在動作於 js1 上取得重新綁定之前,會作用在 js1 上(Y 軸俯仰、X 軸偏航、Z 旋轉軸滾轉,以及幾個按鈕)。匯入會把每個生效中的預設值都當作 js1 裝置的綁定,讓您的設定檔反映遊戲實際的行為。匯出不會為等同預設值的綁定寫入重新綁定(只寫入真正的差異)。「取代」和「同時清除」會以空的重新綁定 js1_ 關閉您設定檔中沒有的預設值,就像遊戲自己的選單寫入已清除的綁定一樣,而且只在 js1 上的裝置已連接時才這麼做。因此,先匯入,再用「取代」+「同時清除」匯出,actionmaps.xml 會維持原樣。

#永遠不會變更的內容

  • 步行、地面載具和選單的綁定(Star Citizen 的地面載具算是獨立的載具類別)。
  • 未連接的裝置:它們保留自己的插槽和重新綁定。
  • 匯入時忽略的裝置,以及 JoyPro 轉送輸入的 vJoy 裝置。
  • 滑鼠和手把的綁定;鍵盤也不動,除非您匯出鍵盤綁定。
  • 啟動模式、修飾鍵、其他選項群組和裝置選項。

#艦船、曲線、遊戲設定

  • 細分程度:所有飛船共用一組飛船綁定(遊戲沒有各飛船專屬的綁定)。
  • 軸曲線,依照遊戲的存放方式分成兩處:每個裝置和實體軸的死區與飽和度;每個插槽和選項群組的反向、指數(1 到 3)、11 點曲線和靈敏度。指數和曲線互斥,與遊戲選單相同。沒有 Star Citizen 值的關聯會套用擬合後的 JoyPro 曲線:死區和飽和度放到裝置的軸上,曲率換算成最接近的指數;如果沒有合適的指數,就改用曲線。沒有單側軸:遊戲的絕對油門和相對油門是不同的動作。
  • 更新 會保留您在遊戲中變更的軸值(並出現警告);取代 和 以我的設定檔為準 會套用您設定檔中的值。中性的關聯會保留遊戲本身的值(自由視角保留預設指數 2.5)。
  • 遊戲全域設定(attributes.xml):HOTAS 推力反向切換、相對油門的停止點時間與門檻、IFCS 靈敏度調整、ESP 開關、強度與阻尼、砲塔 ESP、飛行預設值(油門保持、速度限制器、耦合模式、G-safe、自動精確模式、太空煞車)、反向飛行控制器,以及 Vibration。請在 設定 > 遊戲的力回饋設定(選擇 Star Citizen)或用 engine ffb set 設定。JoyPro 只就地變更您設定的那幾行,而且不會建立該檔案。ESP 強度滑桿最大到 1.00,因此 JoyPro 提供 0 到 1。
  • 力回饋:無。Vibration 是遊戲中唯一相關的設定。
  • 監看程式:您在遊戲選單中變更的綁定或軸值,會在遊戲關閉後被偵測到,JoyPro 會詢問是否要採用。它會比對 actionmaps.xml(僅限飛船動作對應表)以及 JoyPro 在 attributes.xml 中管理的設定。
  • HUD:HUD 透過遊戲的處理程序找到遊戲,並顯示您的 Star Citizen 綁定。
技術細節

#Star Citizen 整合的內部運作

flowchart LR
  A[("actionmaps.xml")] --> S["每個裝置一個插槽"]
  D["已連接的裝置"] --> S
  P["您的設定檔"] --> E["engine starcitizen export"]
  S --> E
  E --> X["actionmaps.xml"]
  E --> T["attributes.xml"]
  X --> G["Options ><br/>Controls"]
已知的裝置保留自己的 joystick 插槽(actionmaps.xml 中的 js1 ... js8)。新裝置取得第一個空的插槽;過時的重複項會被移除。飛船的重新綁定會直接在原處編輯,整個遊戲的設定寫入 attributes.xml。

程式碼:engine\EngineStarCitizen.cs、engine\EngineStarCitizenTuning.cs、軸模型 engine\AxisModels\StarCitizen.cs,以及設定模型 engine\FfbModels\StarCitizen.cs。

  • 裝置名稱:插槽的 Product 是 DirectInput 產品名稱和產品 GUID,中間隔兩個空格(vJoy Device {BEAD1234-0000-0000-0000-504944564944})。以其他名稱(執行個體 GUID)寫入的插槽或 deviceoptions 區塊,遊戲無法辨識:遊戲會用它的產品名稱改寫該插槽,並丟掉該插槽的選項群組。因此 JoyPro 會寫入已連接裝置的產品名稱。
  • 指令清單:engine db refresh-starcitizen 從 Data.p4k(或用 --source 指定解壓後的副本)讀取 Data\Libs\Config\defaultProfile.xml,寫入 DB\StarCitizen\AllBinds.xml:每個動作及其選項群組、joystick 選項樹(上層群組和預設值,以及哪些群組顯示曲線),以及動作的預設 joystick 輸入。engine starcitizen labels 從 global.ini 取得遊戲中控制項的名稱。
  • 匯入:engine starcitizen import(--include-keyboard、--device、--ignore-device);每個軸重新綁定都會取得遊戲實際使用的值(插槽的末端群組,否則是您設定過的最近上層群組,再否則是遊戲預設值)以及其軸的裝置選項,作為它的 game:StarCitizen 調校。engine starcitizen scan 顯示相同內容但不變更設定檔;engine starcitizen list-devices 列出檔案中的 joystick 插槽。
  • 匯出:engine starcitizen export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --prefer-local-order true|false --include-keyboard true|false --ignore-device <d>。新的 deviceoptions 區塊會放在第一個 <options> 之前;如果同一個選項群組或同一個實體軸上有多個關聯且值不同,會出現警告,並以名稱排序第一的關聯為準。
  • 遊戲設定:engine ffb set --device * --game StarCitizen --param <Attr name>=<value>;已存在的行會改成新值,新的行會放在排序後的位置。
  • 備份:engine backups list 列出副本;卡片上的 復原上次匯出 會還原最新的一份。

#已知限制

  • 八個 joystick 插槽;每個裝置的按鈕上限未知(資料來源互相矛盾)。
  • 遊戲希望新的 deviceoptions 區塊放在哪裡、曲線的內插方式(選單會畫出一條通過各點的平滑樣條曲線)、指數的範圍,以及靈敏度是否適用於 joystick,都尚未確認。遊戲全域設定的範圍不在遊戲可讀取的檔案中。
  • Vibration 是否會驅動 DirectInput 力回饋搖桿,尚未確認。
  • 測試:engine\tests\smoke\starcitizen.ps1(目錄更新、選項群組和曲線的匯入、匯入 + 匯出逐位元組相同、每一項軸設定、衝突、插槽變更、就地編輯 attributes.xml);在遊戲中執行 tools\e2e\games\StarCitizenSettings.ps1(主選單 Options:設定、綁定和曲線)和 tools\e2e\games\StarCitizen.ps1(匯出和匯入模式矩陣)。

此遊戲的所有技術說明(由儲存庫產生): starcitizen.md.