Voice Bridge

插件

· 作者 andreypfau

在服务器端桥接 Plasmo Voice 和 Simple Voice Chat

0 本站下载 0 关注 更新于 8 个月前

需要前置:Simple Voice Chat、Plasmo Voice

最新 1.1.0 · 1.21.11 · Bukkit / Folia

一键开服(送7天)

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

要求

安装

  1. 在您的 Paper 服务器上安装 Simple Voice Chat 和 Plasmo Voice
  2. 下载 voice-bridge-<version>.jar
  3. 将其放入服务器的 plugins/ 目录中
  4. 重启服务器

从源码构建

./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 玩家的音频

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源