Skip to main content
En agosto de 2026, corregimos un problema que causaba errores de permisos (HTTP 401) al restablecer los datos de jugador por XUID, incluso para cuentas a las que se les habían concedido los permisos correctos de Partner Center. Esta corrección se realizó en el back-end de los servicios XBOX, por lo que se aplica automáticamente. No necesitas instalar una nueva versión del GDK, del paquete de herramientas de los servicios XBOX ni de la propia herramienta. Si anteriormente te encontraste con este error y lo solucionaste con un método alternativo, o se te indicó que tus permisos de Partner Center estaban mal configurados, puedes volver a intentar usar la herramienta siguiendo los pasos que se indican a continuación. El permiso “Tools Access” descrito en Restablecer por XUID sigue siendo obligatorio.
La herramienta de restablecimiento de datos de jugador puede usarse para restablecer los datos de un jugador o de un grupo de jugadores en sandboxes de prueba. Puedes restablecer datos como logros, tablas de clasificación, estadísticas e historial de títulos. Una cuenta individual puede restablecerse mediante su dirección de correo electrónico o su XUID. Para restablecer por XUID, primero debes ejecutar la herramienta XblDevAccount.exe para iniciar sesión en la cuenta de Partner Center propietaria de la cuenta que se va a restablecer. Para restablecer mediante la dirección de correo electrónico de la cuenta de prueba, necesitarás conocer la contraseña de la cuenta de prueba. La herramienta no restablece el almacenamiento conectado (partidas guardadas) de un jugador. Para administrar el almacenamiento conectado, consulta Herramienta de Connected Storage (XblConnectedStorage.exe). Esta herramienta de línea de comandos forma parte del GDK y, por separado, del paquete de herramientas de los servicios XBOX. Para saber cómo obtener la herramienta XblPlayerDataReset.exe, consulta Herramientas de desarrollo para los servicios XBOX. Las opciones --xuid, --user y --file son mutuamente excluyentes. Especifica exactamente una de ellas, junto con --scid y --sandbox.

Restablecer por XUID

Para usar la herramienta de restablecimiento de datos de jugador para restablecer un usuario mediante su XUID, la cuenta de desarrollador utilizada para iniciar sesión (con XblDevAccount.exe) debe tener el permiso adecuado para el producto específico. Ten en cuenta que “Tools Access” no es un permiso a nivel de cuenta, sino un permiso a nivel de producto. Por lo tanto, debes conceder el permiso “Tools Access” para cada uno de los productos cuyos datos de jugador quieras restablecer.
  1. Inicia sesión en Partner Center con una cuenta de desarrollador que tenga privilegios administrativos.
  2. Ve a la configuración de la cuenta => página Usuarios.
  3. Haz clic en el usuario o grupo que necesita el permiso “Tools Access”.
  4. Si el usuario o grupo está asignado actualmente a un rol estándar (como Developer), debes cambiar a “Customize permissions”.
  5. En la página siguiente, ve a la tabla de permisos “Product-level”, expande el encabezado de tabla “XBOX Live” y busca la columna “Tools access”.
  6. Marca explícitamente esa casilla para los productos o grupos de productos a los que quieras conceder el permiso “Tools Access”.
Una vez configurados los permisos, los datos de la cuenta de prueba pueden restablecerse de la siguiente manera:

Restablecer por dirección de correo electrónico

Para restablecer mediante las direcciones de correo electrónico de las cuentas de prueba, necesitarás conocer la contraseña de cada cuenta de prueba. Usa el siguiente comando, que abrirá una ventana emergente para que inicies sesión como el usuario de prueba:

Restablecer por archivo

Para restablecer por archivo, puedes pasar la ubicación de un archivo delimitado de XUID, un archivo delimitado de correos electrónicos o una exportación de cuentas de Partner Center.
Para un archivo delimitado, la herramienta inspecciona la primera línea para decidir cómo leer el archivo. Si esa línea contiene un carácter @, todo el archivo se trata como una lista de direcciones de correo electrónico; de lo contrario, se trata como una lista de XUID. No incluyas una fila de encabezado en un archivo delimitado, porque se analiza como si fuera una cuenta. Una exportación de cuentas de Partner Center se detecta automáticamente, pero solo cuando la fila de encabezado original está presente y sin modificar:
Si abres la exportación en una aplicación de hojas de cálculo y la guardas con las columnas reordenadas o renombradas, el encabezado deja de reconocerse y el archivo se lee como un archivo delimitado ordinario.
Inicia sesión con XblDevAccount.exe antes de restablecer desde una exportación de cuentas de Partner Center. Cuando hay una cuenta de Partner Center con sesión iniciada, la herramienta lee la columna Xuid y restablece las cuentas sin más indicaciones. Cuando no hay ninguna cuenta con sesión iniciada, recurre a la columna Email y te solicita la contraseña de cada una de las cuentas del archivo.

Opción de delimitador

Opcionalmente, puedes establecer un delimitador personalizado para las opciones --xuid y --user, y para los archivos delimitados pasados a --file. El delimitador predeterminado es una coma (,).
Solo se usa el primer carácter del valor. Si pasas un valor de más de un carácter, los caracteres restantes se ignoran en lugar de tratarse como un delimitador de varios caracteres. El delimitador se ignora cuando el archivo pasado a --file es una exportación de cuentas de Partner Center, porque ese formato siempre está separado por comas.

Cómo se procesan las cuentas

La forma en que se procesan las cuentas depende de la opción que uses. Cuando restableces por XUID, o desde un archivo que se resuelve en XUID, las cuentas se procesan en lotes de hasta 10. Las cuentas dentro de un lote se restablecen en paralelo, y los lotes se ejecutan uno tras otro. Cuando restableces por dirección de correo electrónico, las cuentas se procesan una a una, porque cada cuenta debe iniciar sesión individualmente. Si alguna cuenta de prueba no logra iniciar sesión, la herramienta se detiene de inmediato y no se intentan las cuentas restantes de la lista. Cada cuenta se reintenta automáticamente hasta cinco veces antes de notificarse como fallida, y la herramienta espera a que el servicio termine cada restablecimiento antes de continuar. Por lo tanto, una sola cuenta puede tardar hasta aproximadamente un minuto en notificar un resultado final. Deja que la herramienta termine en lugar de cancelarla, especialmente cuando estés restableciendo una lista grande.

Salida

Si el comando se ejecuta correctamente o falla, verás una salida similar a la que se muestra a continuación. Success
Error
Un restablecimiento también puede agotar el tiempo de espera. Un tiempo de espera agotado significa que la herramienta dejó de esperar un resultado, no que el restablecimiento haya fallado definitivamente. El trabajo aún puede completarse en el servicio.

Códigos de salida

La herramienta devuelve 0 cuando se ejecuta correctamente y -1 cuando falla. Cuando llames a la herramienta desde un script o una pasada de pruebas automatizada, comprueba el código de salida en lugar de basarte en el texto de la consola.
La herramienta también devuelve 0 en dos casos en los que no se restablece nada: cuando no se especifica ninguna de las opciones --xuid, --user o --file, y cuando el archivo pasado a --file no puede leerse. Si tu automatización solo comprueba el código de salida, estos casos pueden parecer una ejecución correcta. Confirma que la salida incluye una línea de resultado para cada cuenta que esperabas restablecer.

Solución de problemas

Unable to authorize the account with XBOX Live

Este mensaje acompaña a un error HTTP 401. Antes de agosto de 2026, un problema en el lado del servicio causaba este error a todos los desarrolladores que restablecían por XUID, incluidos los desarrolladores cuyos permisos de Partner Center estaban configurados correctamente. Ese problema se ha corregido, y la corrección no requirió una actualización de la herramienta ni del GDK. Si sigues viendo este error, confirma que la cuenta con sesión iniciada tiene el permiso “Tools Access” para el producto, como se describe en Restablecer por XUID, y que el SCID y el sandbox coinciden con el producto al que te diriges. Si cambiaste los permisos en Partner Center recientemente, cierra sesión y vuelve a iniciarla con XblDevAccount.exe para que se emita un token nuevo.

Your account doesn’t have access to perform the operation

Este mensaje acompaña a un error HTTP 403. Concede el permiso “Tools Access” para el producto, como se describe en Restablecer por XUID.

Resetting by XUID requires a signed in Partner Center account

Ejecuta XblDevAccount.exe signin antes de restablecer por XUID, o antes de restablecer desde una exportación de cuentas de Partner Center.

Failed to log in to test account

La herramienta no pudo iniciar sesión en la cuenta de prueba. Verifica la dirección de correo electrónico y la contraseña, y confirma que la cuenta pertenece al sandbox que pasaste a --sandbox. La herramienta se detiene cuando esto ocurre, por lo que las cuentas restantes de tu lista no se restablecen.
Última modificación el 28 de agosto de 2026