How to Find a Minecraft Player's UUID
Step-by-step guide to get UUID, XUID, Floodgate UUID, name history, and skin for any Java or Bedrock player.
Look Up a Player NowTry: Notch · jeb_ · Technoblade · Dream · Grian
Also: Skin downloads · Cape gallery · API · JSON List Wizard · Cached players · Server Status
Guide Features
What is a Minecraft UUID?
UUID = Universally Unique Identifier — a 32-character hex string that never changes.
Every Java Edition player has a UUID assigned by Mojang. It looks like 853c80ef3e3740fdaa867b06307a3d4f (no hyphens) or 853c80ef-3e37-40fd-aa86-7b06307a3d4f (with hyphens).
Why it matters: Usernames can change. UUIDs cannot. Servers use UUIDs for banned-players.json, whitelist.json, and ops.json so bans and whitelists stay correct even when a player renames.
853c80ef3e3740fdaa867b06307a3d4f (32 hex chars, no hyphens) or 853c80ef-3e37-40fd-aa86-7b06307a3d4f (with hyphens). Both work.What is XUID (Bedrock)?
XUID is the unique ID for Bedrock Edition players — Xbox, mobile, Windows 10, Nintendo Switch. It's a long decimal number (e.g. 2535412345678901).
Floodgate UUID: For GeyserMC cross-play servers, Bedrock players get a special Floodgate UUID that starts with 00000000-0000-0000. Our lookup returns both XUID and Floodgate UUID for Bedrock players.
Step-by-Step: Find a UUID
Four simple steps. No account, no API key, no limits.
Notch, Technoblade), Bedrock gamertag, or an existing UUID to reverse-lookup. banned-players.json, whitelist.json, or ops.json. For Bedrock: use our JSON List Wizard to generate permissions.json, allowlist.json, banned-players-bedrock.json. GET https://vrc.lol/api?username=Notch returns JSON with the UUID.- Always use UUID for bans — Never ban by username. If a player renames, a username-based ban won't work.
- Java vs Bedrock — Java uses UUID; Bedrock uses XUID. They're different. Our lookup returns both when available.
- GeyserMC cross-play — Use the Floodgate UUID for Bedrock players joining Java servers via GeyserMC.
- Banning by username — Bans won't persist if the player renames. Always use UUID.
- Mixing Java and Bedrock IDs — UUID for Java servers, XUID for Bedrock. Don't use them interchangeably.
- Wrong file format — Java uses
banned-players.json; Bedrock usesbanned-players-bedrock.json. Different structure.
Use Cases
What you can do with a Minecraft UUID:
- Ban a player — Add UUID to
banned-players.json. The ban persists even if they change their username. - Whitelist — Add UUID to
whitelist.jsonso only approved players can join. - Ops — Add UUID to
ops.jsonto grant operator permissions. - Plugins & mods — Many plugins need UUID to identify players (economy, permissions, etc.).
- Discord bots — Link Discord accounts to Minecraft via UUID.
- Leaderboards — Store UUID instead of username so name changes don't break stats.
JSON Lists & Bedrock Servers
Our JSON List Wizard builds server config files from lookups. No manual editing.
Java Edition
Export to banned-players.json, whitelist.json, or ops.json. One click adds a player with correct UUID format.
Example banned-players.json entry: { "uuid": "853c80ef3e3740fdaa867b06307a3d4f", "name": "jeb_", "source": "Server", "expires": "forever", "reason": "Banned" }
Example whitelist.json entry: { "uuid": "853c80ef3e3740fdaa867b06307a3d4f", "name": "jeb_" }
Where files go: Place in your server's root folder (same level as server.properties). Restart the server or use /whitelist reload / /banlist to apply.
Bedrock Edition
Generate permissions.json (operator, member, visitor), allowlist.json, and banned-players-bedrock.json. Enter Xbox gamertags — we fetch XUIDs automatically. Add Floodgate UUID for GeyserMC cross-play.
No other free site generates Bedrock Dedicated Server JSON files. We do.
Frequently Asked Questions
What is a Minecraft UUID?
A UUID (Universally Unique Identifier) is a 32-character hex string that uniquely identifies a Java Edition player. It never changes, even if the player changes their username.
What is XUID for Bedrock?
XUID is the unique ID for Bedrock Edition players (Xbox, mobile, Windows 10). Our tool returns it in both decimal and hexadecimal formats.
What is a Floodgate UUID?
A Floodgate UUID is used by GeyserMC Floodgate to represent Bedrock players on Java servers. It starts with 00000000-0000-0000 and includes the player's XUID. We provide it for cross-play setups.
Is this free?
Yes. The Minecraft Profile Lookup and JSON List Wizard are 100% free. No sign-up, no API key, no limits.
How do I add a player to banned-players.json?
Look up the player at vrc.lol/player, then use the JSON List Wizard to add them with one click. Or copy the UUID and add it manually.
Does UUID change when a player changes their name?
No. The Java UUID never changes. That's why servers use UUID for bans and whitelists — usernames can change, UUIDs don't.
Should I ban by username or UUID?
Always use UUID. Usernames can change; UUIDs cannot. A ban by username will fail if the player renames. Our JSON List Wizard adds the correct UUID automatically.
What if the player doesn't exist?
Check spelling. Java usernames are 3–16 characters. The account may be inactive or Bedrock-only — try searching by Xbox gamertag.
UUID with or without hyphens?
Both work. 853c80ef3e3740fdaa867b06307a3d4f (no hyphens) and 853c80ef-3e37-40fd-aa86-7b06307a3d4f (with hyphens) are valid. Minecraft accepts both.