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 目錄

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