Star Citizen はすべての操作設定を 1 つのファイル actionmaps.xml に保存し、スティックにはジョイスティック枠 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)
- ✓ インポート
- ✓ エクスポート
- ✓ キーボードの割り当て
- ✓ モディファイア
- ✓ PC 上で作成するコマンド リスト
- ✓ ゲーム監視
- ✓ 軸のカーブとデッドゾーン
- ✓ ゲームの操作設定
- ✗ ゲーム内のフォースフィードバック設定
- ✗ テレメトリによるフォースフィードバック
- ✗ テレメトリ記録
- ✓ 仮想ジョイスティック(vJoy)
- ◐ 仮想 Xbox パッド
- ✓ 仮想機能
- ✓ セットアップ ウィザード / 自動割り当て
- ✓ コックピット
- ✓ チートシート
- ✓ ゲーム内テスト
エンジンのコードから生成した対応表より: すべてのゲーム.
#3 ステップで使えるようにする
- すべて自動で設定
スタート ページで - このボタンを使う
先に一覧を確認 - ゲームに書き込む
Star Citizen は閉じたままで
事前に:使うデバイスをすべて接続してください。
その後:割り当ては Options > Controls にあります。
以前に Star Citizen でボタンを割り当てていましたか? それならスタートページに インポートしてから空きを埋める が表示されます。今の割り当てはそのまま残り、空いているボタンだけに新しい役割が付きます。クイックスタート:スティックを使えるようにする を参照してください。
#JoyPro が Star Citizen に対して行うこと
- インポート:スティック、スロットル、ペダルの機体の割り当てが、デッドゾーン、カーブ、反転と一緒にプロファイルに入ります。js1 にあるゲーム自身の既定のジョイスティック割り当ても取り込むため、後でエクスポートしても失われません。
- リレーション:1 つのリレーションは、すべてのゲームで 1 つの機能です。「Landing gear」を Star Citizen、DCS、Elite Dangerous で同じスイッチにできます。
- エクスポート:JoyPro は
actionmaps.xmlをその場で編集します。徒歩、車両、メニューの割り当てや、マウスとゲームパッドの割り当てはそのまま残ります。
#Star Citizen の割り当てをインポート
- 開始 を開きます。Star Citizen のカードがコマンドリストを求めている場合は リスト作成 を押します。JoyPro がインストールからゲームのアクションを読み取ります(
Data.p4k、読み取りのみ)。ゲームのパッチ後は、カードの 更新 で新しいアクションが追加されます。 - Star Citizen のカードの インポート を押します。プロファイルに追加 のままにします。機体のキーも JoyPro に取り込みたい場合だけ キーボードのキーも取り込む にチェックを入れてください。
- 今すぐインポート を押します。リレーションを表示 で取り込んだ内容を開けます。


#リレーションの作成と確認
機体のアクションはそれぞれリレーションの 1 項目です。リレーションの流れ でほかのゲームの同じ機能とつなげ、エクスポートページで 確認 を押してください。ゲームより先に、機体で 1 つのボタンが 2 つの動作をする箇所を見つけます。
#Star Citizen へエクスポート
- Star Citizen を閉じてください。 ゲームは終了時に
actionmaps.xmlを書き直すため、実行中は JoyPro が書き込みを拒否します。 - エクスポート を開き、Star Citizen のカードにチェックを入れます。
- JoyPro でスティックを設定しているなら、自分のデバイスで置き換え と ほかのデバイスもクリア をオンのままにします。カードの 今すぐエクスポート を押します。


ゲームを起動し、メインメニューから Options > Controls を開きます。デバイス(Joystick / HOTAS 1、2 ...)を選ぶと、デッドゾーンとサチュレーションは JoyPro で設定した値になっています。Inversion Settings と Joystick Sensitivity Curves(Flight > Flight Movement)には反転、指数、カーブが表示されます。機体の割り当ては各デバイスのジョイスティック枠にあります。JoyPro がオフにしたゲームの既定の割り当ては空で表示されます。メニューではサチュレーションがファイルの値より 0.01 高く表示されます(0.87 は 0.88 と表示)が、ゲームは正確な値を保持しています。
#Star Citizen で自分で行うこと
- 割り当てについてはほかに何もありません。エクスポートの前に、使うデバイスをすべて接続してください。接続されていないデバイスは枠と割り当てを保ちますが、JoyPro は新しい割り当てを与えられません。
- ゲームが検出されたフォルダーとは別の場所にある場合は、エクスポートページの オプションとパス(上級者向け) でパスを一度設定するか、設定 > ゲーム でフォルダーをリンクしてください。
#よくある落とし穴
- 「Star Citizen が実行中です」:ゲームを(ランチャーからも)終了して、もう一度エクスポートしてください。
- 割り当てが違うスティックに入った:SC: ローカルの順序を優先 をオン(既定)のままにしてください。オフにすると、枠は Windows がデバイスを報告する順番に従うため、あるデバイスの割り当てがすべて別の js 番号に移ることがあります。
- デバイスに枠がない:ゲームのジョイスティック枠は 8 つです。JoyPro は 1 本のスティックの重複項目(ゲームでの名前と JoyPro での名前)を 1 つの枠にまとめますが、割り当てのあるデバイスが 9 台以上接続されていると収まりません。
- 既定の割り当てが js1 に戻った:エクスポート時に js1 のデバイスが接続されていないと戻ります。接続して、置き換えでもう一度エクスポートしてください。
#JoyPro が読み書きするファイル
| ファイル | これは何か |
|---|---|
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml |
自分で変えた割り当て(rebind)、ジョイスティックのスロット(<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 をその場で編集します。変わるのは、宇宙船の rebind と、JoyPro が書き込む軸 rebind の軸設定だけです。ほかのアクション マップ、マウスとゲームパッドの rebind、起動モード(activation mode)、モディファイア、ほかのオプション グループ、デバイスのオプションは 1 バイトも変わりません。Star Citizen の割り当てがないプロファイルでは、ファイルはそのままです。
#ジョイスティックのスロット
Star Citizen はジョイスティックの割り当てをすべてスロットで呼びます(js1_button3、js2_x)。ファイルには、どのデバイスがどのスロットを持つかが、デバイスの DirectInput の製品名と製品 GUID で記載されています。
- ローカルの順序を優先(既定でオン):ファイルにすでに記載されている接続中のデバイスは、そのスロットを保ちます。ほかのデバイスは、Windows が報告する順に空いたスロットを埋めます。
- 1 デバイスに 1 スロット:同じスティックが 2 回記載されている場合(ゲームの名前と JoyPro のインスタンス名で、または古い 2 つ目の記載として)、使うスロットは 1 つです。エクスポートは重複した記載を削除し、その割り当てをデバイスが保つスロットに移します。接続されていないデバイスの記載は残ります。
- 同じモデルのデバイスが 2 台接続されていても、別々に扱います。
- スロットが変わるデバイスは、オプション グループ(反転、カーブ)を一緒に持っていきます。スロットを得られないデバイスは、古いスロットのグループを失い、警告が出ます。
#Star Citizen でのエクスポート モード
どのモードでも変わるのは宇宙船のアクションだけです。徒歩、車両、メニューのマップは 1 バイトも変わりません。
| モード | ゲームで起きること |
|---|---|
| 追加のみ | ゲームの割り当ては変わりません。ジョイスティックのスロットにすでに rebind や有効な既定値があるアクションは、それを保ちます。ほかの宇宙船アクションが使っている入力への割り当ては書き込まず、「ゲームに書き込まれていません」と表示します。 |
| 更新(ゲームの割り当てを優先) | 入力はアクションのジョイスティック スロットに入ります(Star Citizen では、アクションと入力の種類ごとに 1 つ)。別の宇宙船アクションに割り当てた入力にあるゲームの割り当ては解除されます。その rebind は削除されるか、アクションに既定値がある場合は空の js1_ になり、既定値が戻ってこないようにします。 |
| 更新(プロファイルを優先) | 上記と同じです。キーボードのオプションを使うと、割り当てたアクションはキーボードの rebind も失います。 |
| 自分のデバイスで置き換え | 書き込んだデバイスには、自分の宇宙船の割り当てだけが残ります。js1 にデバイスがある場合、プロファイルにないゲームの js1 既定値はオフになります。 |
| + ほかのデバイスもクリア | プロファイルに割り当てのない接続中のデバイスは、宇宙船の割り当てを失います。js1 を使っていない場合は、js1 の既定値がオフになります。 |
エクスポート ページのオプション(オプションとパス(上級者向け) の中):
- SC: キーボードの既定を維持(オン):キーボードにはゲームの既定のキーが残ります。オフ:キーボードの割り当てを書き込み、それが使う既定のキーは解除されます。
- SC: ローカルの順序を優先(オン):上のジョイスティックのスロットを参照してください。


#ゲームの既定のジョイスティック割り当て
Star Citizen には既定のジョイスティック割り当てがあり、アクションに rebind が付くまで js1 に作用します(Y にピッチ、X にヨー、Z 回転にロール、いくつかのボタン)。インポートは有効な既定値をすべて js1 デバイスの割り当てとして取り込むため、プロファイルにはゲームが実際にしている内容が入ります。エクスポートは、既定値と同じ割り当てには rebind を書きません(実際に違うものだけ)。「置き換え」と「ほかのデバイスもクリア」は、プロファイルにない既定値を空の rebind js1_ でオフにします。これはゲーム自身のメニューが割り当てを消したときに書くのと同じ形で、js1 のデバイスが接続されているときだけ行います。そのため、インポートしてから「置き換え」+「ほかのデバイスもクリア」でエクスポートすると、actionmaps.xml は元のままです。
#一切変更しないもの
- 徒歩、地上車両、メニューの割り当て(Star Citizen の地上車両は独自の車両クラスとして扱われます)。
- 接続されていないデバイス:スロットと rebind をそのまま保ちます。
- インポートで無視したデバイスと、JoyPro が転送先にしている vJoy デバイス。
- マウスとゲームパッドの割り当て。キーボードの割り当てをエクスポートしない限り、キーボードも。
- 起動モード(activation mode)、モディファイア、ほかのオプション グループ、デバイスのオプション。
#艦船、カーブ、ゲーム設定
- 適用範囲:すべての宇宙船に 1 セットの割り当てです(ゲームに宇宙船ごとの割り当てはありません)。
- 軸カーブ:ゲームの保存方法に合わせて 2 か所に書きます。デバイスと物理軸ごとのデッドゾーンと飽和、そしてスロットとオプション グループごとの反転、指数(1 ~ 3)、11 点のカーブ、感度です。ゲームのメニューと同じく、指数とカーブはどちらか一方だけです。Star Citizen の値を持たないリレーションは、JoyPro のカーブを近似して変換します。デッドゾーンと飽和はデバイスの軸に、曲がり具合は最も近い指数に、合う指数がなければカーブになります。片側だけの軸はありません。ゲームの絶対スロットルと相対スロットルは別々のアクションです。
- 更新 は、ゲームで変えた軸の値を保ちます(警告付き)。置き換え と 自分のプロファイルを優先 は、プロファイルの値を設定します。中立のリレーションでは、ゲーム自身の値が残ります(フリールックは既定の指数 2.5 のままです)。
- ゲーム全体の設定(
attributes.xml):HOTAS の推力反転トグル、相対スロットルのトラップ時間としきい値、IFCS の感度モディファイア、ESP のオン・強さ・減衰、砲塔の ESP、飛行の既定値(スティッキー スロットル、速度リミッター、カップルド、G セーフ、自動精密、スペース ブレーキ)、フライト コントローラーの反転、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"]
コード:engine\EngineStarCitizen.cs、engine\EngineStarCitizenTuning.cs、軸モデル engine\AxisModels\StarCitizen.cs、設定モデル engine\FfbModels\StarCitizen.cs。
- デバイス名:スロットの
Productは、DirectInput の製品名と製品 GUID を 2 つの空白で区切ったものです(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に書き出します。内容は、オプション グループ付きのすべてのアクション、ジョイスティックのオプション ツリー(親と既定値、どのグループがカーブを表示するか)、アクションの既定のジョイスティック入力です。engine starcitizen labelsは操作のゲーム内の名前をglobal.iniから取得します。 - インポート:
engine starcitizen import(--include-keyboard、--device、--ignore-device)。すべての軸 rebind に、ゲームが使う値(スロットの末端のグループ、なければ設定した最も近い親、なければゲームの既定値)と、その軸のデバイス オプションを、game:StarCitizenの調整として付けます。engine starcitizen scanはプロファイルを変えずに同じ内容を表示します。engine starcitizen list-devicesはファイルのジョイスティック スロットを一覧表示します。 - エクスポート:
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>の前に入ります。1 つのオプション グループや 1 つの物理軸に、値の異なる複数のリレーションがあると警告が出て、名前順で最初のリレーションが優先されます。 - ゲームの設定:
engine ffb set --device * --game StarCitizen --param <Attr name>=<value>。既存の行には値が入り、新しい行は並び順どおりの位置に入ります。 - バックアップ:
engine backups listでコピーを一覧表示します。カードの 前回のエクスポートを元に戻す で最新のものを復元します。
#既知の制限
- ジョイスティックのスロットは 8 つです。デバイスごとのボタン数の上限はわかっていません(情報源によって食い違います)。
- ゲームが新しい
deviceoptionsブロックをどこに置きたいか、カーブの補間方法(メニューは点を通る滑らかなスプラインを描きます)、指数の範囲、感度がジョイスティックに効くかどうかは、まだ確認していません。ゲーム全体の設定の範囲は、ゲームの読めるファイルには書かれていません。 - Vibration が DirectInput のフォースフィードバック スティックを動かすかどうかは、まだ確認していません。
- テスト:
engine\tests\smoke\starcitizen.ps1(カタログの更新、オプション グループとカーブのインポート、インポート + エクスポートでバイト単位で一致すること、すべての軸設定、競合、スロットの変更、attributes.xmlのその場での編集)。ゲーム内ではtools\e2e\games\StarCitizenSettings.ps1(メイン メニューの Options:設定、割り当て、カーブ)とtools\e2e\games\StarCitizen.ps1(エクスポートとインポートのモードの組み合わせ)。
このゲームに関するすべての技術メモ(リポジトリから生成): starcitizen.md.