itzg/docker-minecraft-server

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

已关闭

#3,460 创建于 2025年5月21日

 (3 条评论) (1 个反应) (0 位负责人)Shell (1,858 个派生)batch import
documentationenhancementhelp wanted

仓库指标

星标
 (13,694 个星标)
PR 合并指标
 (PR 指标待抓取)

描述

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.

贡献者指南