How to Find a Minecraft Player's UUID, Arr!
A scallywag's guide to fetchin' UUID, XUID, Floodgate UUID, name history and skin for any Java or Bedrock player.
Hunt a PlayerTry yer luck: Notch · jeb_ · Technoblade · Dream · Grian
Also: Plunder skins · Cape gallery · API Scrolls · JSON Wizard · Cached crew · Ship Status
Guide Features
What be a Minecraft UUID?
UUID = Universally Unique Identifier — a 32-character hex string that never changes, like a pirate's brand.
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 be 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 — free as the open sea.
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 ye 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 JSON files fer Bedrock Dedicated Server. We do, savvy?
Frequently Asked Questions
What be 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 be XUID fer 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 be 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.
Be it free?
Aye! The Profile Lookup and JSON Generator be 100% free. No signup, no API key, no limits.
How do I add a scallywag 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 the UUID change when a player changes their name?
Nay. The Java UUID never changes. That be why servers use UUID fer bans and whitelists.
Should I ban by name 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 yer spellin'. Java names be 3–16 characters. The account may be inactive or Bedrock only.
UUID with or without dashes?
Both work. 853c80ef3e3740fdaa867b06307a3d4f (no hyphens) and 853c80ef-3e37-40fd-aa86-7b06307a3d4f (with hyphens) are valid. Minecraft accepts both.