Skip to content

update docs for manage-users and user API provider #3460

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mcgr0g opened this issue May 21, 2025 · 2 comments
Open

update docs for manage-users and user API provider #3460

mcgr0g opened this issue May 21, 2025 · 2 comments

Comments

@mcgr0g
Copy link

mcgr0g commented May 21, 2025

Enhancement Type

Improve an existing feature

Describe the enhancement

Documentation Link: Server Properties - OPs/Administrators

Problem
When using the manage-users command to add an OP/whitelisted player with an Xbox/Microsoft Account (MSA), the container fails to start with the error:

[mc-image-helper] ERROR: Invalid parameter provided for 'manage-users' command: Could not resolve user from Playerdb

The Mojang API (https://api.mojang.com/users/profiles/minecraft/:username) returns:

{"errorMessage": "Couldn't find any profile with name :username"}

Even though the profile exists on:

Root Cause
Different Java Profile Name and xbox gametag.

Solution
Use username from Java Profile Name. Or change it there to gametag value.

@itzg
Copy link
Owner

itzg commented May 21, 2025

I suppose a note would help but I would hope that would be implied when using the Java edition server instead of the Bedrock edition

https://github.com/itzg/docker-minecraft-bedrock-server

@mcgr0g
Copy link
Author

mcgr0g commented May 23, 2025

I tested both servers but I don't understand your position, sorry.

In the bedrock server, it was enough to specify the UID, which is visible in the log when the player joins.
In the java server, these UIDs will not work, there you need to use username or gametag or another uid.

In my case, one of the players used profile renaming after registering in Xbox, but forgot to do it in the Minecraft profile.
Honestly, I did not know that between these backends there is not full synchronization of accounts.

@itzg itzg moved this to To do in Docker Minecraft May 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: To do
Development

No branches or pull requests

2 participants