add newline separator support (#611)
This commit is contained in:
2 files changed
+42
-10
No files matched your search
@@ -172,7 +172,7 @@ in the "LAN Games" part of the "Friends" tab, such as:
|
||||
|
||||
## Permissions
|
||||
|
||||
The Bedrock Dedicated Server requires permissions be defined with XUIDs or Xbox GamerTag. Each of `OPS`, `MEMBERS`, and `VISITORS` accepts a comma-separated list of identifiers. For each entry you can use:
|
||||
The Bedrock Dedicated Server requires permissions be defined with XUIDs or Xbox GamerTag. Each of `OPS`, `MEMBERS`, and `VISITORS` accepts a comma-separated or newline-separated list of identifiers. For each entry you can use:
|
||||
|
||||
- **XUID** — a 16+ digit number (e.g. `2535453759792258`). You can look these up with tools like [MCProfile](https://mcprofile.io/); the XUID is also printed in the server log when a player joins.
|
||||
- **Xbox gamertag** — if the value is not a long numeric XUID, it is treated as a gamertag and resolved to an XUID at startup via the [MCProfile API](https://mcprofile.io/api/v1/bedrock/gamertag). This allows using names instead of numbers.
|
||||
@@ -183,15 +183,28 @@ You can mix XUIDs and gamertags in the same list. The API base URL used for reso
|
||||
|
||||
- `OPS` is used to define operators on the server.
|
||||
```shell
|
||||
-e OPS="1234567890,0987654321"
|
||||
-e OPS="1234567890,0987654321,player1"
|
||||
```
|
||||
- `MEMBERS` is used to define the members on the server.
|
||||
```shell
|
||||
-e MEMBERS="1234567890,0987654321"
|
||||
-e MEMBERS="1234567890,player2"
|
||||
```
|
||||
- `VISITORS` is used to define visitors on the server.
|
||||
```shell
|
||||
-e VISITORS="1234567890,0987654321"
|
||||
-e VISITORS="player3,player4"
|
||||
```
|
||||
|
||||
`docker-compose.yml` example:
|
||||
```yml
|
||||
environment:
|
||||
OPS: |
|
||||
1234567890
|
||||
player1
|
||||
MEMBERS: |
|
||||
player2
|
||||
VISITORS: |
|
||||
player3
|
||||
player4
|
||||
```
|
||||
|
||||
## Allowlist
|
||||
@@ -200,7 +213,7 @@ There are two ways to handle a whitelist:
|
||||
|
||||
The first is to set the `ALLOW_LIST` environment variable to true and map in an [allowlist.json](https://minecraft.wiki/w/Whitelist.json) file (previously known as "whitelist.json") that is custom-crafted to the container.
|
||||
|
||||
The other is to set the `ALLOW_LIST_USERS` environment variable to a comma-separated list of gamer tag usernames and their corresponding XUIDs. Each username should be followed by its XUID, separated by a colon. The server will use these details to match the player.
|
||||
The other is to set the `ALLOW_LIST_USERS` environment variable to a comma-separated or newline-separated of gamer tag usernames and their corresponding XUIDs. Each username should be followed by its XUID, separated by a colon. The server will use these details to match the player.
|
||||
|
||||
There are various tools to look XUIDs up online and they are also printed to the log when a player joins the server.
|
||||
|
||||
@@ -208,6 +221,14 @@ There are various tools to look XUIDs up online and they are also printed to the
|
||||
-e ALLOW_LIST_USERS="player1:1234567890,player2:0987654321"
|
||||
```
|
||||
|
||||
`docker-compose.yml` example:
|
||||
```yml
|
||||
environment:
|
||||
ALLOW_LIST_USERS: |
|
||||
player1:1234567890
|
||||
player2:0987654321
|
||||
```
|
||||
|
||||
## Variables
|
||||
|
||||
Custom server variables are supported by Bedrock. Details and usage instructions can be found on the official bedrock documentation, located here:
|
||||
@@ -215,7 +236,7 @@ Custom server variables are supported by Bedrock. Details and usage instructions
|
||||
- [Variables & Secrets - Minecraft Creator Docs](https://learn.microsoft.com/en-us/minecraft/creator/documents/scriptingservers?view=minecraft-bedrock-stable#variables-and-secrets)
|
||||
- [Variables & Secrets - minecraft/server-admin example](https://learn.microsoft.com/en-us/minecraft/creator/scriptapi/minecraft/server-admin/serversecrets?view=minecraft-bedrock-experimental#getplayerprofilets-1)
|
||||
|
||||
Custom server variables are passed in as comma-separated simple key-value pairs or as a full JSON string.
|
||||
Custom server variables are passed in as comma-separated or newline-separated simple key-value pairs or as a full JSON string.
|
||||
|
||||
Server variables are parsed into their most likely type (number-like turn into numbers, all other inputs are treated as string) using [jq's `fromjson` command](https://jqlang.github.io/jq/manual/#convert-to-from-json). In the example below, `var1` is a string, `var2` is a number, and `var3` is a string.
|
||||
|
||||
@@ -231,6 +252,15 @@ All variables are written to the variables file located at `config/default/varia
|
||||
-e VARIABLES='{"mobSpawnRate":22,"enableCheats":true,"worldArray":["My World", "Abc", 123]}'
|
||||
```
|
||||
|
||||
`docker-compose.yml` example:
|
||||
```yml
|
||||
environment:
|
||||
VARIABLES: |
|
||||
var1=customStringValue
|
||||
var2=1234
|
||||
var3=true
|
||||
```
|
||||
|
||||
## Mods Addons
|
||||
|
||||
Also known as behavior or resource packs, in order to add mods into your server you can follow these steps, tested with [OPS (One Player Sleep)](https://foxynotail.com/addons/ops/) and [bedrocktweaks](https://bedrocktweaks.net/resource-packs/)
|
||||
|
||||
+6
-4
@@ -45,9 +45,10 @@ function resolveXuid() {
|
||||
|
||||
function resolvePermissionXuids() {
|
||||
local list="$1" perm="$2"
|
||||
IFS=',' read -ra a <<< "$list"
|
||||
IFS=',' read -ra a <<< "$(tr '\n' ',' <<< "$list")"
|
||||
|
||||
for v in "${a[@]}"; do
|
||||
[[ -z $v ]] && continue
|
||||
resolveXuid "$v" | jq -R --arg p "$perm" '{permission:$p,xuid:.}'
|
||||
done
|
||||
}
|
||||
@@ -361,9 +362,9 @@ if [[ -n "$ALLOW_LIST_USERS" || -n "$WHITE_LIST_USERS" ]]; then
|
||||
if [[ "$allowListUsers" ]]; then
|
||||
echo "Setting allow list"
|
||||
if [[ "$allowListUsers" != *":"* ]]; then
|
||||
jq -c -n --arg users "$allowListUsers" '$users | split(",") | map({"ignoresPlayerLimit":false,"name": .})' > "allowlist.json"
|
||||
jq -c -n --arg users "$allowListUsers" '$users | split("[,\n]+") | map(select(length>0) | {"ignoresPlayerLimit":false,"name": .})' > "allowlist.json"
|
||||
else
|
||||
jq -c -n --arg users "$allowListUsers" '$users | split(",") | map(split(":") | {"ignoresPlayerLimit":false,"name": .[0], "xuid": .[1]})' > "allowlist.json"
|
||||
jq -c -n --arg users "$allowListUsers" '$users | split("[,\n]+") | map(select(length>0) | split(":") | {"ignoresPlayerLimit":false,"name": .[0], "xuid": .[1]})' > "allowlist.json"
|
||||
fi
|
||||
# activate server property to enable list usage
|
||||
ALLOW_LIST=true
|
||||
@@ -389,8 +390,9 @@ if [[ -n "$VARIABLES" ]]; then
|
||||
# Note: Values should not contain unescaped commas or colons
|
||||
jq -n --arg vars "$VARIABLES" '
|
||||
$vars
|
||||
| split(",")
|
||||
| split("[,\n]+")
|
||||
| map(
|
||||
select(length>0) |
|
||||
split("=") as $kv |
|
||||
{ ($kv[0]): ($kv[1] | fromjson? // $kv[1]) }
|
||||
)
|
||||
|
||||
Reference in new issue
Block a user