技術 約3分で読めます

Steam DLC デポ設定トラブルシューティング記録

概要

「十秒奪取!」のDLC「設定資料集」をリリースしたが、購入者がダウンロードできない(空のDLC)という問題が発生。原因調査と解決までの記録。

発生した問題

  • DLC「設定資料集」(App ID: 4233300)が「空」と報告された
  • DLC側の管理画面にデポが表示されない

原因

Steamのデフォルト設定では「DLCデポはベースゲームAppIDの元で管理」となっている。そのため:

  1. DLC側の管理画面(4233300)にはデポ管理機能がない
  2. デポの作成・管理・アップロードは本体(3322940)側で行う必要がある
  3. パッケージ画面で「デポがありません」と表示されるが、これは管理画面上の表示の問題

試行錯誤の記録

最初にGemini(AI)に相談したが、的外れな回答が続いて解決できなかった。その後Claudeに相談して解決。

Geminiに相談したところ、以下を繰り返し指摘された:

  • 「パッケージにデポが含まれていない」のでは?
  • 「ビルドがdefaultブランチになっていない」のでは?
  • 「本体の管理画面を見てください」

しかし本体側を見ても「デポがありません」と表示され、堂々巡りに。

Geminiが見落としていたこと: 「パッケージにデポを追加」しようにも、そもそもDLC用のデポが本体側で作成されていなかった。デポが存在しないので選択肢に出ないのは当然だった。

解決手順

1. 本体側でDLCデポを作成

  • 本体(3322940)→ SteamPipe → デポの管理
  • 「DLC を追加(DLCのメインデポを関連付けます)」をクリック
  • 設定資料集(4233300)を選択
  • 「デポ変更を保存」

2. 正しいデポにコンテンツをアップロード

重要: SteamPipeでアップロードする際、DLC用のデポID(4233300)を指定する

最初の問題は、アートブックのコンテンツを本体デポ(3322941)にアップロードしていたこと。

正しいビルド構成:

  • 含まれるデポ: 3322941(本体コンテンツ)
  • 含まれるデポ: 4233300(設定資料集)← これが必要

3. ビルドをdefaultブランチに設定

両方のデポが含まれたビルドをdefaultブランチにセット。

正しい運用方法

管理項目管理場所
デポ管理、ビルドアップロード、SteamPipe本体(3322940)
ストアページ、価格設定、メタデータDLC(4233300)

紛らわしいポイント

パッケージ画面の「デポがありません」表示

  • DLCのパッケージ(1481997等)を開くと「このパッケージにはデポがありません」と表示される
  • 「デポを追加」ボタンを押しても選択肢が出ない
  • これは管理画面上の表示だけで、実際の配信には影響しない

DLCデポの2つの管理方式

  1. ベースゲームで一括管理(デフォルト)

    • DLCデポは本体側で管理
    • DLC管理画面にはデポ関連の項目がない
    • 今回はこの設定
  2. DLCデポを別々に管理

    • 各DLCで独自にデポを管理
    • DLC管理画面からデポ作成・アップロード可能
    • 多数のDLCがある場合に便利

確認方法

ビルドの確認

本体(3322940)→ SteamPipe → あなたのビルド

正しい状態:

ビルドID: 21278884
含まれるデポ: 3322941, 4233300  ← 両方含まれている

パッケージの確認

パッケージ一覧で「1 app | 1 depot」となっているものはデポ紐づけ済み。 「1 app」のみはデポなし表示だが、上記の設定では問題なし。

結論

DLCが正常にダウンロードできることを購入者に確認済み。

パッケージ画面の「デポがありません」は管理画面上の表示の問題であり、本体側でDLCデポを含むビルドを正しくdefaultにセットすれば配信される。


自分用のメモとして出しておくけど同じことまたやりそう……