MCJE Server

Java 版 (itzg/minecraft-server)

此镜像支持自动映射机制：任何 server.properties 中的键，只要转为大写并把横杠 - 换成下划线 _，即可作为环境变量使用。

1. 核心容器控制 (Container Options)

这些变量控制服务器如何启动、下载什么版本、使用多少内存等。

变量名	可选值 / 示例	说明
EULA	TRUE	必须。同意最终用户协议。
TYPE	VANILLA, PAPER, FORGE, CURSEFORGE 等	服务器类型。完整列表见下方。
VERSION	LATEST, SNAPSHOT, 1.20.1	游戏版本。
INIT_MEMORY	1G, 512M	JVM 初始堆内存 (Xms)。
MEMORY	2G, 4096M	JVM 最大堆内存 (Xmx)。
JVM_OPTS	-XX:+UseG1GC	自定义 Java 启动参数。
UID / GID	1000	指定运行用户的 ID/组 ID。
TZ	Asia/Shanghai	容器时区。

支持的服务器类型详情：

类型	分类	说明
VANILLA	官方原版	Mojang 提供的标准 Minecraft 服务器。
PAPER	插件端	Spigot 的高性能分支，推荐大多数服务器使用。
PURPUR	插件端	Paper 的分支，提供大量额外的游戏性配置选项。
FOLIA	插件端	Paper 的实验性分支，支持区域化多线程（适合超多人数）。
FORGE	模组端	经典的重型模组加载器，支持深度游戏修改。
NEOFORGE	模组端	Forge 的现代化分支 (1.20.2+)，性能更佳。
FABRIC	模组端	轻量级、模块化的模组加载器，更新速度快。
QUILT	模组端	Fabric 的社区驱动开源分支。
MOHIST	混合端	允许同时运行 Forge 模组和 Bukkit/Spigot 插件。
WATERFALL	代理端	(旧版) BungeeCord 分支，用于连接多个服务器。
VELOCITY	代理端	现代高性能代理服务器 (推荐替代 Waterfall)。
CURSEFORGE	整合包	下载指定的 CurseForge 整合包 (需要 API Key)。
AUTO_CURSEFORGE	整合包	自动搜索并下载最匹配的 CurseForge 整合包。
MODRINTH	整合包	从 Modrinth 平台下载整合包。

2. 插件与模组管理 (Mods & Plugins)

变量名	示例	说明
PLUGINS	http://.../p1.jar,\nhttp://.../p2.jar	逗号或换行分隔的 URL，自动下载插件。
MODS	http://.../m1.jar	逗号或换行分隔的 URL，自动下载模组。
REMOVE_OLD_MODS	TRUE, FALSE	启动时是否删除旧模组（推荐开启以保持同步）。
REMOVE_OLD_MODS_DEPTH	1	删除旧模组的目录深度。
EXCLUDE_MODS	optifine	即使在列表中也排除的模组（正则匹配）。
MODPACK	http://.../pack.zip	通用整合包下载链接。

3. 整合包平台专用 (CurseForge / Modrinth)

变量名	说明
CF_API_KEY	必须。CurseForge Core API Key（需自行申请）。
CF_SLUG	整合包在 CF 网址上的名称（如 rlcraft）。
CF_FILE_ID	指定具体的文件 ID（不填则下载最新）。
MODRINTH_SLUG	Modrinth 平台的整合包 ID。
MODRINTH_VERSION_ID	Modrinth 具体版本 ID。

4. server.properties 映射 (常用全集)

以下变量直接修改 server.properties。如果这里没列出，你依然可以按照"大写+下划线"规则自行添加。

环境变量 (大写)	对应 server.properties	可选值	说明
MOTD	motd	字符串	服务器标题信息。
LEVEL_NAME	level-name	字符串	存档文件夹名称。
LEVEL_SEED	level-seed	随机字符	地图种子。
DIFFICULTY	difficulty	peaceful, easy, normal, hard	难度。
GAMEMODE	gamemode	survival, creative, adventure, spectator	默认游戏模式。
PVP	pvp	true, false	是否允许玩家互殴。
MAX_PLAYERS	max-players	20	最大玩家数。
ONLINE_MODE	online-mode	true, false	正版验证 (false 为离线模式)。
VIEW_DISTANCE	view-distance	10	视距 (Chunks)。
SIMULATION_DISTANCE	simulation-distance	10	模拟距离 (1.18+)。
ALLOW_FLIGHT	allow-flight	true, false	是否允许飞行 (防作弊用)。
ALLOW_NETHER	allow-nether	true, false	是否开启地狱。
WHITE_LIST	white-list	true, false	是否开启白名单。
ENFORCE_WHITELIST	enforce-whitelist	true, false	强制在线玩家必须在白名单。
GENERATE_STRUCTURES	generate-structures	true, false	是否生成村庄/地牢。
HARDCORE	hardcore	true, false	极限模式 (死后封禁)。
SNOOPER_ENABLED	snooper-enabled	true, false	数据采集。
ENABLE_COMMAND_BLOCK	enable-command-block	true, false	是否启用命令方块。
SPAWN_PROTECTION	spawn-protection	16	出生点保护半径。
FORCE_GAMEMODE	force-gamemode	true, false	玩家重连是否强制重置模式。

5. 在控制台执行服务器命令（RCON）

本镜像默认已启用 RCON，并在每次启动时自动生成随机密码以保障安全。你可以直接通过容器内置的 RCON 客户端发送命令，无需对外暴露端口。

使用方法：

1. 在 Zeabur 项目中进入该服务的控制台页面
2. 点击控制台工具栏中的 命令（Command） 按钮
3. 输入 rcon-cli 并回车，即可进入交互式 RCON 环境
4. 接下来可直接输入任意 Minecraft 服务器命令，例如：
   • list — 查看在线玩家
   • whitelist add <玩家名> — 添加白名单
   • time set day — 设置为白天
   • op <玩家名> — 授予管理员权限

提示： 输入 quit 或按 Ctrl+C 即可退出 RCON。除非已设置安全的 RCON_PASSWORD，否则请勿将 RCON 端口 25575 暴露到公网。

6. 仅启动容器而不启动服务器（用于文件管理）

当你只想使用 Zeabur 的文件管理器修改配置或上传文件，但暂时不需要启动 Minecraft 服务器时，可以让容器保持空转状态。

配置步骤：

1. 前往 Zeabur 中该服务的 设置（Settings） 页面
2. 找到 启动命令（Startup Command） 配置项
3. 输入 sleep infinity（如环境要求可改用 sleep 365d）
4. 保存并重新部署/重启服务
5. 此时容器会保持在线但不启动游戏服务器，你可以安全地通过文件管理器操作 /data 目录

注意： 文件操作完成后，务必清空或恢复启动命令为默认值，否则下次重启时服务器仍不会自动启动。