MCTOOLBOX
MC ToolboxMC TOOLBOX

Java account

Minecraft UUID Lookup

Check if a Java name is taken, resolve a UUID to the current username, or scan a list. Copy hyphenated and trimmed UUIDs for whitelist.json.

3–16 characters: letters, numbers, underscore.

What a Minecraft UUID is and how to look one up

A UUID is the 32-character id Mojang assigns to a Java account. Usernames change. The UUID does not. Whitelist.json, bans, LuckPerms, and most plugins should store the UUID so a rename does not break the file.

Use Java name to see if a name already has a public Mojang profile. Use UUID lookup when you have a log line or a banned player id and need the current username. Use Batch when you are checking a short list for a realm or smp.

Two writings of the same UUID exist. The trimmed form is 32 hex digits. The hyphenated form is 8-4-4-4-12. whitelist.json wants hyphens. Some plugins accept either. Offline (cracked) servers do not ask Mojang; they hash OfflinePlayer: plus the name, so that UUID will not match the Mojang one.

A name that shows as free is missing from Mojang right now. This page does not reserve it. Mojang can still reject the name at signup. Bedrock gamertags live on Xbox and are not confirmed here.

UUID lookup FAQ

How do I find my Minecraft UUID?

Switch to UUID lookup and paste your current Java username, or paste a UUID from a log. The tool returns the current name and both UUID writings.

Does my UUID change if I rename?

No. Only the username on the profile changes.

What is the difference between trimmed and hyphenated UUID?

Same 32 hex digits. Hyphenated form is 8-4-4-4-12. Use that in whitelist.json.

Can I get a username from a UUID?

Yes. Paste the UUID in UUID lookup. Mojang returns the current name on that account.

If a name shows as available, can I claim it?

It is not on Mojang right now. Signup can still fail. This tool does not lock names.

Do I need to log in?

No. Lookups use Mojang public profile endpoints only.