VoiceCraft.Java
连接 VoiceCraft、Simple Voice Chat 和 Plasmo Voice,实现 Java 版与基岩版跨客户端的近距离语音聊天插件。
VoiceCraft.Java 将使用不同语音客户端的玩家带入同一个共享的近距离语音空间。使用 Simple Voice Chat 的玩家可以与使用 Plasmo Voice 或独立 VoiceCraft 客户端的玩家交谈——并通过他们已使用的客户端听到对方的声音。
这对于跨平台服务器尤其有用。Java 版玩家可以保留他们喜欢的语音聊天模组,而通过 Geyser 加入的基岩版玩家则可以通过 VoiceCraft 客户端参与,无需安装 Java 版模组。
一个服务器,支持所有客户端
| 玩家客户端 |
连接方式 |
| VoiceCraft 客户端 |
连接到 VoiceCraft 后端,并通过 /voice bind 绑定到 Minecraft 玩家 |
| Simple Voice Chat |
通过官方 SVC 服务端插件/模组及其公共 API 连接 |
| Plasmo Voice |
通过官方 Plasmo Voice 服务端插件/模组及其公共 API 连接 |
| 通过 Geyser 连接的基岩版 |
使用独立的 VoiceCraft 客户端,无需 Java 版客户端模组 |
所有已连接的玩家共享相同的定位音频环境。VoiceCraft.Java 同步 Minecraft 世界、位置、旋转、近距离距离、洞穴回声、水下消音、玩家身份、说话生命周期以及支持的静音/禁言状态。
功能特性
- VoiceCraft、Simple Voice Chat 和 Plasmo Voice 之间的跨客户端近距离音频。
- Java 版和基岩版玩家在同一个对话中进行语音聊天。
- 原生 SVC 和 Plasmo API 桥接,无需协议模拟。
- 自动安装兼容的官方 SVC/Plasmo 服务端依赖项。
- 一个 VoiceCraft.Java 配置文件即可配置 VoiceCraft、SVC 和 Plasmo 的绑定/广播端口。
- 在 Paper 上自动下载、配置、启动和关闭 VoiceCraft Server。
- 单 Paper 服务器的直连模式。
- Velocity 和 BungeeCord 模式,适用于多服务器网络。
- 支持代理网络中 SVC 和 Plasmo 的 UDP 中继。
- 位置、维度、近距离、洞穴回声和水下音频同步。
- 本地化的配置和消息。
原版与基岩版的语音状态
没有安装 SVC 或 Plasmo 的玩家可以在其他未安装模组的玩家头顶看到轻量级的原版兼容语音状态指示器。这些指示器可通过 Geyser 工作,并显示玩家是否断开连接、已连接、正在说话、被静音或被禁言。
该覆盖层仅对查看者可见:使用 SVC 或 Plasmo 的玩家不会收到它,因此它不会与他们模组提供的原生指示器重叠。每个符号、颜色、高度、更新间隔和视距均可配置。
安装模式
Paper
安装 Paper jar 包以用于独立服务器。VoiceCraft.Java 可以自动下载和管理匹配的 VoiceCraft Server 运行时,或者连接到现有的 VoiceCraft 后端。
当需要接受那些客户端时,请在 config.yml 中启用 Simple Voice Chat 和/或 Plasmo Voice 适配器。默认情况下,两个适配器均处于禁用状态。
Velocity 或 BungeeCord
在代理服务器和每个 Paper 后端服务器上安装 VoiceCraft.Java。代理服务器拥有中央 VoiceCraft 连接,而后端服务器提供玩家状态和适配器会话。可选的 UDP 中继可保持 SVC 和 Plasmo 客户端的连接,即使玩家在后台服务器之间移动。
要求
- Minecraft 1.20.x 需要 Java 17,1.21.x 需要 Java 21,26.x 需要 Java 25。
- 需要 Paper 以支持语音适配器和托管的 VoiceCraft 运行时。
- 仅在运行多服务器网络时才需要 Velocity 或 BungeeCord。
- 每个启用的语音适配器都需要可达的 UDP 端口。
为你想要支持的 Java 版客户端至少启用一个官方语音插件/模组。VoiceCraft.Java 可以自动下载兼容的依赖项,你也可以自行安装。官方插件负责客户端握手和 UDP 传输;VoiceCraft.Java 将其最终的 Opus 帧路由到 VoiceCraft Server。
VoiceCraft.Java 专注于跨客户端最重要的共享体验:近距离音频、身份、说话状态和语音控制。客户端专属功能(如 Simple Voice Chat 的私人群组)保留在其各自的生态系统中,而不是为其他客户端进行虚假模拟。
支持的平台
- Paper, Purpur, Folia, Spigot, 和 Bukkit
- Fabric
- Forge
- NeoForge
- Velocity
- BungeeCord
Minecraft 1.20.1 及更高版本通过按版本划分的模组制品提供支持。并非每个 Minecraft/加载器组合都同时拥有上游语音模组;VoiceCraft.Java 会保持可用的桥接正常工作,并在目标平台上不存在已启用的适配器时记录清晰的警告。
VoiceCraft.Java 根据 GNU Affero General Public License v3.0 或更高版本授权。
VoiceCraft.Java
The ultimate cross-client proximity voice chat plugin connecting VoiceCraft, Simple Voice Chat, and Plasmo Voice across Java and Bedrock.
VoiceCraft.Java brings players using different voice clients into one shared proximity voice space. A player using Simple Voice Chat can talk to someone using Plasmo Voice or the standalone VoiceCraft client — and hear them back through the client they already use.
It is especially useful for cross-play servers. Java players can keep their preferred voice-chat mods, while Bedrock players joining through Geyser can participate through the VoiceCraft client without installing Java mods.
One server, every supported client
| Player client |
How it connects |
| VoiceCraft client |
Connects to the VoiceCraft backend and binds to the Minecraft player with /voice bind |
| Simple Voice Chat |
Connects through the official SVC server plugin/mod and its public API |
| Plasmo Voice |
Connects through the official Plasmo Voice server plugin/mod and its public API |
| Bedrock through Geyser |
Uses the standalone VoiceCraft client with no Java client mod required |
All connected players share the same positional audio environment. VoiceCraft.Java synchronizes Minecraft worlds, positions, rotation, proximity distance, cave echo, underwater muffling, player identity, speaking lifecycle, and supported mute/deafen states.
Features
- Cross-client proximity audio between VoiceCraft, Simple Voice Chat, and Plasmo Voice.
- Voice chat for Java and Bedrock players in the same conversation.
- Native SVC and Plasmo API bridges without protocol emulation.
- Automatic installation of compatible official SVC/Plasmo server dependencies.
- One VoiceCraft.Java config for VoiceCraft, SVC, and Plasmo bind/advertised ports.
- Automatic VoiceCraft Server download, configuration, startup, and shutdown on Paper.
- Direct mode for a single Paper server.
- Velocity and BungeeCord mode for multi-server networks.
- UDP relay support for SVC and Plasmo across proxy networks.
- Position, dimension, proximity, cave echo, and underwater audio synchronization.
- Localized configuration and messages.
Vanilla and Bedrock voice statuses
Players without SVC or Plasmo can see lightweight vanilla-compatible voice statuses above other unmodded players. The indicators work through Geyser and show whether a player is disconnected, connected, speaking, muted, or deafened.
The overlay is viewer-scoped: players using SVC or Plasmo never receive it, so it does not overlap the native indicators provided by their mods. Every symbol, color, height, update interval, and view distance can be configured.
Installation modes
Paper
Install the Paper jar for a standalone server. VoiceCraft.Java can automatically download and manage a matching VoiceCraft Server runtime, or connect to an existing VoiceCraft backend.
Enable the Simple Voice Chat and/or Plasmo Voice adapters in config.yml when those clients should be accepted. Both adapters are disabled by default.
Velocity or BungeeCord
Install VoiceCraft.Java on the proxy and every Paper backend. The proxy owns the central VoiceCraft connection, while backend servers provide player state and adapter sessions. Optional UDP relays keep SVC and Plasmo clients connected while players move between backend servers.
Requirements
- Java 17 for Minecraft 1.20.x, Java 21 for 1.21.x, and Java 25 for 26.x.
- Paper for voice adapters and managed VoiceCraft runtime support.
- Velocity or BungeeCord only when running a multi-server network.
- Reachable UDP ports for every enabled voice adapter.
Enable at least one official voice plugin/mod for the Java clients you want to support. VoiceCraft.Java can download the compatible dependency automatically, or you can install it yourself. The official plugin owns the client handshake and UDP transport; VoiceCraft.Java routes its final Opus frames through VoiceCraft Server.
VoiceCraft.Java focuses on the shared experience that matters across clients: proximity audio, identity, speaking state, and voice controls. Client-exclusive features such as private Simple Voice Chat groups remain within their own ecosystem instead of being falsely emulated for other clients.
Supported platforms
- Paper, Purpur, Folia, Spigot, and Bukkit
- Fabric
- Forge
- NeoForge
- Velocity
- BungeeCord
Minecraft 1.20.1 and newer are supported through per-version mod artifacts. Not every Minecraft/modloader combination has both upstream voice mods; VoiceCraft.Java keeps the available bridge working and logs a clear warning when an enabled adapter does not exist for that target.
VoiceCraft.Java is licensed under the GNU Affero General Public License v3.0 or later.
评论 0
登录后参与评分
还没有评论,来抢沙发吧