MCBE Server

基岩版 (itzg/minecraft-bedrock-server)

此映像支援自動映射機制：任何 server.properties 中的鍵，只要轉為大寫並把橫槓 - 換成底線 _，即可作為環境變數使用。

基岩版變數相對較少，主要圍繞官方 BDS 軟體的設定。

1. 容器與基礎控制

變數名	可選值	說明
EULA	TRUE	必須。
VERSION	LATEST, 1.20.50	指定基岩版版本。
PREVIEW	true, false	設定為 true 以安裝預覽版/測試版 (Preview/Beta)。
OPS	XUID1,XUID2	自動設定為管理員的 XUID 列表 (建議用控制台設定)。
ALLOW_LIST_USERS	Name1,Name2	允許進入伺服器的玩家名稱列表。
UID / GID	1000	指定執行使用者的 ID/組 ID。
TZ	Asia/Shanghai	容器時區。

2. server.properties 映射 (Bedrock 專用)

以下變數直接修改 server.properties。如果這裡沒列出，你依然可以按照「大寫+底線」規則自行新增。

環境變數	對應 server.properties	可選值	說明
SERVER_NAME	server-name	字串	伺服器標題資訊。
LEVEL_NAME	level-name	字串	存檔資料夾名稱。
GAMEMODE	gamemode	survival, creative, adventure	模式。
DIFFICULTY	difficulty	peaceful, easy, normal, hard	難度。
ALLOW_CHEATS	allow-cheats	true, false	關鍵：是否允許作弊指令。
ONLINE_MODE	online-mode	true, false	Xbox 登入驗證。
MAX_PLAYERS	max-players	10	最大人數。
VIEW_DISTANCE	view-distance	32	視距 (基岩版通常可設定更大)。
TICK_DISTANCE	tick-distance	4 - 12	模擬距離 (影響紅石/刷怪範圍)。
PLAYER_IDLE_TIMEOUT	player-idle-timeout	30	掛機踢出時間 (分鐘)。
TEXTUREPACK_REQUIRED	texturepack-required	true, false	強制玩家下載資源包。
CONTENT_LOG_FILE_ENABLED	content-log-file-enabled	true, false	是否記錄內容錯誤日誌。
COMPRESSION_THRESHOLD	compression-threshold	1	網路封包壓縮閾值 (0-65535)。
SERVER_AUTHORITATIVE_MOVEMENT	server-authoritative-movement	client-auth, server-auth	移動判定方式 (防作弊)。

3. 在控制台執行伺服器指令（send-command）

基岩版與 Java 版不同：這裡不使用 rcon-cli，而是透過映像內建的 send-command 將指令送到伺服器控制台。

使用方法：

1. 在 Zeabur 專案中進入該服務的控制台頁面
2. 點擊控制台工具列中的 命令（Command） 按鈕
3. 依以下格式輸入：send-command <指令> [參數...]

範例：

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

提示：若要執行作弊相關指令，請按需設定 ALLOW_CHEATS=true。

4. 僅啟動容器而不啟動伺服器（用於檔案管理）

當你只想使用 Zeabur 的檔案管理器修改設定或上傳檔案，但暫時不需要啟動基岩版伺服器時，可以讓容器保持空轉狀態。

設定步驟：

1. 前往 Zeabur 中該服務的 設定（Settings） 頁面
2. 找到 啟動命令（Startup Command） 欄位
3. 輸入 sleep infinity（如環境要求可改用 sleep 365d）
4. 儲存並重新部署/重啟服務
5. 此時容器會保持在線但不啟動伺服器，你可以安全地透過檔案管理器操作 /data 目錄

注意： 檔案操作完成後，務必清空或恢復啟動命令為預設值，否則下次重啟時伺服器仍不會自動啟動。

5. 獲取伺服器公網 UDP 連接埠

由於 Zeabur 控制台目前暫不直接顯示 UDP 連接埠映射，你需要透過 SSH 查詢系統轉發規則來獲取真實的公網連接埠。

查詢步驟：

1. 透過 SSH 連線到伺服器。
2. 執行以下指令：kubectl get services --all-namespaces
3. 在輸出列表中找到你的服務（通常標記為 19132/UDP）。查看 PORT(S) 欄位，格式如 19132:31234/UDP，其中冒號後面的 31234 即為你的公網連接埠。