SocketSVC
Minecraft 的近距离语音聊天,通过 WebSocket 而非 UDP 传输。 玩家在游戏中根据彼此的距离来互相听到声音,无需额外开放端口以穿透防火墙——语音流量与你浏览器用于 HTTPS 的连接类型相同。
| ? 文档 | socketsvc.vercel.app |
| ⬇️ 下载 | socketsvc.vercel.app/d — 选择你的版本、加载器和端侧 |
| ? Discord |
安装内容
每位玩家都需要安装客户端模组。服务器需要安装以下服务端组件之一。
| 安装位置 | 指南 | |
|---|---|---|
| 客户端 | mods/ — Fabric, Quilt, NeoForge 或 Forge |
安装教程 |
| 服务端(插件) | plugins/ — Paper, Purpur 或 Folia |
服务器设置 |
| 服务端(模组) | mods/ — Fabric, Quilt, NeoForge 或 Forge |
服务器设置 |
| 代理 (可选) | plugins/ — Velocity, BungeeCord 或 Waterfall |
代理中继 |
Fabric 和 Quilt 需要 Fabric API。Mod Menu 为可选。
你也可以在单人游戏中使用语音功能——将世界开启为局域网联机,客户端将自行托管语音服务器。详见 局域网与单人游戏。
为什么使用 WebSocket 而非 UDP
- 无需额外转发端口。 语音连接最初是普通的 HTTP 升级请求,因此反向代理、Cloudflare Tunnel、ngrok 或 Docker/Pterodactyl 面板均可直接承载,无需额外配置。
- 真正的
wss://加密。 利用你已运行的 TLS 终止服务实现加密。 - 单一套接字。 音频、玩家列表、扬声器快照和状态更新共享同一条连接。
- 整个网络只需一个公网端口。 代理中继 作为所有后端的入口,使得各后端专用的语音端口保持内部访问。
功能特性
语音
- 具有距离衰减和左右声道的近距离音频
- 按键说话或语音激活、静音和免提模式
- 独立调节每位玩家的音量,无需降低所有人的音量即可调低某人的声音
- Opus 音频编码,配备抖动缓冲区和丢包 concealment(隐藏),并支持自动重连
音质
- 噪音抑制(RNNoise,可选按需下载的 DeepFilterNet)
- 回声消除、自动增益和限制器
- 耳机空间音频
不止于对话
便利性
- 多人列表中的服务器旁显示语音聊天徽章,让你在游戏前就知道是否支持语音
- 可与 Simple Voice Chat 和 Plasmo Voice 共存 — 保留任一已安装的模组,每个服务器都会自动匹配正确的模组
- 游戏内更新程序,在下一次重启时安装新版本
- 支持 10 种语言,跟随 Minecraft 的语言设置
支持版本
| Minecraft | Fabric / Quilt | NeoForge | Forge |
|---|---|---|---|
| 1.21.11 | ✅ | ✅ | ✅ |
| 26.1 | ✅ | ? beta | ✅ |
| 26.1.1 | ✅ | ? beta | ✅ |
| 26.1.2 | ✅ | ✅ | ✅ |
| 26.2 | ✅ | ✅ | ✅ |
| 26.3 | ✅ | ✅ | ✅ |
Paper 插件和代理插件均为单个 jar 文件,适用于以上所有版本。 标记为 beta 的构建是基于 beta 版加载器生成的,而非 SocketSVC 的 beta 版本。
快速开始
- 将客户端 jar 放入
mods/,将服务端 jar 放入plugins/或mods/。 - 启动服务器一次——它将生成
config.yml(Paper)或socketsvc-server.yml(服务端模组)。 - 将
public-url设置为玩家可访问的地址,然后执行/ssvc-server reload。
其余设置均有适用于局域网的默认值。对于位于 TLS 后的公共服务器,请参阅 服务器配置;对于网络环境,请参阅 代理配置。
在游戏中按 V 打开设置,按 B 说话,按 G 进入语音组。完整按键列表见 控制键。
面向开发者
SocketSVC 提供了一个空间扬声器 API,以便你自己的插件或模组可以在世界中放置音频——例如音乐、广播通知或带有名称的世界内扬声器。
遇到问题?
首先查看 故障排除 和 兼容性 ——它们涵盖了常见原因,包括与其他语音模组的冲突。然后在 Discord 上提问。
指标
SocketSVC
Proximity voice chat for Minecraft, carried over WebSockets instead of UDP. Players hear each other based on how close they are in-game, and there is no second port to punch through your firewall — voice rides the same kind of connection your browser already uses for HTTPS.
| ? Documentation | socketsvc.vercel.app |
| ⬇️ Downloads | socketsvc.vercel.app/d — pick your version, loader and side |
| ? Discord |
What to install
Every player needs the client mod. The server needs one of the server-side pieces.
| Install | Guide | |
|---|---|---|
| Client | mods/ — Fabric, Quilt, NeoForge or Forge |
Installation |
| Server (plugin) | plugins/ — Paper, Purpur or Folia |
Server setup |
| Server (mod) | mods/ — Fabric, Quilt, NeoForge or Forge |
Server setup |
| Proxy (optional) | plugins/ — Velocity, BungeeCord or Waterfall |
Proxy relay |
Fabric and Quilt need Fabric API. Mod Menu is optional.
You can also use voice in singleplayer — open a world to LAN and the client hosts the voice server itself. See LAN and singleplayer.
Why WebSocket instead of UDP
- Nothing extra to forward. The voice connection starts as an ordinary HTTP upgrade, so a reverse proxy, Cloudflare Tunnel, ngrok, or a Docker/Pterodactyl panel carries it with no extra configuration.
- Real
wss://encryption from the TLS termination you already run. - One socket. Audio, the player roster, speaker snapshots and status updates all share a single connection.
- One public port for a whole network. The proxy relay fronts every backend, so per-backend voice ports stay internal.
Features
Voice
- Proximity audio with distance falloff and left/right panning
- Push-to-talk or voice activation, mute and deafen
- Per-player volume, so you can turn one person down without turning everyone down
- Opus audio with a jitter buffer and packet-loss concealment, plus automatic reconnect
Audio quality
- Noise suppression (RNNoise, with optional DeepFilterNet downloaded on demand)
- Echo cancellation, automatic gain and limiting
- Headphone spatial audio
More than talking
- Voice groups — named channels you join from the in-game menu
- Soundboard — play local clips to nearby players
- Instruments — MIDI keyboard, line-in, drum machine and loop station
- Head animation that follows the speaker's voice
- Custom icon packs, including animated ones
Quality of life
- A voice-chat badge next to servers in the multiplayer list, so you know before you join
- Works alongside Simple Voice Chat and Plasmo Voice — keep either installed, and each server gets the right one
- In-game updater that installs a new build on your next restart
- Available in 10 languages, following your Minecraft language setting
Supported versions
| Minecraft | Fabric / Quilt | NeoForge | Forge |
|---|---|---|---|
| 1.21.11 | ✅ | ✅ | ✅ |
| 26.1 | ✅ | ? beta | ✅ |
| 26.1.1 | ✅ | ? beta | ✅ |
| 26.1.2 | ✅ | ✅ | ✅ |
| 26.2 | ✅ | ✅ | ✅ |
| 26.3 | ✅ | ✅ | ✅ |
The Paper plugin and the proxy plugin are one jar each and work across all of the above. Builds marked beta are built against a beta loader release, not a beta of SocketSVC.
Getting started
- Put the client jar in
mods/, and the server jar inplugins/ormods/. - Start the server once — it writes
config.yml(Paper) orsocketsvc-server.yml(server mod). - Set
public-urlto an address your players can reach, then/ssvc-server reload.
Everything else has a default that works on LAN. For a public server behind TLS, see Server configuration; for a network, see Proxy configuration.
Press V in game to open settings, B to talk, G for voice groups. Full list under Controls.
For developers
SocketSVC exposes a spatial speaker API so your own plugin or mod can place audio in the world — music, PA announcements, named in-world speakers.
- Spatial audio API
- API reference — client, Paper, server mod and proxy
- Voice protocol
Something not working?
Start with Troubleshooting and Compatibility — they cover the usual causes, including other voice mods. Then ask on Discord
Metrics
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SocketSVC
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 客户端: CurseForge 构建版本不再从我们的服务器下载代码
- 客户端: 鼓机工具栏布局、每次击打的音量及预设
- 客户端: 在标题屏幕按 F3 + 9 即可打开语音图表
- 客户端: F3 界面在原版图表按键下命名了 F3 + 9
- 服务端: 启用广播功能可关闭全服广播
- 客户端: 群组覆盖层占据屏幕一半,并显示最后发言者
- 客户端: 当聊天窗口打开时保持群组覆盖层显示
- 客户端: 列表优先显示群组所有者,然后是用户自己,再按名称排序
- 在游戏中显示广播内容,并允许管理员从玩家列表中切换它们
- 服务端: /ssvc-server broadcast 命令让某位玩家的语音被所有人听到
- 客户端: /ssvc report 复制诊断信息用于提交错误报告
- 服务端: 标记正在丢失音频的监听者
- 客户端: 说明“系统默认”设备具体指哪个设备
- 客户端: 当 macOS 阻止麦克风访问时发出警告
- 客户端: 设置优化——静音提示、已翻译的插件问题、麦克风电平表、快捷键
- 更新: 信任备份签名密钥,并允许弃用旧密钥
- 客户端: 将音效板文件夹作为播放列表播放
- 在服务端模组和代理上接受 Minecraft 端口的语音输入
- Paper: 接受 Minecraft 端口的语音输入
- 客户端: 按名称列出玩家,并将玩家标签页移至乐器标签页之前
修复
- 客户端: 静音状态下麦克风测试仍在继续工作
- 客户端: 退出世界会关闭其中放置的本地音频通道
- 客户端: 声板回环在设备未锁定且无法打开时会关闭并退避
- 客户端: DeepFilterNet 从捕获线程加载,并在下载完成后被拾取
- 客户端: LAN 语音握手支持 IPv6 主机
- 客户端: 麦克风状态获取器仅读取一次捕获数据,因此断线不会在通话中将其置为 null
- 客户端: 静音不再在持有语音锁时保存配置
- 客户端: 每个配置集合在加载后保持线程安全
- 客户端: 通话中途失败的扬声器会配合麦克风的退避机制重新打开
- 影院: Play <url> 检查及 Twitch 检测到的源类型已确认
- 影院: yt-dlp 超时在其输出仍打开时触发
- 更新器: 停止将可替换的发布资源缓存为不可变
- 更新器: 限制每地址的 Bearer 猜测次数,并拒绝过短的管理员令牌
- 更新器: 无法读取 addons.json 的冷启动实例会失败,而不是缓存空索引
- 更新器: 对于公共仓库,从 CDN 读取发布资源文本
- 更新器: 缺失或损坏的频道清单不会保留之前已固定的项目
- 更新器: 手动制作的预发布版本永远不会出现在正式发布频道中
- 签名: 模组签名绑定加载器和侧(client/server)
- 客户端: 循环器的按钮不再等待停滞的线路输入
- 客户端: 被替代的乐器打开后会关闭其 MIDI 端口
- 客户端: 恶意声音文件无法耗尽内存
- 客户端: 下载在列出的大小处停止,不留 .part 文件
- 服务端: 占位符和模组名称查找停止在后台线程读取 PlayerList
- 服务端: 在监听者交换期间发出的静音会在交换后生效
- 服务端: /ssvc-server reload 在启动失败后开始语音服务
- paper: 关机停止模组并关闭空间音频核心
- 服务端: 被拒绝的端口更改会将恢复后的监听者交还给模组
- 代理: 重载时错误的 config.yml 会让正在运行的中继保持在线
- 服务端: 服务器的更新检查拒绝纯 HTTP 端点,如同客户端一样
- 协议: 拒绝无法解码的 CREATE 密码和仅包含空格的行
- 协议: 在最大的客户端帧中为声板类型字节留出空间
- 服务端: 在被设置为广播的同时离开语音的玩家不会被遗留为广播状态
- 服务端: Can_hear 和测试命令应用静音、静音模式和扬声器的范围层级
- 发布: 恢复标签构建提交,并在下一次版本推送失败时幸存
- 发布: 预检在缺少或不信任的签名密钥上阻塞
- 发布: 未跟踪的文件会使树处于脏状态
- 脚本: Prepare_hrtf 将银行写入客户端加载的位置
- 更新: 替换同名 jar 时,在 Windows 释放它之前重试
- 影院: 服务器无法让玩家在端口上收听或访问他们的局域网
- 影院: 仅提供 Fabric 使用的旧版 Minecraft 影院 jar
- 服务端: 权限模组控制 Forge 和 NeoForge 上的所有节点
- 发布: Modrinth 和 CurseForge 上传仅包含此版本的 Minecraft 版本
- 签名: 在签名或列出摘要前对每个 jar 进行哈希处理
- 更新器: 管理员登录在 TLS 代理后方工作,其 Cookie 为 Secure
- 更新器: yt-dlp 发布在玩家获得它们之前等待两天
- 更新器: 工具校验和读取失败被视为错误,而不是较旧或缺失的工具
- 更新器: 分页浏览发布直到看到稳定发布和所有固定项
- 客户端: 格式错误或过大的图标包会导入失败,而不是崩溃
- 客户端: 来自模组的 NaN 范围不再使所有音频静音
- 更新: 失败的更新不再导致游戏丢失该模组
- 客户端: 更新和必需模组不再向后兼容
- 客户端: 更新服务和模组索引仅通过 https 请求
- 客户端: Yt-dlp 和 FFmpeg 仅从其上游发布下载
- 客户端: 语音服务器不再能用一个帧头耗尽内存
- 服务端: 消失的玩家不会出现在组快照和邀请中
- 服务端: 断线不再锁定其他玩家的连接
- 服务端: 静音玩家的麦克风永不中继
- 服务端: 来自其他线程的关闭不再停止语音监听器
- 客户端: 主按钮上的白色图标保持可读
- 客户端: NPC 上方没有“不在语音中”图标
- 客户端: 当隐藏的人说话时,组覆盖行保持原位
- 服务端: 将其他世界中的扬声器排除在扬声器列表之外
- 广播标签位于右下角,HUD 显示处无操作栏
- 核心: 保持客户端发送队列不变
- 客户端: 用省略号截断末尾文本,并在悬停时完整显示
- 更新器: 当 GitHub 失败时,继续提供最后一个有效响应
- 代理: 替换玩家发送给中继的转发头
- 更新: 停止超过签名大小的下载
- 客户端: 使 < 箭头在选项行中后退
- 客户端: 使用 Esc 关闭设置时保留首次运行选择
- 客户端: 统一 zh_tw 措辞
性能
- 服务端: 停止第二次复制每个中继帧
- 服务端: 停止在负载下音频发送队列丢弃帧
- 客户端: 停止每帧重做 GUI 工作,并将 Done 的大小调整为其标签
- 代理: 在线程虚拟线程上运行中继连接
更改
- 客户端: 使用 InputConstants 命名鼠标按钮,而非 0/1
- 导入类型而非拼出完全限定名
- 影院: 一个辅助函数剥离 URL 的查询和片段
- 脚本: 每个凭证一个 scripts/.env 读取器
此外还有 24 个维护提交(构建、文档、测试)。
完整更新日志:
新增
- release: 将 Paper 和代理插件发布至 Hangar
- metrics: 在 Paper、Velocity 和 Bungee 上启用 FastStats 错误追踪
- update: 保留安装签名前发布的构建版本
- client: 在“附加组件”和“更新”选项卡中提供允许使用未签名构建的选项
- update: 允许有意跳过签名检查的安装操作
- release: 为每个版本重新开始开发构建编号
- client: 首次加入时询问是否自动更新
- client: 在下载所需内容前,每个服务器仅询问一次
- update: 仅安装维护者签名的发行版
- client: 三次连接失败后停止重连
- client: 优化 F3 + 9 图表的曲线、动画与校正
- client: 使 F3 + 9 图表更加平滑
- client: F3 + 9 打开语音连接的实时图表
- server: 在
/ssvc-server status中显示语音流量 - server: 记录隧道后玩家的真实地址,并在切换过程中保持音频连接
- client: 无缝重连语音连接,消除玩家可感知的中断
修复
- update: 绝不允许服务将客户端回退到签名前的构建版本
- client: 提示附加组件已安装,而非提示没有适用于此游戏的组件
- release: 在确定上一个开发构建之前获取标签信息
- client: 不再将所有旧的未签名附加组件构建列为问题
- client: 即使检查已在运行,也下载已协商好的更新
- release: 在试运行中计算 jar 文件数量,而非减去二
- client: 从发送线程中移除断开的语音连接
另含 7 次维护提交(构建、文档、测试)。
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧