☀️ 夏季促销：使用优惠码 享终身 9 折

在您的 Minecraft 服务器上配置 Simple Voice Chat

在 ServerPrism Minecraft 服务器上安装并配置 Simple Voice Chat mod — 通过 Mods、Console、Network 和 Files 标签逐步完成。

Last updated July 17, 2026

Simple Voice Chat 是 Minecraft 上很受欢迎的语音聊天 mod，可在 Modrinth 和 CurseForge 获取。在 ServerPrism 的 Minecraft 服务器上，通过面板大约 3 分钟即可完成配置 — 下面按照仪表板的标签页给出完整流程。

1. 在服务器上安装 mod

在面板中打开您的服务，点击左侧菜单中的 Mods。

  1. 搜索 Simple Voice Chat。
  2. 选择与您的加载器和 Minecraft 版本匹配的构建版本（Fabric / Forge / NeoForge）。例如，在 Fabric 1.21.1 上请使用 Fabric 1.21.1 的构建。
  3. 点击 Install — 面板会把 jar 放入 /mods 目录并标记为已安装。

2. 重启服务器

切换到 Console 标签，点击 Restart。等待以下行出现：

Done (X.XXXs)! For help, type "help"

Simple Voice Chat 会在首次启动时生成它的配置文件。

3. 让每位玩家安装匹配的客户端 mod

这是大家以为 mod 坏掉的最常见原因：每位玩家也需要在自己的 Minecraft 客户端里安装 Simple Voice Chat。如果没有客户端 mod，服务端 mod 对这位玩家就什么都不做。

客户端 mod 必须在加载器、Minecraft 版本和构建号上与服务端 mod 完全一致。Modrinth：https://modrinth.com/mod/simple-voice-chat

4. 将语音端口设置为 Minecraft 端口（ServerPrism 上很重要）

默认情况下 Simple Voice Chat 会尝试监听 UDP 端口 24454，这是它自己的专用端口。在 ServerPrism 上，您的服务只分配一个公网端口（也就是您在 Minecraft 里连接所用的端口）— 所以 SVC 的默认端口从公网根本不可达，客户端会显示一个 "voice chat not connected" 图标（带红色斜杠的插头），尽管其他一切都正常。

修复只需要改一行配置。打开 Files 标签，编辑：

config/voicechat/voicechat-server.properties

将 port 一行改为：

port=-1

这会让 SVC 绑定到与 Minecraft 相同的 UDP 端口。在 Console 标签里重启。日志应当显示：

[voicechat] Voice chat server started at 0.0.0.0:<您的 MC 端口>

（SVC 自带的注释不建议使用 port=-1，因为可能与 Minecraft 的 UDP query 冲突 — 但 Paper 默认是 enable-query=false，所以在 ServerPrism 上是安全的，除非您手动开启了 query。）

如果您希望语音使用单独的端口，请进入 Network 标签 → Request Allocation，然后在配置里设置 port=<新端口>（而不是 -1）。

5. 可选 — 调整其他设置（Files 标签）

仍是 voicechat-server.properties 文件，常用选项：

max_voice_distance=48            # 最大语音范围（方块数，默认 48）
codec=VOIP                        # 聊天型服务器用 VOIP，音乐/RP 用 AUDIO
max_voice_chat_connections=-1     # -1 = 不限制
allow_recording=false             # 是否允许客户端录音

每次修改后请在 Console 标签重启服务器。

6. 在游戏内测试

  1. 安装好客户端 mod 后加入服务器。
  2. 按 V 打开语音聊天菜单（默认按键 — 可重新绑定）。
  3. 首次连接时客户端会请求麦克风权限 — 请允许。
  4. 您应能在同样安装了该 mod 且在范围内的玩家名旁看到一个小的语音图标。

常见问题

  • "Voice chat is disabled on this server" → mod 未在服务端加载。请在 Console 启动日志中查找 voicechat 横幅；若没有，说明 jar 的加载器或 Minecraft 版本不对。
  • 左下角出现带红色斜杠的插头图标 → mod 已加载，但 UDP 到不了语音服务器。在 ServerPrism 上 99% 是默认 24454 端口的问题 — 见步骤 4。
  • "Voice not transmitting" → 对方很可能没有装客户端 mod。请他/她检查自己的 mods/ 文件夹。
  • "Voice cutting out" → 几乎都是客户端这边的 UDP/防火墙问题，不是服务器的问题。关闭 VPN 或公司/学校的严格防火墙通常就能解决。

如果面板表现与本文不一致，请在支持工单中附上截图回复，我们会跟进。