ゲームビルドをアップデートする

ゲームビルドをアップデートサーバーへロードするときは、ビルドローダーというコマンドラインユーティリティーを使用します。

ビルドローダーシステムの要件:

  • Windows 10 64ビットOSまたはmacOS 12.4.0以上
  • 1.6 GHz CPU
  • 空きメモリの量が100MB
  • ディスク空き容量:1.5 × ゲームビルドサイズ

ビルドローダーは以下のオプションを受け付けます:

  • –init — ユーティリティの初期化。
  • –update — ゲームビルドをサーバーに送信します。
  • –builds-list — ゲームビルドのリスト。
  • –descr <build-description> — ビルドの説明。
  • –api-key <API-key> — 一つのAPI キー。
  • –game-path <path-to-game>— ゲームビルドへのパスを指定します。
  • –chunk-size <chunk-size> — チャンクのサイズ - ゲームアーカイブを分割するパーツ。許容値は10mbから500mbまで、デフォルトは 500mbです。
  • –retry-timeout <timeout> — ファイルのアップロード試行間のタイムアウト(秒単位)。許容値は10から60まで、デフォルトは20です。
  • –retry-count <retry-count> — ファイルをアップロードするための試行回数。許容値は1から10まで、デフォルトは3です。
  • –set-build-on-test — ゲームビルドをドラフトステージに配置します。このゲームはテスト用にのみ提供されます。
  • –set-build-on-master —ゲームビルドを公開済みステージに配置します。エンドユーザーがゲームを利用できるようになります。–set-build-on-testが指定されている場合、このオプションは無視されます。
  • -no-progressbar — プログレスバーを無効にします。

ゲームビルドをアップロードするには:

  1. アドミンページ>ビルド設定に移動します。
  2. APIキーをコピーします。
  3. ビルドローダーをダウンロードし、インストールします
  4. ユーティリティを初期化します
  5. サーバーへゲームビルドをアップロードします
  6. ゲームビルドをステージに配置します
  7. ゲームファイルをセットアップします

ビルドローダーをダウンロードしてインストールする

ビルドローダーをダウンロードし、インストールするには:

  1. ゲームセクションで、ゲームの右側にあるセットアップするをクリックします。
  2. ビルド > ゲームビルドに移動します。
  3. BuildLoader.zipをクリックして、お使いのOSに合ったビルドローダーを含むアーカイブをダウンロードしてください。
  4. アーカイブを解凍します。

アーカイブを解凍したフォルダからの相対的なユーティリティの場所:

  • Windows向け:Win\build_loader.exe
  • MacOS向け:Mac/build_loader

ビルドローダーを初期化する

ビルドローダーを初期化にするには:

  1. ゲームセクションで、ゲームの右側にあるセットアップをクリックします。
  2. ビルド > ゲームビルドセクションに移動します。
  3. APIキー(ランチャーID)+アイコンをクリックして、APIキーをコピーしてください。このキーは、ビルドローダーがゲームをサーバーにアップロードすることを可能にします。
  4. 以下のコマンドを実行して、ユーティリティを初期化します:

Copy
Full screen
Small screen
    build_loader.exe --init --api-key <api-key> --game-path <path-to-game>
    

    Copy
    Full screen
    Small screen
      build_loader.exe --init --api-key E51DPZ486S9IUGVF43AH4T48QB7246OQ --game-path C:\Games\LastGameBuild
      

      場所:

      • api-key—以前にコピーしたAPIキー。
      • path-to-game—マシン上のゲームビルドへのパス。パスにはラテン文字のみを含める必要があります。

      お知らせ
      • APIキーやゲームビルドのパスを変更しない限り、ユーティリティを初期化する必要は一度だけです。
      • ゲームビルドへのパスにはラテン文字しか含まれていない場合があります。

      ゲームビルドをサーバーにアップロードする

      ゲームビルドをサーバーにアップロードするには、以下のコマンドを実行します:

      Copy
      Full screen
      Small screen
        build_loader --update --game-path <path-to-game> --descr <build-description>
        

        Copy
        Full screen
        Small screen
          build_loader.exe --update --game-path C:\Games\LastGameBuild
          

          ユーティリティを初期化するとき、または以前のビルドをアップロードするときにすでに使用している場合は、–game-pathパラメーターを省略できます。

          初めてのアップロード中、アップデートサーバーはゲームビルドをすべて受信します。その後、ビルドローダーから生成されたゲームパッチを受け取ります。

          お知らせ
          アップロードされたビルドを区別できるように、–descrパラメータを指定することを強くお勧めします。
          ゲームビルドを表示するには:
          1. アドミンページであなたのプロジェクトを開きます。
          2. サイドメニューでランチャーをクリックします。
          3. ゲームセクションで、ゲームの右側にあるセットアップするをクリックします。
          4. ビルド > ゲームビルドに移動します。
          5. ゲームビルドの表までスクロールします。
          お知らせ
          ゲームビルドに、設定、ユーザープロファイル、セーブファイルなど、ゲームプレイ中に変更されるファイルが含まれている場合は、無視するファイルのリストに追加してください。そうでない場合、ランチャーはゲームのアップデート時にファイルの整合性違反を検出し、ゲーム全体を再度ダウンロードします。

          ゲームビルドをステージに配置します

          ゲームビルドは、以下のようにステージに配置することができます:

          • ビルドをサーバーにアップロードする際に、ビルドローダーに適切なオプションを渡します。--set-build-on-masterまたは--set-build-on-test
          • ビルドをサーバーにアップロードした後、ランチャープロジェクトで次のようにします:
            1. ゲームで、ゲームの右側でセットアップします。
            2. ビルド > ゲームビルドに移動します。
            3. ゲームビルドの表までスクロールします。
            4. ゲームビルドの表で、必要なビルドの右側にあるペンのアイコンをクリックします。
            5. ゲームビルドを公開ステージに配置するには「公開済みとして設定」を、ドラフトステージにはドラフトとして設定をクリックします。
            6. 選択した内容を確認します。
            7. 閉じるをクリックします。
            8. ゲームビルドの表のブランチ列に、あなたのビルドに適したブランチ名が表示されます。また、ブランチの表にも、あなたのビルドが表示されます。

          ゲームファイルを設定する

          ランチャーが正しいファイルをユーザーに送るために、まずランチャープロジェクトでインストールファイルを設定し、初期化します:

          1. ゲームで、ゲームの右側にあるセットアップするをクリックします。
          2. 実行可能ファイルタブに移動します。
          3. オペレーティングシステムごとに、ゲームを起動するファイルの名前と拡張子を入力します。このファイルは、ゲームフォルダのルートに置く必要があります。例えば:game.exe
          4. ゲームに再頒布可能ファイルがある場合:
            1. 再頒布可能ファイルタブに移動してアップロードをクリックします。
            2. 表示されたウィンドウで:
              1. ファイル名を入力します。
              2. ファイルをアップロードするをクリックして、実行ファイルを選択します。
              3. アップロードするをクリックします。

          ランチャーは、ゲームに次のパラメーターを送信します:

          • –xsolla-locale <locale>:インターフェイス言語;
          • –xsolla-login-token <token>:XsollaログインJWT(JSONウェブトークン)。

          Copy
          Full screen
          Small screen
            game.exe --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en
            

            チュートリアル

            この記事は役に立ちましたか?
            ありがとうございます!
            改善できることはありますか? メッセージ
            申し訳ありません
            この記事が参考にならなかった理由を説明してください。 メッセージ
            ご意見ありがとうございました!
            あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

            続きを読む

            次のステップ

            インストーラの生成
            最終更新日: 2025年4月2日

            誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

            問題を報告する
            当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
            フォローアップ用のメールをご提供してください
            ご意見ありがとうございました!
            フィードバックを送信できませんでした
            後でもう一度お試しいただくか、doc_feedback@xsolla.comまでお問い合わせください。