Skip to content

網絡概述 ​

Pumpkin 採用高效能的非同步網絡棧,能夠同時為 Minecraft:Java 版 和 Minecraft:基岩版 客戶端提供服務。

所有協定定義、序列化 trait 和線路級編解碼器都隔離在 pumpkin-protocol crate 中,而客戶端連線管理、會話狀態機和遊戲封包分發則由 pumpkin/src/net 管理。


支援的版本 ​

由於 Java 版和基岩版在傳輸層、封包編碼和狀態模型上存在根本差異,Pumpkin 將兩者的網絡實現分開:

功能Minecraft:Java 版Minecraft:基岩版
傳輸層TCP 通訊端流透過 RakNet 和 NetherNet 使用 UDP
幀封裝以 VarInt 長度為字首的幀封裝在 0xfe 標頭中的批處理封包
加密AES-128 / CFB8 流密碼加密會話握手
壓縮逐封包進行 ZLib 壓縮(超過可設定閾值時)逐批次進行 Deflate / ZLib 壓縮
狀態模型顯式狀態:握手、狀態、登入、設定、遊玩由封包驅動的狀態推進
協定 Cratepumpkin-protocol::javapumpkin-protocol::bedrock
伺服器網絡模組pumpkin::net::javapumpkin::net::bedrock

網絡架構 ​

網絡處理流程會先透過專用的傳輸層和編解碼層處理傳入連線,再將其交由統一的伺服器遊戲迴圈:

  1. 傳輸監聽器:獨立的監聽器分別綁定到對應端口——Java 版使用 Tokio TCP(:25565),基岩版使用 UDP/RakNet/NetherNet(:19132)。
  2. 會話抽象:每個接受的連線都會生成一個獨立的會話任務(JavaClient 或 BedrockClient),負責管理線路幀封裝和加密。
  3. 編解碼器反序列化:透過 pumpkin-protocol::java(ClientPacket/ServerPacket)和 pumpkin-protocol::bedrock(PacketWrite/PacketRead),將線路位元組反序列化為強類型封包結構。
  4. 統一的遊戲分發:解碼後的封包被分發到統一的遊戲迴圈中,用於更新玩家實體狀態並流式傳輸世界區塊。

瀏覽網絡文件 ​

查閱各版本的文件:

基於 MIT 授權條款發布。