update docs for `manage-users` and user API provider · itzg/docker-minecraft-server#3460

(3 comments) (1 reaction) (0 assignees)Shell (13,694 stars) (1,858 forks)batch import

documentationenhancementhelp wanted

説明

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.

コントリビューターガイド

技術スタック: shelldocker
領域: documentationdevops
Issue 種別: documentation
難度: 2
推定時間: 1-3 hours
活動状況: fresh
明確さ: clear
前提条件: basic git and Markdownunderstanding of Minecraft server properties
初心者向け度: 85
調査方針: Locate the 'Server Properties OPs/Administrators' documentation page. Update the section describing the 'manage users' command to clarify that for Xbox/Microsoft accounts, the container expects the Java Profile Name (found on the Minecraft.net profile 'Edit Profile' page), not the Xbox gamertag. Also add a note about the potential error and how to resolve it. The existing issue #3460 provides the error message and solution details.