51 lines
2.3 KiB
Markdown
51 lines
2.3 KiB
Markdown
# 基岩版与 NetherNet
|
||
|
||
Pumpkin 原生支持 Minecraft 基岩版客户端，包括 NetherNet WebRTC/ICE 传输层以及用户名自定义。
|
||
|
||
## 配置
|
||
|
||
:::code-group
|
||
|
||
```toml [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 可选列表。
|