快速開始
目前狀態: 預發布:目前正在開發中,尚未準備好正式發布。
效能基準:Pumpkin vs. Paper vs. Folia (MC 26.3)
- 冷啟動開機耗時: Pumpkin 僅需
9.6 ms – 12.9 ms,相比之下 Paper 與 Folia 為4,650 ms – 4,905 ms(提速約 380x – 480x)。 - 記憶體佔用: Pumpkin 閒置
60 MiB,在 400 – 700 名並行玩家時佔用1.42 GiB – 1.78 GiB;相比之下 Paper 與 Folia 佔用10.8 GiB – 11.7 GiB(Aikar 10G 旗標)。 - 單區域承載能力(20.0 TPS): 1 核心 / 2 vCPU 上可承載
250 名玩家(Paper 與 Folia 為150);4 核心 / 8 vCPU 上可承載700+ 名玩家(300 人時 MSPT 為13.17 ms,400 人時為18.89 ms,相比之下 Paper 與 Folia 僅為300 名玩家)。 - 多區域承載能力(8 個區域 @ 20.0 TPS): Pumpkin 可承載
600 名玩家(42.79 msMSPT,2.05 GiBRAM),相比之下 Paper 為100 名玩家(30.10 msMSPT,11.26 GiBRAM)(在統一全域世界 Tick 下達到 Paper 的 6 倍承載能力)。
閱讀完整的可重現效能基準。
下載預發布二進制檔案
你可以在預發布下載頁面下載預構建的二進制檔案。
從原始碼構建(Rust)
要編譯 Pumpkin,請確保已安裝 Rust。
- 克隆倉庫並進入該目錄:
git clone --recurse-submodules https://github.com/Pumpkin-MC/Pumpkin.git
cd Pumpkin可選: 如果需要,你可以將一個原版世界放入
Pumpkin/目錄,只需把世界資料夾命名為world。執行:
NOTE
由於發布構建會進行大量優化,構建過程可能需要一些時間。
cargo run --release- 可選: 要透過利用 CPU 的特定功能來最大限度提升效能,可以設定
target-cpu=nativeRust 編譯器標誌:
RUSTFLAGS='-C target-cpu=native' cargo run --releaseNOTE
要連線(進入)你在同一臺本地系統上自行託管的伺服器(例如,在 Linux 上使用 Prism 啟動器登入並執行 Minecraft,同時使用 Pumpkin 託管伺服器),你可能需要依次選擇“多人遊戲”→“新增伺服器”→“伺服器位址”,並將“localhost:25565”用作伺服器位址,儘管終端的伺服器執行輸出中不會列出該位址。
localhost:25565Docker
IMPORTANT
Docker 支援目前處於實驗階段。
如果尚未安裝,你需要先安裝 Docker。安裝 Docker 後,可以執行以下指令啟動伺服器:
docker run --rm \
-p <exposed_port>:25565 \
-v <server_data_location>:/pumpkin \
-it ghcr.io/pumpkin-mc/pumpkin:master<exposed_port>:用於連線 Pumpkin 的端口,例如25565。<server_data_location>:希望儲存伺服器設定和資料的位置,例如./data。
範例
要在端口 25565 上執行 Pumpkin 並將資料儲存在名為 ./data 的目錄中,請執行以下指令:
docker run --rm \
-p 25565:25565 \
-v ./data:/pumpkin \
-it ghcr.io/pumpkin-mc/pumpkin:masterNix / NixOS
Pumpkin 以 pumpkin-mc 軟件包的形式收錄於 nixpkgs(由 @DerGrumpf 維護),同時提供 services.pumpkin-mc NixOS 模組,可將其作為 systemd 服務執行。
無需安裝即可試用
nix run nixpkgs#pumpkin-mcNixOS 模組
將以下內容新增到你的 configuration.nix:
services.pumpkin-mc = {
enable = true;
openFirewall = true;
};這會在 /var/lib/pumpkin-mc 下以經過安全加固的 systemd 服務執行 Pumpkin(DynamicUser、ProtectSystem = "strict",無額外權能)。該模組為 pumpkin.toml 中的大部分設定提供了帶類型的選項,包括 Java/基岩版/RCON/Query/代理網絡、白名單、世界儲存、日誌、PVP 等,另有一個 settings 自由格式選項,可用於尚未覆蓋的設定。
NOTE
RCON 密碼和 Velocity 轉發金鑰會在服務啟動時從檔案中讀取(透過 rcon.passwordFile / proxy.velocity.secretFile),而不會儲存在 Nix store 中,因此可與 sops-nix 或 agenix 等金鑰管理器配合使用。
完整選項列表請參閱模組原始碼,或執行:
nixos-option services.pumpkin-mc測試伺服器
Pumpkin 有一個由 @kralverde 維護的測試伺服器,執行 Pumpkin master 分支的最新提交。
- IP: pumpkin.kralverde.dev
硬件與系統設定:
- 作業系統:Debian GNU/Linux bookworm 12.7 x86_64
- 核心:Linux 6.1.0-21-cloud-amd64
- CPU:Intel Core (Haswell, no TSX) (2) @ 2.40 GHz
- 記憶體:4GB DIMM