Java Edition
Java server files use UUIDs in banned-players.json, whitelist.json, and ops.json.
What is a Minecraft UUID?
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.
What is a Minecraft UUID?
UUID = Universally Unique Identifier — a 32-character hex string that never changes.
What is XUID (Bedrock)?
Bedrock players use an Xbox XUID. GeyserMC and Floodgate also derive a Floodgate UUID; neither value is a Java UUID.
Step-by-Step: Find a UUID
Four clear steps. No account or API key required.
- Open the profile lookup.
- Enter a Java username, Bedrock gamertag, UUID, or XUID.
- Check the edition badge and keep Java UUID fields separate from Bedrock XUID fields.
- Copy the identifier or open the JSON List Wizard to build server files.
Use Cases
What you can do with a Minecraft UUID:
Use durable identifiers for bans, allowlists, operator permissions, plugins, account linking, and leaderboards so name changes do not break records.
JSON lists for Java and Bedrock servers
Bedrock Edition
Bedrock server files use XUIDs in permissions.json, allowlist.json, and banned-players-bedrock.json. Floodgate UUIDs support GeyserMC cross-play.
The wizard generates Java and Bedrock server-list formats while keeping UUID and XUID fields clearly separate.
JSON List WizardFrequently Asked Questions
What is a Minecraft UUID?
A Java UUID is a permanent 128-bit identifier. It does not change when the player changes their username.
What is XUID for Bedrock?
An XUID identifies an Xbox account used by Bedrock Edition and can be displayed in decimal or hexadecimal form.
What is a Floodgate UUID?
Floodgate uses a UUID derived from Bedrock identity data so a Bedrock player can be represented on a Java server through GeyserMC.
Is this free?
Yes. The Minecraft Profile Lookup and JSON List Wizard are 100% free. No sign-up and no API key.
How do I add a player to banned-players.json?
Look up the player, verify the Java edition record, then add the UUID to banned-players.json or use the JSON List Wizard.
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?
Use a UUID for Java bans. Usernames can change, but the UUID remains attached to the account.
VRC.LOL · Discord
Join our Discord
Ask for help, share feedback, and meet the VRC.LOL community.