Simple Voice Chat 近距离语音聊天插件

Simple Voice Chat 近距离语音聊天插件

> Minecraft 服务端的近距离语音聊天方案：玩家在游戏内按键说话，声音按距离衰减传播，支持密码群组、3D 音效、降噪与 AES 加密；覆盖 Bukkit / Paper / Folia、Fabric / Forge / NeoForge / Quilt 及 Velocity / BungeeCord 全平台。

基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Simple Voice Chat |
| 开发者 | henkelmax（Owner）、BreadLoaf（Developer）、Stridey（Art） |
| 最新版本 | 2.6.23（2026-09-04，Bukkit / Paper / Spigot / Folia）；模组端同步发布 2.6.23+26.2 等对应构建 |
| 许可协议 | 保留所有权利（All Rights Reserved，源码公开但非开源许可） |
| 兼容版本 | Minecraft Java 1.8.8 – 26.3（不同平台对应版本区间不同，以 Releases 为准） |
| 运行平台 | Bukkit / Spigot / Paper / Purpur / Folia；Fabric / Quilt / Forge / NeoForge；Velocity / BungeeCord / Waterfall |
| 项目地址 | https://modrinth.com/plugin/simple-voice-chat |
| 官方 Wiki | https://modrepo.de/minecraft/voicechat/wiki |
| 常见问题 | https://modrepo.de/minecraft/voicechat/faq |
简介

Simple Voice Chat 为 Minecraft 服务端提供了一套完整的语音聊天体系。服务端侧以一个独立进程监听 UDP 端口收发音频，游戏内的玩家只要安装了同版本的客户端模组，就能直接语音交流，不需要额外的语音软件或外部服务器。

默认采用距离衰减的传播方式：说话声以玩家为中心向四周扩散，超出 max_voice_distance（默认 48 格）就听不见，因此天然带有"贴脸密谋、远处无感"的沉浸效果。同时支持创建带密码的语音群组，实现跨越距离的团队通话。

音频链路使用 Opus 编码、OpenAL 播放、RNNoise 神经网络降噪，并可配置 3D 音效与 AES 加密。插件内置了功能完善的 API 与大量社区扩展。

> 注意：客户端必须安装与服务器版本匹配的 Simple Voice Chat 模组，否则无法接入。第三方客户端（如 Lunar、Badlion 等）通常不支持加载该模组。
核心特性
近距离语音：声音随距离衰减，默认 48 格范围，可在服务端配置中调整
两种触发方式：按键通话（Push to Talk）与语音激活（Voice Activation），按键可自定义
语音群组：创建/加入群组，支持密码保护，实现无视距离的队伍通话
whisper 与音量控制：支持轻声细语（默认 24 格）、蹲下降低传播距离、单独调整某个玩家的音量
音频处理：Opus 编码、OpenAL 输出、RNNoise 神经网络降噪、自动麦克风增益
3D 音效：按玩家相对位置输出方位感
AES 加密：语音数据全程加密传输
内置测试工具：麦克风、扬声器测试与播放，管理员可测试指定玩家的连接状态
录音功能：可将音频按独立音轨录制
跨平台互通：插件端与模组端玩家可混服通信，代理端支持 Velocity / BungeeCord / Waterfall
开放的 API：提供开发者接口，社区扩展丰富
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit / Spigot / Paper / Purpur / Folia，或 Fabric / Quilt / Forge / NeoForge，或 Velocity / BungeeCord / Waterfall |
| 客户端 | 必须安装同版本 Simple Voice Chat 模组（仅服务端装插件不足以让玩家语音） |
| 端口 | 需对外开放 UDP 24454（注意是 UDP，不是 TCP） |
| Java | 以所装版本对应的服务端要求为准 |
| 权限插件 | 支持 Bukkit 权限、Fabric Permissions API、Forge / NeoForge 权限 API；不支持混合端 |
安装方法
从 Modrinth 下载对应平台的 jar，放入服务端 plugins/（插件端）或 mods/（模组端）目录
启动服务端，插件生成配置文件（插件端为 plugins/voicechat/voicechat-server.properties）
在防火墙 / 面板中放行 UDP 24454（或自行修改 port 后放行对应端口）
重启服务端，控制台出现语音服务器启动成功日志即安装完成
玩家在客户端安装同版本模组后，按 V 键打开语音界面即可使用

> 代理端部署注意事项：需在配置中正确设置 voice_host，让客户端知道语音服务器地址；跨服场景建议配合 Velocity / BungeeCord 的转发机制。
命令一览

主命令 /voicechat，别名 /vc。所有命令只能在游戏内执行，控制台无效，且执行者客户端须已安装模组。

| 命令 | 说明 | 权限节点 |
| --- | --- | --- |
| /voicechat help | 显示所有可用命令 | — |
| /voicechat invite <玩家> | 邀请该玩家加入你所在的群组 | — |
| /voicechat join <群组名> | 加入指定名称的群组（同名群组唯一时才可用） | — |
| /voicechat join <群组ID> | 通过群组 ID 加入（一般由接受邀请时自动调用） | — |
| /voicechat leave | 离开当前群组 | — |
| /voicechat test <玩家> | 测试与指定玩家的语音连接 | voicechat.admin |

> 语音界面（V 键）另提供设置、群组管理、自我静音、关闭语音、开始/结束录音、隐藏图标等操作，群组也可直接在 GUI 中创建。
权限节点

| 权限节点 | 默认 | 说明 |
| --- | --- | --- |
| voicechat.listen | 所有人 | 是否允许接收语音（2.3.13 起取代原 voicechat.connect） |
| voicechat.speak | 所有人 | 是否允许发送语音 |
| voicechat.groups | 所有人 | 是否允许加入群组 |
| voicechat.admin | 仅 OP | 管理用途，如 /voicechat test |
配置说明

服务端配置文件按平台存放于不同位置：

| 平台 | 配置文件路径 |
| --- | --- |
| Bukkit / Spigot / Paper | plugins/voicechat/voicechat-server.properties |
| Fabric / Quilt | config/voicechat/voicechat-server.properties |
| Forge | <存档目录>/serverconfig/voicechat-server.toml |

常用配置项：
port：语音服务器端口，默认 24454；设为 -1 表示复用 Minecraft 服务器端口（不推荐，UDP 与服务器查询端口冲突可能导致崩溃）
max_voice_distance：可听距离，默认 48
whisper_distance：轻声细语距离，默认 24.0
crouch_distance_multiplier：潜行时的距离倍率，默认 0.75
whisper_distance_multiplier：细语距离倍率，默认 0.45
bind_address：绑定的 IP 地址，留空则使用 server.properties 的 server-ip，填 表示绑定所有地址
broadcast_range：广播音频的范围，<0 表示沿用 max_voice_distance
enable_groups：是否启用群组功能，默认 true
mtu_size：网络包大小，默认 1024

> 完整字段以官方 Wiki 的 Server Config 页面及实际生成的配置文件为准。
使用场景
生存服的沉浸社交：近距离交流，天然形成"凑近说话"的社交氛围
阵营 / 队伍玩法：用带密码的语音群组做跨地图指挥与战术沟通
RP 与剧情服：潜行压低音量、细语私聊等机制与角色扮演高度契合
活动与赛事：临时组建群组，方便主持人与参赛者协调
代理端整合：在 Velocity / BungeeCord 层统一提供语音服务，各子服共用一套语音服务器
相关链接
Modrinth 项目页：https://modrinth.com/plugin/simple-voice-chat
官方 Wiki（安装与配置）：https://modrepo.de/minecraft/voicechat/wiki
配置说明：https://modrepo.de/minecraft/voicechat/wiki/server_config
常见问题：https://modrepo.de/minecraft/voicechat/faq
开发者 API：https://modrepo.de/minecraft/voicechat/api
社区扩展列表：https://modrepo.de/minecraft/voicechat/addons
GitHub 源码：https://github.com/henkelmax/simple-voice-chat
Discord：https://discord.gg/4dH2zwTmyX