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}

Resources