VoxelPort

概览

VoxelPort 将 Fabric 服务器或“对局域网开放”的单人世界连接到由 VoxelPort 运营的中继基础设施。您的游戏会建立一条出站加密 WebSocket 连接，中继会分配一个公共 TCP 端口，玩家即可通过原版 Minecraft 加入该地址。

玩家无需安装此模组。

---

环境要求

要求	版本
Minecraft	26.x
Fabric Loader	0.18.6+
Java	25+

设备令牌会在首次启动时自动生成——无需 Discord、无需注册、无需申请或粘贴任何内容。

---

快速开始

单人世界

1. 在您的 Fabric 客户端中安装 VoxelPort 模组。
2. 加载您的单人世界。
3. 使用 Minecraft 的**“对局域网开放”**按钮。
4. 在暂停菜单中点击**“对 VoxelPort 开放”**。
5. 分享复制的 play.voxelport.in:<分配的端口> 地址。

加入您地址的玩家无需安装模组。

专用服务器

1. 在您的 Minecraft 服务器上安装 Fabric Loader。
2. 将 VoxelPort 模组的 JAR 文件放入服务器的 mods/ 文件夹。
3. 重启服务器。
4. 运行 /voxelport start。
5. 分享 /voxelport address 命令显示的地址。

设备令牌会自动为您生成；/voxelport token <令牌> 仅作为高级手动覆盖方式存在。

---

命令

/voxelport start
/voxelport start <端口>
/voxelport status
/voxelport address
/voxelport stop
/voxelport token <令牌>   （高级覆盖方式——通常无需使用）

/voxelport start 会自动使用服务器配置的 Minecraft 端口。仅在您需要暴露不同的本地端口时，才使用 /voxelport start <端口>。

---

配置

模组将服务器设置保存在：

config/voxelport/settings.properties

示例配置：

server_token=vp_...        # 自动生成；请勿分享
public_host=play.voxelport.in
server_host=127.0.0.1
max_connections=200
relay_url=wss://relay.voxelport.in

除非您在 VoxelPort 支持下进行测试，否则请将 relay_url 保持为 wss://relay.voxelport.in。

---

工作原理

1. 模组建立到中继的出站 WebSocket 连接。
2. 它使用自动生成的设备令牌进行注册。
3. 中继分配一个公共 TCP 端口。
4. 玩家通过原版 Minecraft 加入 play.voxelport.in:<分配的端口>。
5. Minecraft 流量通过中继桥接到您的 Fabric 服务器。

中继是一个桥接器，而非游戏服务器。您的世界、模组和玩家数据都保留在您自己的服务器上。

---

故障排除

状态显示已断开 请确保您的主机允许到 relay.voxelport.in 的 443 端口出站 HTTPS/WSS 流量。

玩家无法加入 运行 /voxelport status 或 /voxelport address，然后确保玩家加入的是此处显示的公共地址。

出现压缩或数据包错误导致断开连接 请更新到最新的模组版本。服务器模式会缓冲分片的 WebSocket 帧，并序列化中继写入，以防止数据包流损坏。

---

链接

• 网站
• 状态页面
• VoxelPort GitHub

---

许可证

MIT 许可证。请参阅随附的许可证文件。

VoxelPort 与 Mojang、Microsoft、Fabric、CurseForge、Modrinth 或 Discord 无任何关联。