Simple Voice Chat 服务器设置教程

Simple Voice Chat 的工作原理

• 服务器和玩家都需要安装。服务器运行模组或插件，每个想使用语音的玩家都要在客户端安装模组。没有安装的玩家仍然可以加入和游玩，只是没有语音。
• 支持多种平台。模组可用于 Fabric、NeoForge、Forge 和 Quilt，插件可用于 Paper、Spigot、Purpur 和 Folia，而且它们之间可以互通。即使是 Paper 服务器，玩家也仍然需要客户端模组。
• 语音使用单独的 UDP 端口，默认是 24454。只有服务器需要开放该端口，玩家无需开放任何端口。
• 仅支持 Java Edition。Bedrock 玩家（包括通过 Geyser 加入的玩家）无法使用。Lunar 和 Feather 等自定义客户端也不受支持。

安装模组或插件

1. 从 Modrinth 或 CurseForge 下载 Simple Voice Chat：Paper 或 Spigot 用插件文件，其他情况下载对应加载器和 Minecraft 版本的模组文件。
2. 将其放入 plugins（Paper、Spigot）或 mods（Fabric、NeoForge、Forge），然后重启一次服务器。参见如何安装 Minecraft 插件。
3. 首次启动会生成配置文件：
   • Paper 和 Spigot 上为 plugins/voicechat/voicechat-server.properties；
   • 模组服务器上为 config/voicechat/voicechat-server.properties。
4. 告诉玩家安装与其加载器和 Minecraft 版本对应的模组。

设置语音端口

语音端口必须开放 UDP，并且不能与游戏端口相同。

• 在自己的机器上：在路由器上转发 UDP 24454，并在防火墙中放行。在 Docker 中映射为 24454:24454/udp；如果缺少 /udp，只会转发 TCP，语音将无法工作。
• 在托管服务器上：你需要为服务器分配第二个端口，并把这个端口号填入配置。

在 HytHost Minecraft 主机上，你可以自己完成：

1. 在面板中打开 Network 标签页并添加一个分配（allocation）。面板会在服务器 IP 上选择一个空闲端口，并同时开放 TCP 和 UDP。
2. 打开 voicechat-server.properties，将 port 设为该端口号，例如：

   port=25571

3. 重启服务器。

voice_host 保持为空：新端口与游戏使用同一个 IP，玩家的模组会自动找到它。如果 Network 标签页无法添加端口，请提交工单，我们会为你添加。

重要的设置项

编辑文件后请重启服务器。

玩家须知：首次使用

• 按 V 打开语音聊天菜单。首次使用时，模组会询问麦克风、扬声器，以及使用按键说话还是语音激活。
• 可以通过菜单加入群组，也可以使用 /voicechat join <group>；/voicechat leave 用于退出群组。

玩家无法连接语音时

• 先测试：以管理员身份运行 /voicechat test <player>，检查该玩家的语音连接是否正常。
• 配置中的端口错误：voicechat-server.properties 中的端口号必须与分配给服务器的额外端口完全一致。
• 用了 TCP 而不是 UDP：语音需要 UDP。在线端口检测工具只测试 TCP，结果没有参考价值；请改用测试命令。
• 与 Geyser 端口冲突：如果服务器还为 Bedrock 玩家运行 Geyser，请给语音分配一个与 Geyser 不同的端口。
• 版本不匹配：玩家客户端上的模组必须与服务器的主版本一致，例如两边都是 2.6.x。
• 玩家隔很远也能听到彼此：他们很可能在同一个群组中。