Minecraft UUID Lookup

How to Find a Minecraft UUID

1. Enter any Java Edition username - Type a player's current username, or paste a UUID you want to verify.
2. Click "Find UUID" - We'll query Mojang's official API and return the player's permanent UUID, both with and without dashes.
3. Copy what you need - Click any copy button to grab the UUID in the format you need. The dashed format is standard, while the undashed format is used in file names and some plugins.

What is a Minecraft UUID?

A UUID (Universally Unique Identifier) is a permanent 32-character hexadecimal code assigned to every Minecraft Java Edition account by Mojang. It looks like this: 069a79f4-44e9-4726-a5be-fca90e38aaf5 (that's Notch's UUID). Unlike usernames - which players can change every 30 days - UUIDs never change, making them the only reliable way to permanently identify a player.

Why Server Admins Need UUIDs

If you run a Minecraft server, UUIDs are critical for day-to-day administration:

• Whitelisting - The whitelist.json file stores player entries as UUID + username pairs. Adding players by UUID ensures they keep access even after a name change.
• Banning - banned-players.json uses UUIDs so banned players can't rejoin with a different username.
• Permissions - Plugins like LuckPerms, PermissionsEx, and GroupManager all track permissions by UUID, not username.
• Player data - Server player data files (inventories, stats, advancements) are stored as <uuid>.dat in the playerdata/ folder.

How to Add a Player to Your Server Whitelist

The easiest way is the in-game command /whitelist add <username>, which auto-resolves the UUID. But if you're editing whitelist.json directly (common for headless servers), you'll need the UUID. Look it up here, then add an entry like:

{"uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5", "name": "Notch"}

Use the dashed UUID format for whitelist.json.

How to Ban a Player by UUID

Use /ban <username> in-game, or edit banned-players.json directly. This tool's bulk lookup mode is especially useful for importing ban lists from other servers, since you may only have usernames.

UUID for Plugin and Mod Development

If you're developing Bukkit/Spigot plugins, Fabric mods, or Forge mods, you'll frequently need to convert between usernames and UUIDs. While you can use Bukkit.getOfflinePlayer(name).getUniqueId() in-game, this tool is faster for quick lookups during development and doesn't require a running server.

Bulk UUID Lookups

Switch to "Bulk Lookup" mode to resolve multiple usernames at once - perfect for building whitelist files, migrating player data between servers, or batch-processing ban lists. Enter up to 10 usernames at a time.

Frequently Asked Questions