通过

玩家数据重置工具 (XblPlayerDataReset.exe)

  • 项目

玩家数据重置工具可用于重置测试沙盒中的一个玩家或一组玩家的数据。 可以重置成就、排行榜、统计和游戏历史之类的数据。 单个帐户可通过其电子邮件地址或 XUID 重置。 若要通过 XUID 重置，必须首先运行 XblDevAccount.exe 工具，以登录拥有要重置的帐户的合作伙伴中心帐户。 若要通过测试帐户的电子邮件地址进行重置，需要知道测试帐户的密码。

此命令行工具是 GDK 和 Xbox 服务 Tools 包的一部分。 若要了解如何获取 XblPlayerDataReset.exe 工具，请参阅 Xbox 服务的开发工具。

可使用开发工具库创建自定义工具。

通过 XUID 重置

若要使用“玩家数据重置工具”由 XUID 重置用户，用于（使用 XbleVaccount.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 %

输出

如果命令成功或失败，你将看到类似于下面所列内容的输出。

成功

Player {email} data reset has completed successfully.

错误

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