다음을 통해 공유

플레이어 데이터 다시 설정 도구(XblPlayerDataReset.exe)

  • 아티클

플레이어 데이터 재설정 도구를 사용하여 테스트 샌드박스에서 플레이어 또는 플레이어 그룹의 데이터를 재설정할 수 있습니다. 도전 과제, 순위표, 통계 및 타이틀 기록과 같은 데이터를 재설정할 수 있습니다. 개별 계정은 전자 메일 주소 또는 XUID로 다시 설정할 수 있습니다. XUID로 다시 설정하려면 먼저 XblDevAccount.exe 도구를 실행하여 다시 설정할 계정을 소유하는 파트너 센터 계정에 로그인해야 합니다. 테스트 계정의 전자 메일 주소로 다시 설정하려면 테스트 계정의 암호를 알고 있어야 합니다.

이 명령줄 도구는 GDK 및 별도로 Xbox 서비스 도구 패키지의 일부입니다. XblPlayerDataReset.exe 도구를 가져오는 방법을 알아보려면 Xbox 서비스용 개발 도구를 참조하세요.

사용자 지정 도구는 개발자 도구 라이브러리를 사용하여 만들 수 있습니다.

XUID로 다시 설정

플레이어 데이터 다시 설정 도구를 사용하여 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 %

출력

명령이 성공하거나 실패하면 아래에 나열된 것과 유사한 출력이 표시됩니다.

성공

Player {email} data reset has completed successfully.

Error

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