Home / Minecraft UUID Lookup

Minecraft UUID Lookup

Enter a Minecraft Java Edition username to find their UUID - used for whitelist files, ban lists, plugin data, and skin/avatar URLs.

How Minecraft UUIDs work

Every Minecraft Java Edition account has a permanent UUID tied to its username history - even if the player changes their name, the UUID stays the same. This is why server plugins, ban lists, and whitelist files store UUIDs instead of usernames.

Dashed vs undashed format

Mojang's API returns UUIDs without dashes (e.g. 069a79f444e94726a5befca90e38aaf6), but most Minecraft files (like whitelist.json and usercache.json) expect the standard dashed format (069a79f4-44e9-4726-a5be-fca90e38aaf6). This tool always shows the dashed format ready to paste.

Offline-mode (cracked server) UUIDs

Servers running in offline mode generate a UUID v3 locally from the username instead of looking it up from Mojang, so a player's offline-mode UUID will differ from their real online-mode UUID. This lookup tool only returns the official Mojang (online-mode) UUID.

Common uses for a Minecraft UUID

  • Adding a player to whitelist.json or ops.json manually
  • Looking up a player's avatar: https://crafatar.com/avatars/<uuid>
  • Storing player data in a plugin database, keyed by UUID instead of username
  • Investigating ban records after a player has changed their username

Related

What is a UUID? Main UUID Generator