itzg/docker-minecraft-server

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

Geschlossen

#3.460 geöffnet am 21.05.2025

 (3 Kommentare) (1 Reaktion) (0 zugewiesene Personen)Shell (1.858 Forks)batch import
documentationenhancementhelp wanted

Repository-Metriken

Stars
 (13.694 Sterne)
PR-Merge-Metriken
 (Durchschn. Merge 15h 10m) (32 gemergte PRs in 30 T)

Beschreibung

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.

Contributor Guide