Minecraft-UUID-zoekfunctie

De UUID (Universally Unique Identifier) is de vaste, 128 bits lange identificatiecode van een Minecraft Java-account, geschreven als 32 hexadecimale tekens. Met koppeltekens (8-4-4-4-12, de indeling van whitelist.json, ops.json en usercache.json) en zonder koppeltekens (de indeling van de Mojang-API) is het dezelfde waarde. De tool toont beide schrijfwijzen en accepteert beide als invoer. Servers gebruiken de UUID voor de whitelist, ops en bans, voor spelergegevens (vanaf versie 26.1 world/players/data/<uuid>.dat, daarvoor world/playerdata/<uuid>.dat) en statistieken. Plugins zoals LuckPerms koppelen er rechten en gegevens aan.

Het snelst gaat het door de spelersnaam hierboven in de tool in te voeren. Op je eigen server vind je de UUID ook in usercache.json (namen en UUID's van spelers die al zijn toegetreden) en in het logbestand, waar bij het toetreden een regel staat zoals ‘UUID of player Notch is 069a79f4-44e9-4726-a5be-fca90e38aaf5’. Met /data get entity @s UUID toont het spel je eigen UUID als int-array. Vindt de tool niets, controleer dan de schrijfwijze: een Java-naam bestaat uit 3 tot 16 tekens (sommige oude accounts hebben kortere namen) en bevat letters A–Z zonder diakritische tekens, cijfers en underscores. Hoofdletters en kleine letters maken bij het zoeken niet uit. Voor namen zonder Java-account toont de tool toch de offline-UUID.

Nee. Je wijzigt de naam in je profiel op minecraft.net; de UUID blijft hetzelfde. Whitelist, rechten en spelergegevens blijven daardoor behouden, omdat servers ze via de UUID koppelen. Alleen vermeldingen die nog de oude naam bevatten, moet je aanpassen.

Als een server met online-mode=false draait, kan deze spelers niet bij Mojang opzoeken. In plaats daarvan berekent hij de UUID op basis van de naam: de MD5-hash van „OfflinePlayer:<Name>“ levert een versie-3-UUID op. Voor „Notch“ is dat b50ad385-829d-3141-a216-7e7d7539ba7f, dus een heel andere dan de echte. De berekening is hoofdlettergevoelig. Als je de modus wijzigt, worden spelergegevens ineens aan een andere UUID gekoppeld. Inventaris, voortgang en statistieken ontbreken dan totdat je de bestanden in de wereldmap (met gestopte server en een Backup) naar de nieuwe UUID hernoemt: vanaf versie 26.1 in world/players/data, world/players/advancements en world/players/stats, in oudere versies in world/playerdata, world/advancements en world/stats.

Mojang heeft het opvragen van eerdere namen in 2022 uit de openbare API verwijderd. Het oude eindpunt geeft nu alleen nog ‘Not Found’ terug. Dit beschermt de privacy van spelers. Sindsdien bestaat er geen officiële bron meer voor naamgeschiedenis. Sites die nog eerdere namen tonen, gebruiken zelf verzamelde, onvolledige gegevens en zijn niet betrouwbaar. Daarom toont deze tool alleen wat Mojang openbaar bevestigt: de huidige naam bij een UUID en omgekeerd.

Nee, deze tool werkt alleen met de Java Edition. Bedrock-accounts worden geïdentificeerd via de Xbox-gamertag en de XUID. Op servers met Geyser en Floodgate krijgen Bedrock-spelers een UUID die begint met 00000000-0000-0000 en van de XUID is afgeleid. De Mojang-API kan zulke UUID's niet opzoeken.

De gegevens komen rechtstreeks uit de openbare API van Mojang (api.minecraftservices.com en de sessieserver). Het gaat uitsluitend om openbare profielgegevens: naam, UUID en de adressen van de skin en cape. De UUID is een openbare identificatiecode, geen wachtwoord; inloggen is niet nodig om deze op te vragen. Om de aanvraaglimiet van Mojang te omzeilen, slaan we resultaten maximaal 10 minuten tijdelijk op. Een speler die net zijn naam heeft gewijzigd, kan daardoor nog even met de oude naam verschijnen. Als Mojang een aanvraaglimiet meldt, helpt het om een minuut te wachten.

Op een server in onlinemodus volstaat /whitelist add <Name>; de server handelt de rest zelf af. Wil je het bestand rechtstreeks bewerken, kopieer dan de voltooide vermelding uit de tool naar whitelist.json, bijvoorbeeld { "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5", "name": "Notch" }, en voer daarna /whitelist reload uit. Op servers met online-mode=false gebruikt de whitelist in plaats daarvan de offline-UUID van de speler.