itzg/docker-minecraft-server

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

クローズ

#3,460 opened on 2025/05/21

 (3 件のコメント) (1 件のリアクション) (0 人の担当者)Shell (1,858 件のフォーク)batch import
documentationenhancementhelp wanted

Repository metrics

Stars
 (13,694 個のスター)
PR merge metrics
 (PR metrics pending)

説明

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.

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