Skip to content

Use UUIDv5 for offline players#161

Merged
Protonull merged 2 commits intomainfrom
uuidv5-offline
Apr 29, 2026
Merged

Use UUIDv5 for offline players#161
Protonull merged 2 commits intomainfrom
uuidv5-offline

Conversation

@Protonull
Copy link
Copy Markdown
Collaborator

This uses UUIDv5 to generate deterministic UUIDs for non Mojang-auth'd players. UUIDv5 takes a "namespace" UUID and a value, so a reimplementation of Java's UUID.nameUUIDFromBytes() to turn "mapsync:server" into a namespace UUID. Given that Mojang uses UUIDv4 for authenticated players, using UUIDv5 means having a valid UUID without introducing any risk of collision.

This will require that people delete (or update) their uuid_cache.json and whitelist.json files if they've used unauth mode, otherwise they will fail to parse.

I figured that, given the recent PRs, it would be rude to make their instances start throwing.
@Protonull Protonull merged commit e9ac4bf into main Apr 29, 2026
2 checks passed
@Protonull Protonull deleted the uuidv5-offline branch April 29, 2026 06:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant