為什麼選擇 Leaves?
Leaves 是一個基於 Paper 的 Minecraft 伺服器核心(Paper 本身則是 Spigot/CraftBukkit 的高效能分支),主打「修復被破壞的原版機制」與高效能表現。 它保留原版接近 Vanilla 的遊玩體驗,同時透過非同步區塊載入、實體追蹤與紅石優化等手段,提升伺服器 TPS,特別適合有大量玩家或重度紅石/機器的伺服器。
Leaves 完全相容 Bukkit/Spigot/Paper 插件生態系,因此大部分常見插件(如權限、經濟、地保、防掛等)都能直接使用。
本文將以 Minecraft Java 1.21.8 + Leaves 1.21.8 為目標,示範從零開始在一般 Linux/Windows 主機上架設伺服器的流程。
環境與前置需求
Java 版本需求
Leaves 自 Minecraft 1.20.5 之後,要求使用 Java 21 才能正常執行。
建議:
- 必備:Java 21(OpenJDK 21、Temurin 21 皆可)
- 請避免使用過舊的 Java(如 8 / 11 / 17),以免啟動失敗或出現奇怪錯誤。
Linux 安裝示意(Debian)
|
|
只要 java -version 顯示主版本為 21 即可。
Windows 安裝示意
- 到 Temurin / Azul Zulu / Oracle JDK 等官網下載 JDK 21 (x64) 安裝檔。
- 安裝時勾選「設定 JAVA_HOME / 加入 PATH」(若有)。
- 開啟 PowerShell 或命令提示字元輸入:
|
|
確認版本為 21。
硬體與系統建議
依玩家數量與插件多寡不同會有差異,以下為大約參考值(僅供估算):
- 2–6 位好友小型生存:
- 2 核心 CPU
- 4 GB RAM(其中 2–3 GB 給伺服器)
- 10–30 人中型伺服器:
- 4 核心以上 CPU
- 8–12 GB RAM(其中 6–10 GB 給伺服器)
- 儲存空間:至少 20–30 GB,使用 SSD 佳(讀寫效率對 TPS 影響很大)
作業系統方面:
- Linux(Debian/Ubuntu、Rocky/Alma、Arch 等):穩定、好維運,推薦。
- Windows 10/11:測試、自用小服可,但長期 24/7 建議 Linux。
下載 Leaves 1.21.8
從 Leaves 官方網站下載
- 開啟 Leaves 官方網站下載頁面:
https://leavesmc.org/downloads/leaves
在此可以直接取得 Leaves 1.21.8 的伺服器核心檔案。 - 找到 1.21.8 對應的版本(通常會標示「1.21.8」或「1.21.x」與 build 編號),點擊對應的下載連結。
Leaves 也提供多個 1.21.x 版本的建置,你可以選擇對應 1.21.8 的最新穩定 build。
從 GitHub Releases 下載
Leaves 原始碼與 Release 放在 GitHub:
https://github.com/LeavesMC/Leaves
在 Releases 區塊中,可看到例如:
Leaves-1.21.8-138-9331167等版本標籤(含 1.21.8 的發行)。
點擊對應的 paperclip / leavesclip jar 下載即可。
下面教學將假設你下載的檔案命名為:
leaves-1.21.8.jar(你可以自行改名為leaves.jar,但記得啟動指令要跟著改)。
建立伺服器資料夾結構
選擇一個路徑放伺服器(以下舉例):
- Linux:
/opt/mc/leaves-1.21.8/ - Windows:
D:\Minecraft\leaves-1.21.8\
步驟:
- 建立資料夾並把核心 jar 放進去。
Linux:
|
|
Windows:
- 建立資料夾
D:\Minecraft\leaves-1.21.8\ - 將下載好的
leaves-1.21.8.jar移到該資料夾內。
第一次啟動與接受 EULA
基本啟動指令
Leaves 官方文件中的建議啟動指令範例如下:
|
|
這裡:
-Xms4G:初始分配 4G RAM-Xmx4G:最大分配 4G RAM--nogui:不啟動原版 GUI 介面,純文字主控台,更適合伺服器環境
在本教學中,若檔名為 leaves-1.21.8.jar,指令請改為:
Linux / macOS:
|
|
Windows(建立啟動批次檔 start.bat):
|
|
接受 EULA
第一次啟動時,伺服器會讀條一會兒,然後自動停止,並在資料夾中生成 eula.txt。
- 編輯
eula.txt:- 找到
eula=false - 改成
eula=true
- 找到
- 儲存後再重新執行啟動指令。
建立啟動腳本(方便日常使用)
Linux:啟動腳本
在伺服器資料夾內建立檔案 start.sh:
|
|
內容範例:
|
|
儲存後給執行權限:
|
|
Windows:啟動批次檔
在 D:\Minecraft\leaves-1.21.8\ 建立 start.bat:
|
|
之後只要雙擊 start.bat 即可啟動伺服器。
進階:可參考 Paper/Leaves 官方的「啟動腳本產生器」取得更進階的 JVM 參數與 GC 設定。
基礎設定:server.properties
啟動成功後,資料夾會生成許多檔案與資料夾,其中最重要之一是 server.properties,用於控制大部分伺服器行為。
以下列出幾個常見需要修改的項目(可用任何文字編輯器開啟):
motd=我的 Leaves 1.21.8 伺服器- 玩家在多人列表看到的伺服器名稱。
online-mode=truetrue:正版驗證(推薦,需使用正版帳號登入)。false:離線模式(有安全風險,不建議公開伺服器使用)。
max-players=20- 同時在線玩家上限,依硬體實際調整。
difficulty=normal- 遊戲難度:
peaceful/easy/normal/hard。
- 遊戲難度:
view-distance=8- 玩家視距,越大對 CPU/記憶體壓力越高,可依硬體與 TPS 調整。
simulation-distance=10- 生物與方塊更新範圍,會影響紅石與農場效率與效能。
white-list=false- 若開啟白名單,只有在白名單中的玩家能登入。
enable-command-block=false- 若伺服器使用指令方塊請改為
true。
- 若伺服器使用指令方塊請改為
修改後重新啟動伺服器設定才會生效。
Leaves / Paper 進階設定
Leaves 延續了 Paper 的配置系統,並在此基礎上加入額外修正與優化選項。官方文件建議:啟動後可參考 Leaves Configuration 與 Paper Configuration 進行調整。
在伺服器資料夾中,你會看到例如:
config/目錄- 以及多種 YAML 設定檔(名稱可能隨版本調整)
常見可調整方向包含:
- 實體上限(每個區塊/世界可存在多少怪物、動物)
- Hopper 與紅石更新頻率(可降低卡頓)
- 非同步區塊載入與光照演算法相關設定
- 部分 Minecraft 原版行為的修正參數
具體每一項的含意與推薦值,建議對照 Leaves/Paper 官方文件與你實際的伺服器類型來調整。
插件安裝
由於 Leaves 是基於 Paper 的伺服器核心,完全支援 Bukkit/Spigot/Paper 插件 API。
安裝方式:
- 確認插件支援對應的 Minecraft 版本(1.21.x)。
- 下載對應的
.jar插件檔。 - 將檔案放入伺服器資料夾中的
plugins/資料夾。 - 重新啟動伺服器,或在主控台輸入
reload(較不推薦,會有風險,建議完整重啟)。 - 插件通常會在
plugins/插件名稱/生成自己的設定檔,可進一步調整。
常見插件類別:
- 權限系統:LuckPerms 等
- 防破壞/地保:WorldGuard、GriefPrevention 等
- 經濟系統:Vault + 經濟核心插件
- 防掛、防刷:各類 AntiCheat、限制農場等插件
開放對外連線
若伺服器放在家用網路或雲端 VPS,需要處理防火牆與連接埠設定。
伺服器預設連接埠
Minecraft Java 預設使用 TCP 25565。
Linux 防火牆設定範例(ufw)
|
|
或使用 firewalld:
|
|
家用路由器 Port Forward
若你在家裡主機上架設伺服器,讓外網朋友能連進來,需在路由器上設定:
- 找到「Port Forwarding / NAT / 虛擬伺服器」相關設定頁。
- 新增一條規則:
- 外部連接埠:
25565 - 內部 IP:你伺服器所在電腦的內網 IP(例如
192.168.1.100) - 內部連接埠:
25565 - 協定:TCP
- 外部連接埠:
- 儲存並套用。
安全性提醒:
若開放到公網,務必:
- 保持系統與 Java 更新
- 使用正版驗證(
online-mode=true)或做好額外防護- 僅給信任的人 OP,並限制控制台權限
使用 systemd 讓伺服器自動啟動(Linux 進階)
若你使用 systemd(例如 Debian/Ubuntu/大部分主流發行版),可以建立一個服務檔,讓 Leaves 伺服器隨系統啟動並方便用 systemctl 管理。
假設:
- 伺服器路徑:
/opt/mc/leaves-1.21.8 - 啟動腳本:
/opt/mc/leaves-1.21.8/start.sh - 執行身份:
mc使用者
建立專用使用者(選用)
|
|
建立 systemd 服務檔
|
|
內容範例:
|
|
儲存後執行:
|
|
之後就能用:
|
|
來管理伺服器。
備份與維護建議
為了避免世界檔損壞或誤操作,建議建立基本備份策略:
- 定期備份以下內容:
world/、world_nether/、world_the_end/(或你自訂世界名稱)plugins/與其內設定檔server.properties、各類 YAML 設定檔
- 備份時,最好:
- 先在主控台輸入
save-all強制存檔 - 或在關服後再打包整個目錄
- 先在主控台輸入
平時維護建議:
- 留意主控台是否有 Exception / 報錯
- 有重大版本更新(例如 1.21.8 → 1.21.10)前務必完整備份
- 追蹤 Leaves 官方與 GitHub 的公告與 Release 說明,以掌握修正內容與可能的行為變更。
玩家端連線方式
當伺服器運行正常後,玩家即可在 Minecraft Java 客戶端新增伺服器:
- 若是同一台機器(自玩):
- 伺服器位址:
localhost或127.0.0.1
- 伺服器位址:
- 同一區域網路(家中其他電腦):
- 使用伺服器主機的內網 IP(例如
192.168.1.100:25565)
- 使用伺服器主機的內網 IP(例如
- 外網玩家:
- 使用你的公開 IP 或網域,例如:
example.com:25565
- 使用你的公開 IP 或網域,例如:
如果能在主控台看到玩家登入訊息,代表伺服器與 Leaves 1.21.8 已成功運作。
結語
透過 Leaves 1.21.8,你可以在維持接近原版體驗的前提下,大幅提升紅石、實體與多人環境下的效能與穩定度。 只要掌握:
- 正確的 Java 21 環境
- 從官方管道下載對應版本的 Leaves 1.21.8
- 設定好
server.properties與防火牆/連接埠 - 善用 Bukkit/Spigot/Paper 插件
就能搭建一個可長期營運、可擴充的 Minecraft Java 伺服器。
如果你之後需要進一步的優化(如針對 TPS 監控、具體 Leaves/Paper 參數調整、特定插件組合推薦),可以再告訴需求類型(小型生存、空島、RPG、迷你遊戲等),再往下做更細的調校。