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 即为你的公网连接端口。