From 91b98bcc7b55eb41c211b54706d5cd87911e8b8b Mon Sep 17 00:00:00 2001 From: Columbus Labs Date: Wed, 12 Aug 2026 09:41:03 -0400 Subject: [PATCH] Document Java profile names for user management (#4225) --- docs/configuration/server-properties.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/configuration/server-properties.md b/docs/configuration/server-properties.md index bcabb138..d6960454 100644 --- a/docs/configuration/server-properties.md +++ b/docs/configuration/server-properties.md @@ -168,7 +168,9 @@ To [enforce the whitelist changes immediately](https://minecraft.wiki/w/Server.p !!! tip "Changing user API provider" - The usernames provided for whitelist and ops processing are resolved using either [PlayerDB](https://playerdb.co/) or [Mojang's API](https://wiki.vg/Mojang_API#Username_to_UUID). The default uses PlayerDB, but can be changed by setting the environment variable `USER_API_PROVIDER` to "mojang". Sometimes one or the other service can become overloaded, which is why there is the ability to switch providers. + When specifying usernames for whitelist and ops processing, use Minecraft: Java Edition profile names, not Xbox gamertags. They can differ even when they belong to the same Microsoft account. A player can review or change their Java profile name on the [Minecraft profile page](https://www.minecraft.net/en-us/msaprofile/mygames/editprofile). + + Usernames are resolved using either [PlayerDB](https://playerdb.co/) or [Mojang's API](https://wiki.vg/Mojang_API#Username_to_UUID). The default uses PlayerDB, but can be changed by setting the environment variable `USER_API_PROVIDER` to "mojang". Sometimes one or the other service can become overloaded, which is why there is the ability to switch providers. ### Op/Administrator Players