Service: Minecraft Server Bedrock Edition - EyevinnOSC/community GitHub Wiki
Minecraft Server (Bedrock Edition)
Minecraft Server (Bedrock Edition) (serviceId itzg-docker-minecraft-bedrock-server) is a Dockerized Minecraft Bedrock Edition server maintained by itzg, running the official Bedrock dedicated server. It supports players on Windows 10/11, Xbox, PlayStation, Nintendo Switch, iOS and Android. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance under the MIT license, with up to 10 GiB of storage per instance. Source: itzg/docker-minecraft-bedrock-server. Looking for Java Edition instead? See Minecraft Server.
What it can do
- Host a multiplayer Bedrock world for players on all Bedrock platforms. Each player needs a Minecraft Bedrock Edition license.
- Set the game mode, player limit and world type.
- Pass custom server variables for advanced configuration.
Creating an instance
No other OSC services are needed. Call create-service-instance with serviceId: "itzg-docker-minecraft-bedrock-server":
{
"name": "mybedrockserver",
"GameMode": "creative",
"MaxPlayers": "20",
"LevelType": "FLAT"
}
Wait for the instance to be running (wait-for-service-ready) and use describe-service-instance to read the host and port to connect to.
CLI equivalent:
osc create itzg-docker-minecraft-bedrock-server mybedrockserver \
-o GameMode="survival" \
-o MaxPlayers="20" \
-o LevelType="DEFAULT"
Options
| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the instance. Alphanumeric, at most 20 characters. |
| GameMode | No | string | Game mode of the server, equivalent to the gamemode property in server.properties. Upstream example: creative. Other Bedrock values include survival and adventure. Sets GAMEMODE. |
| MaxPlayers | No | string | Maximum number of players that can be connected at the same time, equivalent to the max-players property in server.properties. Sets MAX_PLAYERS. |
| LevelType | No | string | Type of world to generate, equivalent to the level-type property in server.properties. Upstream example: flat. Values used before were DEFAULT (normal terrain) and FLAT. Sets LEVEL_TYPE. |
| Variables | No | string | Custom server variables, written to config/default/variables.json. Either comma-separated pairs such as var1=value,var2=1234 or a full JSON string such as {"mobSpawnRate":22,"enableCheats":true}. Values are typed automatically (numbers versus strings). Sets VARIABLES. |
All options are plain values, none are secrets.
Using the instance
In Minecraft on any Bedrock platform, go to Play, Servers, Add Server, enter the host and port from describe-service-instance, then save and join. Use the port the instance reports rather than assuming 19132.
Examples of the Variables option:
mobSpawnRate=22,enableCheats=true
{"mobSpawnRate": 22, "enableCheats": true}