Skip to content

快速開始 ​

目前狀態: 預釋出:目前正在開發中,尚未準備好正式釋出。

效能基準: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 ms MSPT,2.05 GiB RAM),相比之下 Paper 為 100 名玩家(30.10 ms MSPT,11.26 GiB RAM)(在統一全域世界 Tick 下達到 Paper 的 6 倍承載能力)。

閱讀完整的可重現效能基準。

下載預釋出二進位檔案 ​

你可以在預釋出下載頁面下載預建構的二進位檔案。

從原始碼建構(Rust) ​

要編譯 Pumpkin,請確保已安裝 Rust。

  1. 克隆倉庫並進入該目錄:
shell
git clone --recurse-submodules https://github.com/Pumpkin-MC/Pumpkin.git
cd Pumpkin
  1. 可選: 如果需要,你可以將一個原版世界放入 Pumpkin/ 目錄,只需把世界資料夾命名為 world。

  2. 執行:

NOTE

由於釋出建構會進行大量最佳化,建構過程可能需要一些時間。

shell
cargo run --release
  1. 可選: 要透過利用 CPU 的特定功能來最大限度提升效能,可以設定 target-cpu=native Rust 編譯器標誌:
shell
RUSTFLAGS='-C target-cpu=native' cargo run --release

NOTE

要連線(進入)你在同一臺本地系統上自行託管的伺服器(例如,在 Linux 上使用 Prism 啟動器登入並執行 Minecraft,同時使用 Pumpkin 託管伺服器),你可能需要依次選擇“多人遊戲”→“新增伺服器”→“伺服器位址”,並將“localhost:25565”用作伺服器位址,儘管終端的伺服器執行輸出中不會列出該位址。

text
localhost:25565

Docker ​

IMPORTANT

Docker 支援目前處於實驗階段。

如果尚未安裝,你需要先安裝 Docker。安裝 Docker 後,可以執行以下指令啟動伺服器:

shell
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 的目錄中,請執行以下指令:

shell
docker run --rm \
    -p 25565:25565 \
    -v ./data:/pumpkin \
    -it ghcr.io/pumpkin-mc/pumpkin:master

Nix / NixOS ​

Pumpkin 以 pumpkin-mc 軟體包的形式收錄於 nixpkgs(由 @DerGrumpf 維護),同時提供 services.pumpkin-mc NixOS 模組,可將其作為 systemd 服務執行。

無需安裝即可試用 ​

shell
nix run nixpkgs#pumpkin-mc

NixOS 模組 ​

將以下內容新增到你的 configuration.nix:

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 等金鑰管理器配合使用。

完整選項列表請參閱模組原始碼,或執行:

shell
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

基於 MIT 授權條款釋出。