itzg/docker-minecraft-server

update docs for `manage-users` and user API provider

Open

#3,460 opened on 2025年5月21日

GitHub で見る
 (3 comments) (1 reaction) (0 assignees)Shell (1,858 forks)batch import
documentationenhancementhelp wanted

Repository metrics

Stars
 (13,694 stars)
PR merge metrics
 (平均マージ 15h 10m) (30d で 32 merged PRs)

説明

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.

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