MCBE Server

Bedrock Edition (itzg/minecraft-bedrock-server)

This image supports automatic mapping: any key in server.properties can be used as an environment variable by converting it to UPPERCASE and replacing hyphens - with underscores _.

Bedrock Edition variables are relatively fewer, mainly centering around the official BDS software configuration.

1. Container & Basic Control

Variable	Values	Description
EULA	TRUE	Required.
VERSION	LATEST, 1.20.50	Specify Bedrock version.
PREVIEW	true, false	Set to true to install the Preview/Beta version.
OPS	XUID1,XUID2	Comma-separated list of XUIDs to automatically op (console setup recommended).
ALLOW_LIST_USERS	Name1,Name2	List of names to allow joining.
UID / GID	1000	Specify user ID/group ID.
TZ	Asia/Shanghai	Container timezone.

2. server.properties Mapping (Bedrock Specific)

These variables directly modify server.properties. If not listed, you can still add them using the "UPPERCASE+underscore" rule.

Environment Variable	server.properties	Values	Description
SERVER_NAME	server-name	String	Server title message.
LEVEL_NAME	level-name	String	World folder name.
GAMEMODE	gamemode	survival, creative, adventure	Game mode.
DIFFICULTY	difficulty	peaceful, easy, normal, hard	Difficulty.
ALLOW_CHEATS	allow-cheats	true, false	Critical: Allow cheat commands.
ONLINE_MODE	online-mode	true, false	Xbox login verification.
MAX_PLAYERS	max-players	10	Max players.
VIEW_DISTANCE	view-distance	32	View distance (Bedrock usually allows larger values).
TICK_DISTANCE	tick-distance	4 - 12	Simulation distance (affects Redstone/mob spawning).
PLAYER_IDLE_TIMEOUT	player-idle-timeout	30	Idle kick timeout (minutes).
TEXTUREPACK_REQUIRED	texturepack-required	true, false	Force players to download resource packs.
CONTENT_LOG_FILE_ENABLED	content-log-file-enabled	true, false	Log content errors.
COMPRESSION_THRESHOLD	compression-threshold	1	Network packet compression threshold (0-65535).
SERVER_AUTHORITATIVE_MOVEMENT	server-authoritative-movement	client-auth, server-auth	Movement authority (anti-cheat).

3. Run commands in the server console (send-command)

Bedrock Dedicated Server does not use rcon-cli like Java Edition. This image provides a helper script named send-command to send commands to the server console.

How to use in Zeabur:

1. Open the Zeabur service console page
2. Click the Command button
3. Run commands using this format: send-command <command> [args...]

Examples:

• send-command list
• send-command op xxxx
• send-command gamerule dofiretick false

Note: For cheat-related commands, ensure ALLOW_CHEATS=true if required by the server.

4. Start the container without starting the server (for file management)

If you want to use Zeabur’s file manager without launching the Bedrock server, you can keep the container running with a sleep command.

1. Go to Zeabur service settings
2. Find the Startup Command field
3. Set it to sleep infinity (or sleep 365d)
4. Redeploy/restart the service, then manage files under /data

After finishing file operations, restore/clear the startup command so the server can start normally.

5. Find the Server Address and Port

Zeabur automatically forwards UDP ports but may not display them in the UI. You need to check the forwarding rules via SSH.

Steps:

1. Connect to the service via SSH.
2. Run this command: kubectl get services --all-namespaces
3. Find your service in the list (look for 19132/UDP). Check the PORT(S) column.
   • Example: 19132:31234/UDP
   • The number after the colon (31234) is your public connection port.