Consulta de UUID de Minecraft

La UUID (Universally Unique Identifier) es el identificador permanente de 128 bits de una cuenta de Minecraft Java, escrito con 32 caracteres hexadecimales. Con guiones (8-4-4-4-12, el formato de whitelist.json, ops.json y usercache.json) y sin guiones (el formato de la API de Mojang) es el mismo valor; la herramienta muestra ambos formatos y acepta ambos como entrada. Los servidores usan la UUID para la lista blanca, los operadores y los bloqueos, para los datos de los jugadores (desde la versión 26.1 en world/players/data/<uuid>.dat; antes, en world/playerdata/<uuid>.dat) y las estadísticas. Plugins como LuckPerms también la usan para asociar permisos y datos.

La forma más rápida es introducir el nombre del jugador en la herramienta de arriba. En tu propio servidor también puedes encontrarla en usercache.json (nombres y UUID de los jugadores que ya han entrado) y en el registro, donde al entrar aparece una línea como «UUID of player Notch is 069a79f4-44e9-4726-a5be-fca90e38aaf5». Con /data get entity @s UUID, el juego te muestra tu propia UUID como una matriz de enteros. Si la herramienta no encuentra resultados, comprueba el nombre: un nombre de Java tiene entre 3 y 16 caracteres (algunas cuentas antiguas admiten menos) y solo puede contener letras de la A a la Z sin tildes, números y guiones bajos. La búsqueda no distingue entre mayúsculas y minúsculas, y la herramienta muestra la UUID sin conexión incluso para nombres sin cuenta de Java.

No. Puedes cambiar el nombre en tu perfil de minecraft.net; la UUID seguirá siendo la misma. Por eso se conservan la lista de permitidos, los permisos y los datos del jugador, ya que los servidores los asocian mediante la UUID. Solo deberías actualizar las entradas que aún contengan el nombre anterior.

Si un servidor funciona con online-mode=false, no puede consultar los jugadores en Mojang. En su lugar, calcula la UUID a partir del nombre: el hash MD5 de «OfflinePlayer:<Name>» genera una UUID de versión 3. Para «Notch», es b50ad385-829d-3141-a216-7e7d7539ba7f, muy distinta de la real. El cálculo distingue entre mayúsculas y minúsculas. Si cambias de modo, los datos del jugador quedan asociados a otra UUID. El inventario, los avances y las estadísticas dejarán de aparecer hasta que cambies el nombre de los archivos de la carpeta del mundo a la nueva UUID (con el servidor detenido y un Backup): a partir de la versión 26.1, en world/players/data, world/players/advancements y world/players/stats; en versiones anteriores, en world/playerdata, world/advancements y world/stats.

Mojang eliminó de su API pública la consulta de nombres anteriores en 2022; el antiguo punto de conexión ahora solo devuelve «Not Found». El motivo es proteger la privacidad de los jugadores. Desde entonces no existe ninguna fuente oficial para consultar el historial de nombres. Las páginas que aún muestran nombres anteriores se basan en datos recopilados por ellas mismas, incompletos y poco fiables. Por eso, esta herramienta solo muestra lo que Mojang confirma públicamente: el nombre actual asociado a una UUID y viceversa.

No, la herramienta solo funciona con Java Edition. Las cuentas de Bedrock se identifican mediante el gamertag de Xbox y la XUID. En servidores con Geyser y Floodgate, los jugadores de Bedrock reciben una UUID que empieza por 00000000-0000-0000 y se deriva de la XUID. La API de Mojang no puede consultar esas UUID.

Los datos proceden directamente de la API pública de Mojang (api.minecraftservices.com y el servidor de sesiones). Son exclusivamente datos públicos del perfil: nombre, UUID y direcciones de la skin y la capa. La UUID es un identificador público, no una contraseña, y no necesitas iniciar sesión para consultarla. Para evitar el límite de consultas de Mojang, almacenamos los resultados en caché durante un máximo de 10 minutos. Por eso, un jugador que acaba de cambiar de nombre puede aparecer brevemente con el anterior. Si Mojang indica que se ha alcanzado el límite de consultas, espera un minuto.

En un servidor en modo online, basta con /whitelist add <Name>; el servidor se encarga del resto. Si quieres editar el archivo directamente, copia la entrada generada por la herramienta en whitelist.json, por ejemplo { "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5", "name": "Notch" }, y después ejecuta /whitelist reload. En servidores con online-mode=false, la lista blanca utiliza en su lugar el UUID offline del jugador.