Voice Bridge
一个服务端 Paper 插件,用于桥接 Simple Voice Chat 和 Plasmo Voice 之间的近距离语音聊天,让使用不同语音模组的玩家能够互相听到对方。
工作原理
Simple Voice Chat (SVC) 和 Plasmo Voice (PV) 均使用 Opus 编码音频(48 kHz、单声道、20 ms 帧)。Voice Bridge 拦截来自各模组 API 的音频数据包并将其转发给另一方——无需转码。结果是低延迟、跨模组的近距离语音聊天,且 CPU 开销极低。
SVC Player ──► SVC API ──► Voice Bridge ──► PV API ──► PV Player
PV Player ──► PV API ──► Voice Bridge ──► SVC API ──► SVC Player
要求
- Paper 1.21.4+(或 Folia)
- Java 21+
- Simple Voice Chat(服务端插件)
- Plasmo Voice(服务端插件)
安装
- 在您的 Paper 服务器上安装 Simple Voice Chat 和 Plasmo Voice
- 下载
voice-bridge-<version>.jar - 将其放入服务器的
plugins/目录中 - 重启服务器
从源码构建
./gradlew build
插件 jar 文件将位于 build/libs/ 中。
运行开发服务器
# 使用 Mojang 映射(用于调试)
./gradlew runDevBundleServer
# 使用混淆(类似生产环境)
./gradlew runServer
配置
首次运行时会在 plugins/voice-bridge/ 目录下生成 config.yml:
bridge:
enabled: true # 启用/禁用桥接功能
debug: false # 启用调试日志
proximity:
default-distance: 48.0 # 默认语音范围(方块单位)
whisper-multiplier: 0.33 # 耳语范围 = distance * multiplier
max-distance: 128.0 # 允许的最大语音距离
audio:
passthrough: true # Opus 直通模式(推荐)
force-transcode: false # 强制转码(尚未实现)
按世界覆盖距离设置
您可以为特定世界覆盖默认的语音距离:
proximity:
world-overrides:
world_nether: 24.0
world_the_end: 64.0
命令
| 命令 | 描述 |
|---|---|
/voicebridge status |
显示桥接状态、指标和配置 |
/voicebridge players |
列出活跃的桥接会话 |
/voicebridge reload |
重新加载配置 |
/voicebridge debug [on|off] |
切换调试日志 |
别名:/vb
权限:voicebridge.admin(默认:op)
架构
┌────────────────────────────────────────────────┐
│ VoiceBridgePlugin │
├───────────┬───────────┬────────────┬───────────┤
│ SvcAdapter│ PvAdapter │ AudioRelay │ Session │
│ │ │ │ Manager │
├───────────┴───────────┴────────────┴───────────┤
│ SpatialMapper │ BridgeConfig │ BridgeMetrics │
└────────────────────────────────────────────────┘
- SvcAdapter — 通过
VoicechatPlugin与 Simple Voice Chat 集成 - PvAdapter — 通过
@Addon/AddonInitializer与 Plasmo Voice 集成 - AudioRelay — 中央路由器,负责在适配器之间转发音频帧
- SessionManager — 跟踪每位玩家使用的模组
- SpatialMapper — 在 SVC 的浮点距离和 PV 的短整型距离之间进行转换
已知限制
- 不支持群组/频道桥接(仅支持近距离聊天)
- 转码模式尚未实现(仅支持直通模式)
- 在某些边缘情况下,仅使用 SVC 的玩家可能无法收到 PV 玩家的音频
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧