次の方法で共有

プレイヤー データ リセット ツール (XblPlayerReset.exe)

  • [アーティクル]

プレイヤー データ リセット ツールを使用して、テストサンドボックス内のプレイヤーのデータ、またはプレーヤーのグループのデータをリセットできます。 アチーブメント、ランキングボード、状態、タイトルの履歴、などのデータをリセットすることができます。 個々のアカウントは、そのメール アドレスまたは XUID でリセットできます。 XUID でリセットするには、まず XblDevAccount.exe ツールを実行して、リセットするアカウントを所有するパートナー センター アカウントにログインする必要があります。 テスト アカウントのメール アドレスでリセットするには、テスト アカウントのパスワードを知っている必要があります。

このコマンドラインツールは GDK の一部であり、別途、Xbox サービス ツールパッケージにも含まれています。 XblPlayerDataReset.exe ツールを入手する方法については、「Xbox サービスの開発ツール」 を参照してください。

カスタム ツールは、開発ツール ライブラリで作成できます。

XUID によるリセット

プレイヤー データ リセット ツールを使用するには、サインインに (XblDevAccount.exe で) 使用した開発者アカウントに、特定の製品に対する適切なアクセス許可が必要です。 "ツール アクセス" はアカウント レベルのアクセス許可でなく、製品レベルのアクセス許可である点に注意してください。 そのため、プレイヤー データをリセットする単体製品ごとに "ツール アクセス" のアクセス許可を付与する必要があります。

  1. 管理者特権を持つ開発者アカウントでパートナー センターにログインします。
  2. [アカウント設定] = > ユーザー ページ: (https://partner.microsoft.com/dashboard/account/usermanagement) に移動します。
  3. "ツール アクセス" のアクセス許可が必要なユーザーまたはグループをクリックします。
  4. ユーザーまたはグループが、現在、標準ロール (開発者など) に割り当てられている場合は、[アクセス許可のカスタマイズ] に切り替えます。
  5. 次のページで、[製品レベル] アクセス許可の表に移動して、[Xbox Live] 表見出しを展開し、[ツール アクセス] 列を見つけます。
  6. "ツール アクセス" のアクセス許可を付与する製品または製品グループのチェック ボックスを明示的にオンにします。

アクセス許可を設定すると、次のようにテスト アカウント データをリセットできます。

XblPlayerDataReset.exe --scid <SCID> --sandbox <SNDBOX.0> --xuid <XUID1,XUID2,XUID3,...>

メール アドレスでリセット

テスト アカウントのメール アドレスでリセットするには、各テスト アカウントのパスワードを知っている必要があります。 次のコマンドを使用すると、テスト ユーザーとしてログインするためのウィンドウがポップアップ表示されます。

XblPlayerDataReset.exe --scid <SCID> --sandbox <SNDBOX.0> --user <XXXXXX-aaa@xboxtest.com,XXXXXX-bbb@xboxtest.com,...>

ファイルによるリセット

ファイルでリセットするには、XUID の区切りファイル、電子メールの区切りファイル、またはパートナー センター アカウントのエクスポートのいずれかのファイルの場所を渡すことができます。

XblPlayerDataReset.exe --scid <SCID> --sandbox <SNDBOX.0> --file </path/to/file>

区切り記号オプション

必要に応じて、上記のリセット オプションのいずれかにカスタム区切り記号を設定できます。 既定の区切り記号はコンマ (,) です。

XblPlayerDataReset.exe --scid <SCID> --sandbox <SNDBOX.0> --xuid <XUID1*XUID2*XUID3*...> --delimiter *
XblPlayerDataReset.exe --scid <SCID> --sandbox <SNDBOX.0> --user <XXXXXX-aaa@xboxtest.com$XXXXXX-bbb@xboxtest.com$...> --delimiter $
XblPlayerDataReset.exe --scid <SCID> --sandbox <SNDBOX.0> --file </path/to/file> --delimiter %

Output

コマンドが成功した場合、または失敗した場合は、次のような出力が表示されます。

成功

Player {email} data reset has completed successfully.

エラー

Player {email} data reset has completed with errors:
    Leaderboard reset contains error: {errorMessage}