基岩版与 NetherNet

Pumpkin 原生支持 Minecraft 基岩版客户端，包括 NetherNet WebRTC/ICE 传输层以及用户名自定义。

配置

pumpkin.toml

[networking.bedrock]
enabled = true
online_mode = true
max_players = 1000
view_distance = 16
simulation_distance = 10
motd = "A blazingly fast Pumpkin server!"
username_prefix = ""
replace_username_spaces = true
chunk_caching = true

[networking.bedrock.nethernet]
enabled = true
address = "0.0.0.0:19132"
identity_key = "nethernet-key.der"
stun_servers = []

基岩版选项

• enabled：是否接受来自基岩版客户端的连接（默认：true）。
• online_mode：是否对基岩版玩家强制执行 Xbox Live 身份验证（默认：true）。
• max_players：基岩版最大并发玩家数量（设置为 0 表示不限制，默认：1000）。
• view_distance：发送给基岩版客户端的最大区块视距（默认：16）。
• simulation_distance：基岩版玩家的最大 Tick 模拟距离（默认：10）。
• motd：在基岩版服务器列表中显示的每日消息（MOTD）。
• username_prefix：添加到基岩版玩家代号（Gamertag）前面的可选前缀（例如 "." 或 "*"），防止在跨平台联机服务器中与 Java 版账户发生名称冲突（默认：""）。
• replace_username_spaces：是否自动将基岩版玩家代号中的空格替换为下划线 _，以确保在 Minecraft 斜杠命令中可以正常引用玩家名称（默认：true）。
• chunk_caching：是否启用客户端区块 Blob 缓存以节省网络带宽（默认：true）。

NetherNet 传输设置

NetherNet 是 Minecraft 基岩版的现代 WebRTC/ICE 网络传输协议：

• enabled：是否允许客户端使用 NetherNet 连接（默认：true）。
• address：用于 TCP 信令和 UDP ICE 多路复用的网络套接字地址（默认："0.0.0.0:19132"）。
• external_ip：当服务器托管在 NAT 之后时对外通告的可选公网 IP 地址。
• identity_key：PKCS#8 P-384 身份私钥文件的路径，在重启时保留该文件以实现客户端的首次信任（TOFU）验证（默认："nethernet-key.der"）。
• stun_servers：用于 ICE NAT 穿透的 STUN 服务器 URL 可选列表。