itzg / docker-minecraft-bedrock-server

Containerized Minecraft Bedrock Dedicated Server with selectable version
MIT License
1.14k stars 218 forks source link

Allowlist.json file example and usage #286

Open trigun539 opened 1 year ago

trigun539 commented 1 year ago

Having a hard time getting the allowlist.json file to work. Keep getting the user has not been invited message when connecting. Can we please add some example of how to set this up properly? Format of the allowlist.json and usage with the right environment variables.

Is ALLOW_LIST_USERS a comma separated xuids, uuids? or usernames?

itzg commented 1 year ago

I should probably update the section heading, but this is the description and example:

https://github.com/itzg/docker-minecraft-bedrock-server#whitelist

jonvel commented 1 year ago

I think the wiki page that you reference might have to be updated. Does the allowlist.json still use UUID's for users, or just XBox Gamertags?

itzg commented 1 year ago

The new section link is https://github.com/itzg/docker-minecraft-bedrock-server/tree/master#allowlist

As for ALLOW_LIST_USERS it is a list of Xbox gamer tags.

trigun539 commented 1 year ago

Here what worked for me, sample allowlist.json

[
  {
    "name": "XBOX USERNAME",
    "xuid": "xuid gotten from website below"
  },
  ....
]

To get xuid, look at: https://cxkes.me/xbox/xuid Type xbox username and copy the XUID (DEC) given. This value is what you use in the allowlist.json xuid field.

racecarburton commented 1 week ago

There are ways Minecraft has automated the creation of the allowlist.json file. You just have to enter the console command "allowlist add " and it will automatically add the xuid to the file when a player with the matching gamertag joins. It's all outlined in the "bedrock_srver_how_to.html" file as of writing this.

itzg commented 1 week ago

Good point @racecarburton . That could be utilized by running the commands this way https://github.com/itzg/docker-minecraft-bedrock-server/tree/master#executing-server-commands

Being able to pre-assign those users on a freshly created container is also useful, but gets into this challenge of finding those XUIDs to assign.