?️ Universal Voice Connector (UVC)
连接 Simple Voice Chat 与 Plasmo Voice 的终极服务端语音桥接插件。
概览 •
功能特性 •
命令 •
配置 •
安装 •
统计 •
社区
? 概览
Universal Voice Connector (UVC) 是一款超轻量级、纯服务端的插件,用于桥接 Simple Voice Chat 和 Plasmo Voice 之间的鸿沟。
在服务器上安装 UVC 后,使用 Simple Voice Chat 的玩家和使用 Plasmo Voice 的玩家可以在同一个世界中无缝交谈、收听和耳语——无需任何额外的客户端桥接模组!
? 核心功能
- ? 真正的双向音频桥接: Plasmo Voice 玩家和 Simple Voice Chat 玩家可以毫无障碍地互相交谈和收听。
- ⚡ Opus 帧透传: 直接传输原始 48 kHz Opus 音频数据包,原生处理加密/解密,从而实现 极低的 CPU 占用率 (< 1.5%)。
- ? 3D 空间位置音频: 距离衰减和声音方向精确反映欧几里得 3D 空间中的玩家坐标,且按世界隔离。
- ? 动态说话距离 (
/vdist): 允许 Simple Voice Chat 玩家像 Plasmo Voice 一样调整自己的说话距离!支持预设值(whisper、normal、loud)以及 4 到 48 格 的数值。
- ✨ 客户端粒子可视化器: 在玩家周围显示柔和脉动的粒子环,指示当前的语音覆盖范围(仅对执行命令的用户可见)。
- ? 持久化用户设置: 自定义语音距离会自动保存到
userdata.yml,并在重新登录或服务器重启后保持不变。
- ?️ 双客户端冲突解决器: 防止玩家在同时安装了两个语音模组时产生回声和音频反馈。
- ? Folia & Paper 原生支持: 专为 Paper、Purpur、Spigot 和 Folia 构建,采用异步调度和区域多线程支持。
⌨️ 命令与权限
玩家命令
| 命令 |
权限 |
描述 |
/vdist 或 /uvc distance |
uvc.distance (默认:所有玩家) |
查看当前语音说话距离及粒子环 |
/vdist <4-48> |
uvc.distance (默认:所有玩家) |
设置以格为单位的说话半径(例如 /vdist 20) |
/vdist <whisper|normal|loud> |
uvc.distance (默认:所有玩家) |
通过预设值设置说话距离(8m、32m、48m) |
注意:玩家必须拥有活跃的语音聊天连接才能使用 /vdist。
管理员命令
| 命令 |
权限 |
描述 |
/uvc status |
uvc.admin |
查看已连接的语音提供商及玩家数量 |
/uvc reload |
uvc.admin |
从 config.yml 重新加载配置 |
/uvc debug |
uvc.admin |
切换实时数据包路由调试日志 |
/uvc providers |
uvc.admin |
列出注册的语音提供商后端 |
⚙️ 配置
config.yml 文件会自动创建在 plugins/UniversalVoiceConnector/config.yml 中:
# Universal Voice Connector Configuration
version: 1
routing:
default_distance: 32.0 # 默认正常说话距离(单位:格)
whisper_distance: 8.0 # 默认耳语距离
max_distance: 48.0 # 允许的最大语音距离
loopback_prevention: true
dual_client:
# 当玩家同时安装了 PV 和 SVC 时的行为:
# "pv" -> 优先 Plasmo Voice, "svc" -> 优先 Simple Voice Chat, "reject" -> 踢出或静音
preference: "pv"
debug: false
? 安装
- 确保您的服务器运行的是 Paper、Purpur、Spigot 或 Folia (1.20.4 – 1.21.11),并配备 Java 21+。
- 安装 Simple Voice Chat 和/或 Plasmo Voice 服务端插件。
- 下载
UniversalVoiceConnector-0.1.0-BETA.jar 并将其放入服务器的 plugins/ 目录中。
- 重启服务器。完成!玩家可以使用任一客户端模组加入并立即进行通信。
? 统计数据
? 社区与支持
? Overview
Universal Voice Connector (UVC) is an ultra-lightweight, 100% server-side plugin that bridges the gap between Simple Voice Chat and Plasmo Voice.
With UVC installed on your server, players using Simple Voice Chat and players using Plasmo Voice can talk, listen, and whisper to each other seamlessly in the same world — without requiring any extra client-side bridge mod!
? Key Features
- ? True Two-Way Audio Bridge: Plasmo Voice players and Simple Voice Chat players can talk and hear each other with zero hassle.
- ⚡ Opus Frame Passthrough: Streams raw 48 kHz Opus audio packets directly with native encryption/decryption handling, resulting in ultra-low CPU usage (< 1.5%).
- ? 3D Spatial Positional Audio: Distance attenuation and sound direction accurately mirror player coordinates in Euclidean 3D space, isolated per-world.
- ? Dynamic Speaking Distance (
/vdist): Allows Simple Voice Chat players to adjust their speaking distance just like Plasmo Voice! Supports presets (whisper, normal, loud) and values from 4 to 48 blocks.
- ✨ Client-Side Particle Visualizer: Shows a gentle pulsing ring of particles around the player indicating their current voice reach (only visible to the command user).
- ? Persistent User Settings: Custom voice distances are automatically saved to
userdata.yml and persist across relogs and server restarts.
- ?️ Dual-Client Conflict Resolver: Prevents echo and audio feedback if a player has both voice mods installed.
- ? Folia & Paper Native: Built with asynchronous scheduling and regionized multithreading support for Paper, Purpur, Spigot, and Folia.
⌨️ Commands & Permissions
Player Commands
| Command |
Permission |
Description |
/vdist or /uvc distance |
uvc.distance (default: all) |
View current voice speaking distance & particle ring |
/vdist <4-48> |
uvc.distance (default: all) |
Set speaking radius in blocks (e.g. /vdist 20) |
/vdist <whisper|normal|loud> |
uvc.distance (default: all) |
Set speaking distance by preset (8m, 32m, 48m) |
Note: Players must have an active voice chat connection to use /vdist.
Admin Commands
| Command |
Permission |
Description |
/uvc status |
uvc.admin |
View connected voice providers and player counts |
/uvc reload |
uvc.admin |
Reload configuration from config.yml |
/uvc debug |
uvc.admin |
Toggle live packet routing debug logs |
/uvc providers |
uvc.admin |
List registered voice provider backends |
⚙️ Configuration
The config.yml file is automatically created in plugins/UniversalVoiceConnector/config.yml:
# Universal Voice Connector Configuration
version: 1
routing:
default_distance: 32.0 # Default normal speaking distance in blocks
whisper_distance: 8.0 # Default whisper distance
max_distance: 48.0 # Maximum allowed voice distance
loopback_prevention: true
dual_client:
# Behavior when a player has both PV and SVC installed:
# "pv" -> prefer Plasmo Voice, "svc" -> prefer Simple Voice Chat, "reject" -> kick or mute
preference: "pv"
debug: false
? Installation
- Make sure your server is running Paper, Purpur, Spigot, or Folia (1.20.4 – 1.21.11) with Java 21+.
- Install Simple Voice Chat and/or Plasmo Voice server plugins.
- Download
UniversalVoiceConnector-0.1.0-BETA.jar and place it into your server's plugins/ directory.
- Restart your server. That's it! Players can join with either client mod and communicate right away.
? Statistics
Real-time anonymous telemetry & active server metrics provided by bStats.org.
? Community & Support
评论 0
登录后参与评分
还没有评论,来抢沙发吧