免费 无需注册 无广告

如何查找Minecraft玩家UUID

获取任何Java或Bedrock版玩家的UUID、XUID、Floodgate UUID、名称历史和皮肤的分步指南。

查找玩家

试试： Notch · jeb_ · Technoblade · Dream · Grian

更多： 下载皮肤 · 披风画廊 · API · JSON生成器 · 已缓存玩家 · 服务器状态

Java & Bedrock
JSON列表
即时查询
名称历史
皮肤 & 披风

什么是Minecraft UUID？

UUID = 通用唯一标识符 — 永不改变的32位十六进制字符串。

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.

Format: Java UUID can be 853c80ef3e3740fdaa867b06307a3d4f (32 hex chars, no hyphens) or 853c80ef-3e37-40fd-aa86-7b06307a3d4f (with hyphens). Both work.

什么是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.

Quick reference: Java = UUID (32 hex). Bedrock = XUID (decimal). GeyserMC = Floodgate UUID (starts with 00000000). All three are different — use the right one for your server type.

分步指南：查找UUID

四个简单步骤。无需账号、无需API密钥、无限制。

1
Open the Profile Lookup — Go to vrc.lol/player. Our free Minecraft profile lookup. Works for Java and Bedrock.
2
Enter username or UUID — Type the player's Java username (e.g. Notch, Technoblade), Bedrock gamertag, or an existing UUID to reverse-lookup.
3
View the results — See UUID (Java), XUID (Bedrock), Floodgate UUID, name history, skin, and cape. Copy any value with one click.
4
Use the data — For Java: add to 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.
Tip: Use our API to fetch UUID programmatically — 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 uses banned-players-bedrock.json. Different structure.

使用场景

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.json so only approved players can join.
  • Ops — Add UUID to ops.json to 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列表 & Bedrock服务器

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.

没有其他免费网站为Bedrock Dedicated Server生成JSON文件。我们可以。

常见问题

什么是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.

Bedrock的XUID是什么？
XUID is the unique ID for Bedrock Edition players (Xbox, mobile, Windows 10). Our tool returns it in both decimal and hexadecimal formats.

什么是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.

免费吗？
是的。个人资料查询和JSON生成器完全免费。无需注册、无需API密钥、无限制。

如何将玩家添加到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.

改名后UUID会变吗？
不会。Java UUID永不改变。这就是服务器使用UUID进行封禁和白名单的原因。

按名称还是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.

如果玩家不存在怎么办？
检查拼写。Java名称为3-16个字符。账号可能未激活或仅限Bedrock版。

UUID带连字符还是不带？
Both work. 853c80ef3e3740fdaa867b06307a3d4f (no hyphens) and 853c80ef-3e37-40fd-aa86-7b06307a3d4f (with hyphens) are valid. Minecraft accepts both.

查找玩家 JSON生成器 API文档 下载皮肤 披风画廊