Skip to main content
Em agosto de 2026, corrigimos um problema que causava erros de permissão (HTTP 401) ao redefinir dados do jogador por XUID, mesmo para contas às quais as permissões corretas do Partner Center haviam sido concedidas. Essa correção foi feita no back end dos serviços XBOX, portanto é aplicada automaticamente. Você não precisa instalar uma nova versão do GDK, do pacote de Ferramentas dos serviços XBOX ou da própria ferramenta. Se você encontrou esse erro anteriormente e o contornou, ou foi informado de que suas permissões do Partner Center estavam configuradas incorretamente, pode tentar usar a ferramenta novamente seguindo as etapas abaixo. A permissão “Tools Access” descrita em Redefinir por XUID continua sendo obrigatória.
A ferramenta de redefinição de dados do jogador pode ser usada para redefinir os dados de um jogador ou de um grupo de jogadores em sandboxes de teste. Você pode redefinir dados como conquistas, leaderboards, estatísticas e histórico de títulos. Uma conta individual pode ser redefinida pelo endereço de e-mail ou pelo XUID. Para redefinir por XUID, você deve primeiro executar a ferramenta XblDevAccount.exe para entrar na conta do Partner Center proprietária da conta a ser redefinida. Para redefinir pelo endereço de e-mail da conta de teste, você precisará saber a senha da conta de teste. A ferramenta não redefine o Connected Storage do jogador (jogos salvos). Para gerenciar o Connected Storage, veja Ferramenta de Connected Storage (XblConnectedStorage.exe). Esta ferramenta de linha de comando faz parte do GDK e, separadamente, do pacote de Ferramentas dos serviços XBOX. Para saber como obter a ferramenta XblPlayerDataReset.exe, veja Ferramentas de desenvolvimento para serviços XBOX. As opções --xuid, --user e --file são mutuamente exclusivas. Especifique exatamente uma delas, junto com --scid e --sandbox.

​
Redefinir por XUID

Para usar a ferramenta de redefinição de dados do jogador para redefinir um usuário pelo XUID, a conta de desenvolvedor usada para entrar (com XblDevAccount.exe) deve ter a permissão adequada para o produto específico. Observe que “Tools Access” não é uma permissão em nível de conta, é uma permissão em nível de produto. Portanto, você deve conceder a permissão “Tools Access” para cada produto individual cujos dados de jogador você deseja redefinir.
  1. Entre no Partner Center com uma conta de desenvolvedor que tenha privilégios administrativos.
  2. Navegue até a configuração da conta => página Usuários.
  3. Clique no usuário ou grupo que precisa da permissão “Tools Access”.
  4. Se o usuário ou grupo estiver atualmente atribuído a uma função padrão (como Developer), você precisa mudar para “Customize permissions”.
  5. Na próxima página, vá até a tabela de permissões “Product-level”, expanda o cabeçalho da tabela “XBOX Live” e localize a coluna “Tools access”.
  6. Marque explicitamente essa caixa para os produtos ou grupos de produtos aos quais você deseja conceder a permissão “Tools Access”.
Quando as permissões estiverem configuradas, os dados da conta de teste podem então ser redefinidos da seguinte forma:

​
Redefinir por endereço de e-mail

Para redefinir por endereços de e-mail de contas de teste, você precisará saber a senha de cada conta de teste. Use o comando abaixo, que abrirá uma janela para você entrar como o usuário de teste:

​
Redefinir por arquivo

Para redefinir por arquivo, você pode passar a localização de um arquivo delimitado de XUIDs, um arquivo delimitado de e-mails ou uma exportação de contas do Partner Center.
Para um arquivo delimitado, a ferramenta inspeciona a primeira linha para decidir como ler o arquivo. Se essa linha contiver um caractere @, o arquivo inteiro é tratado como uma lista de endereços de e-mail; caso contrário, é tratado como uma lista de XUIDs. Não inclua uma linha de cabeçalho em um arquivo delimitado, porque ela é interpretada como uma conta. Uma exportação de contas do Partner Center é detectada automaticamente, mas apenas quando a linha de cabeçalho original está presente e sem modificações:
Se você abrir a exportação em um aplicativo de planilhas e salvá-la com colunas reordenadas ou renomeadas, o cabeçalho não é mais reconhecido e o arquivo é lido como um arquivo delimitado comum.
Entre com o XblDevAccount.exe antes de redefinir a partir de uma exportação de contas do Partner Center. Quando uma conta do Partner Center está conectada, a ferramenta lê a coluna Xuid e redefine as contas sem solicitações adicionais. Quando nenhuma conta está conectada, ela recorre à coluna Email e solicita a senha de cada conta do arquivo.

​
Opção de delimitador

Opcionalmente, você pode definir um delimitador personalizado para as opções --xuid e --user, e para arquivos delimitados passados para --file. O delimitador padrão é uma vírgula (,).
Apenas o primeiro caractere do valor é usado. Se você passar um valor com mais de um caractere, os caracteres restantes são ignorados em vez de tratados como um delimitador de vários caracteres. O delimitador é ignorado quando o arquivo passado para --file é uma exportação de contas do Partner Center, porque esse formato é sempre separado por vírgulas.

​
Como as contas são processadas

A maneira como as contas são processadas depende da opção que você usa. Quando você redefine por XUID, ou a partir de um arquivo que resolve para XUIDs, as contas são processadas em lotes de até 10. As contas dentro de um lote são redefinidas em paralelo, e os lotes são executados um após o outro. Quando você redefine por endereço de e-mail, as contas são processadas uma de cada vez, porque cada conta precisa ser conectada individualmente. Se alguma conta de teste falhar ao entrar, a ferramenta para imediatamente e as contas restantes da lista não são tentadas. Cada conta é automaticamente tentada novamente até cinco vezes antes de ser reportada como com falha, e a ferramenta aguarda o serviço concluir cada redefinição antes de prosseguir. Uma única conta pode, portanto, levar até cerca de um minuto para reportar um resultado final. Deixe a ferramenta terminar em vez de cancelá-la, especialmente quando estiver redefinindo uma lista grande.

​
Saída

Se o comando for bem-sucedido ou falhar, você verá uma saída semelhante à listada abaixo. Success
Error
Uma redefinição também pode atingir o tempo limite. Um tempo limite significa que a ferramenta parou de aguardar um resultado, não que a redefinição definitivamente falhou. O trabalho ainda pode ser concluído no serviço.

​
Códigos de saída

A ferramenta retorna 0 quando é bem-sucedida e -1 quando falha. Quando você chama a ferramenta a partir de um script ou de um teste automatizado, verifique o código de saída em vez de confiar no texto do console.
A ferramenta também retorna 0 em dois casos em que nada é redefinido: quando nenhuma das opções --xuid, --user ou --file é especificada, e quando o arquivo passado para --file não pode ser lido. Se sua automação verifica apenas o código de saída, esses casos podem parecer uma execução bem-sucedida. Confirme que a saída inclui uma linha de resultado para cada conta que você esperava redefinir.

​
Solução de problemas

​
Unable to authorize the account with XBOX Live

Esta mensagem acompanha um erro HTTP 401. Antes de agosto de 2026, um problema no lado do serviço causava esse erro para todos os desenvolvedores que redefiniam por XUID, incluindo desenvolvedores cujas permissões do Partner Center estavam configuradas corretamente. Esse problema foi corrigido, e a correção não exigiu uma atualização da ferramenta ou do GDK. Se você ainda vir esse erro, confirme que a conta conectada tem a permissão “Tools Access” para o produto, conforme descrito em Redefinir por XUID, e que o SCID e a sandbox correspondem ao produto que você está direcionando. Se você alterou permissões no Partner Center recentemente, saia e entre novamente com o XblDevAccount.exe para que um novo token seja emitido.

​
Your account doesn’t have access to perform the operation

Esta mensagem acompanha um erro HTTP 403. Conceda a permissão “Tools Access” para o produto, conforme descrito em Redefinir por XUID.

​
Resetting by XUID requires a signed in Partner Center account

Execute XblDevAccount.exe signin antes de redefinir por XUID, ou antes de redefinir a partir de uma exportação de contas do Partner Center.

​
Failed to log in to test account

A ferramenta não conseguiu entrar na conta de teste. Verifique o endereço de e-mail e a senha, e confirme que a conta pertence à sandbox que você passou para --sandbox. A ferramenta para quando isso acontece, portanto quaisquer contas restantes da sua lista não são redefinidas.
Última modificação em 28 de agosto de 2026

Tópicos relacionados

Notas de versão do SDK C++ do PlayFab MultiplayerDiretório de tópicos NDA: links ativos do Microsoft LearnExemplos do GDKInstale a cadeia de ferramentas do GDKCompile e execute seu primeiro título de console com o GDKX