ゲームバージョンの管理

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要​

ネームスペースに複数のゲームを関連付けることができます。各ゲームには多くのバージョンがあり、それぞれに一意のゲームバージョンIDがあります。本ガイドでは、BlackBox CLIを使用してゲームバージョンの一覧表示、セットアップ、制御を行う方法について説明します。

備考

Game Version IDは、ネームスペース内の各ゲームに対して生成される一意のIDであり、Versionsページに表示されるバージョンとは関係ありません。これは現在改善中のレガシー命名規則です。

ゲームバージョンをリストする​

新しいゲームバージョンを追加する前に、以下のリストからコマンドを選択して、利用可能なゲームバージョンをリストします。

インライン設定なし

BlackBoxCLI.exe version list

インライン設定あり

BlackBoxCLI.exe version list --namespace <your namespace> --apikey <yourapikey>

コマンドを実行すると、以下の例に示すように、システムは利用可能なゲームバージョンをリストします。Game Version IDが名前と共にリストされます。

ID                                             | Name
-----------------------------------------------------------
2646fc64-b247-4150-8fcd-46ab883cb110           | 1.2.0
f5d6c34e-8391-4fb1-8863-f67d28247371           | 1.1.0
-----------------------------------------------------------

新しいゲームバージョンを追加する​

新しいゲームバージョンを追加するには、設定に基づいて次のコマンドのいずれかを実行します。

インライン設定なし

BlackBoxCLI.exe version add --name <new version name>

インライン設定あり

BlackBoxCLI.exe version add --name <new version name> --namespace <your namespace>  --apikey asdf1234 --game-project <your project path>

次の例では、バージョン1.1.9を追加します。

BlackBoxCLI.exe version add --name "1.1.9" --namespace MyAwesomeNamespace  --apikey asdf1234 --game-project D:\MyProject\MyAwesomeGame
備考

BlackBox CLIにゲームバージョンを設定させたくない場合は、 --no-set optionを使用してください。

バージョンを作成した場合、どれを使用するかを決定できます。この例では、バージョン1.1.9を使用します。

BlackBoxCLI version set --name "1.1.9" --namespace MyAwesomeNamespace --apikey asdf1234 --game-project D:\MyProject\MyAwesomeGame
備考

version addおよびversion setコマンドには、UnrealのCrash Report Clientターゲット URLを変更するために使用できる--enable-set-datarouterフラグがあります。

Perforceチェンジリスト情報を追加する​

Perforce (P4)でUnreal Engineゲームを作業する際、チェンジリスト名、作成者、説明などの情報をビルドパイプラインに追加する必要がある場合があります。次の例は、これを行うためのサブコマンドを示しています。

  BlackBoxCLI.exe version add-changelist-info --author johndoe --changelist-num 1234 --datetime "2020-01-01T09:37:56Z" --description "add more awesomeness"
  BlackBoxCLI.exe version add-changelist-info --author johndoe --changelist-num 1234 --datetime "2020-01-01T09:37:56Z" --description "add more awesomeness" --namespace myawesomegame --apikey asdf1234 --game-project D:\path\to\myawesomegame

add-changelist-infoおよびadd-changelist-bulkのリファレンスは次のとおりです。

メインコマンドサブコマンドオプションとパラメータ
名前説明
versionadd-changelist-info-a, --apikeyAPI Key
-n, --namespaceNamespace
-A, --authorチェンジリストの作成者
-t, --datetimeiso8601形式のチェンジリストの日時
-D, --descriptionチェンジリストの説明
-c, --changelist-numチェンジリスト番号
-p, --game-projectゲームプロジェクトパス
versionadd-changelists-bulk-a, --apikeyAPI Key
-n, --namespaceNamespace
-f, --fileチェンジリストファイル
-p, --game-projectゲームプロジェクトパス

利用可能なチェンジリストをアップロードしたい場合は、add-changelists-bulkコマンドを使用してゲームバージョンに関連付けます。JSON形式は次のとおりです。

[
  {
    "id" : <change list number>,
    "description" : "commit description",
    "Author":"author name",
    "Time":"datetime in ISO 8601 format",
  },
  ...
]

値を入力すると、次のようになります。

[
  {
    "id" : 139737,
    "description" : "adding weapon to the main character",
    "author":"hdarwintha",
    "time":"2020-09-15T03:08:00+00:00",
  },
  {
    "id" : 139720,
    "description" : "remove unused shader on main menu UI",
    "author":"tomnook",
    "time":"2020-09-14T03:08:00+00:00",
  },
]

インライン設定なしのadd-changelist-bulkコマンドの例は次のとおりです：

BlackBoxCLI.exe version add-changelist-bulk --file D:\path\to\changelist_list.json
に最終更新
On this page