Tools · Players
UUID Batch Lookup
Migrating whitelists, importing Discord applicants, or auditing staff — paste up to 50 Java usernames and get Mojang UUIDs as CSV.
One username per line or comma-separated. Max 50 names per lookup — Mojang rate limits apply.
When bulk UUID lookup saves time
Server transfers: export names from old host, batch lookup, rebuild whitelist.json. Staff onboarding: verify applicants resolve to real Mojang accounts. Database cleanup: find usernames that no longer exist after name changes.
whitelist.json entry format after lookup
Each found player needs an entry in whitelist.json: {"uuid":"...","name":"..."}. The whitelist creator generates this automatically — batch lookup gives you raw UUIDs to assemble manually or import elsewhere.
Batch lookup limits and tips
| Limit | Value | Tip |
|---|---|---|
| Max names per run | 50 | Split larger lists into batches |
| Name format | Java username | Not Bedrock Gamertag |
| Export formats | CSV, UUID list | Use whitelist creator for JSON |
| Server mode | online-mode=true | Use offline UUID generator otherwise |
How to use this tool
- 1
Paste usernames
Enter Java Edition usernames one per line or comma-separated — up to 50 per batch. Remove Bedrock Gamertags; they will not resolve.
- 2
Run lookup
Click Look up UUIDs. Found names return Mojang UUIDs; not-found names show an error reason. Mojang rate limits apply on large lists.
- 3
Export results
Copy CSV for spreadsheets or Copy UUIDs for bulk paste into plugins. For ready-made whitelist.json use the whitelist creator instead.
Frequently asked questions
How many usernames can I look up at once?
Up to 50 per batch. Split larger lists into multiple runs. Mojang rate-limits API requests.
What format is the CSV export?
username,uuid,status — status is found or not found. Copy UUIDs button exports one UUID per line only.
Why is a username not found?
Bedrock-only account, typo, offline-mode alias, or name change still propagating. Must be current Java username.
Can I use these UUIDs for offline-mode servers?
No. Use the offline UUID generator for cracked servers. These are Mojang UUIDs for online-mode=true only.
How is batch lookup different from whitelist creator?
Batch lookup returns table/CSV for auditing or external imports. Whitelist creator outputs formatted whitelist.json ready for your server folder.
Do name changes affect stored UUIDs?
UUID stays the same when a player changes username. Old names in your list may not resolve — look up their current name instead.
Can I merge batch results into an existing whitelist?
Copy UUIDs into whitelist creator or manually add entries to whitelist.json with uuid and name keys for each found player.