Simple Voice Chat 为 Minecraft Java 添加位置语音聊天。 声音会随距离和位置变化，也可以使用群组频道。语音功能同时需要服务端组件和每位参与者 Java 客户端上的匹配模组。
本指南适用于兼容的 Minecraft Java 环境。安装服务端组件不会为原生 Bedrock 服务器或 Bedrock 玩家提供 Simple Voice Chat 客户端。
准备条件
- 插件浏览器标记为与你的 Paper/Spigot 或模组加载器兼容的版本。
- 管理插件的权限；重启还需要对应的服务器控制权限。
- 每台参与电脑上安装匹配的客户端模组。
在控制面板中设置
- 打开服务器，进入插件，安装或启用 Simple Voice Chat。
- 打开 Simple Voice Chat 设置面板。
- 点击分配端口并配置。控制面板会保留专用 UDP 分配，将其写入
voicechat-server.properties，并在文件缺失时创建它。你不必猜测端口，也不要复用主游戏端口。 - 调整数值并点击保存设置。
- 出现需要重启时，通过助手或常规服务器控制重启。
可用设置
| 设置 | 作用 |
|---|---|
| 最大语音距离 | 普通说话可被听到的最大方块距离。 |
| 耳语距离 | 耳语范围，不能大于最大语音距离。 |
| 编解码器 | VOIP 适合语音，AUDIO 偏重质量，RESTRICTED_LOWDELAY 偏重低延迟。 |
| 群组 | 允许与玩家位置无关的私人语音群组。 |
| 录音 | 控制客户端能否录音；请向玩家说明规则和适用法律。 |
| 强制语音聊天 | 要求安装客户端模组。关闭时，没有模组的客户端通常仍可加入，但不能使用语音。 |
端口仅供显示并由系统自动管理。助手只修改支持的键，保留其他条目，并在写入前创建备份。
就绪状态与真实测试
就绪表示插件文件和状态正确、UDP 端口已分配，并且配置中的端口一致。这不是麦克风或互联网的端到端测试。
安装客户端模组并加入服务器。默认按 V 选择麦克风、输出设备和激活模式。然后在服务器控制台执行：
/voicechat test 玩家名
普通网页端口检测工具不能可靠替代这项 UDP 测试。
故障排查
- 检查服务端与客户端的 Minecraft 版本和加载器是否匹配。
- 助手显示插件已禁用时先启用，然后重新检查。
- 保存更改并执行要求的重启。
- 如果仍显示断开图标，请按 V 重新打开客户端设置并运行测试命令。
官方资料
功能和支持平台：Modrinth 项目页。技术文档：服务器设置、服务器配置和客户端设置。
最后技术审核：2026 年 8 月 30 日。