基岩版语音聊天

基岩版语音聊天

Hytale 最佳距离与语音聊天解决方案

实用

Hytale 的 Bedrock 语音聊天

Bedrock Voice Chat 是 Hytale 的一个近距离与语音聊天解决方案,包含一个可安装在服务器上的模组,以及一个适用于桌面和移动平台的高性能原生应用程序。

你正在下载的内容

此 CurseForge 上传仅包含服务端模组组件。 将其安装到你的 Hytale 服务器的 mods 文件夹中,以启用语音聊天功能。

玩家还需要配套应用程序: 由于 Hytale 不支持客户端模组,玩家必须下载一个单独的原生应用程序(非模组)才能体验语音聊天。配套应用程序适用于 Windows:https://github.com/Alaydriem/bedrock-voice-chat/releases

功能特性

  • 支持 WASAPI + ASIO 输入
  • 带位置音频的近距离语音聊天
  • 用于持续音频的群组聊天
  • 支持桌面端 (Windows 10/11)、iOS 和 Android
  • 客户端音频控制(静音、闭听、单独音量滑块)
  • 将音频录制到单独的音频轨道,支持时间码,便于后续下载/处理
  • 噪音抑制、音频增益
  • 语音检测
  • 完全加密
  • Opus 音频编解码器
  • 以及更多

客户端应用程序

Bedrock Voice Chat 通过 Github 上提供的 Bedrock Voice Chat 应用程序来体验:https://github.com/Alaydriem/bedrock-voice-chat/releases。将此模组安装到你的服务器并进行配置后,玩家需要下载并使用客户端应用程序来体验近距离语音聊天。


概述

这个服务端模组将 Bedrock Voice Chat 服务器嵌入到你的 Hytale 服务器中,无需任何第三方托管。玩家可以使用 Bedrock Voice Chat 客户端应用程序登录他们的服务器,并根据他们在游戏中的相对位置体验近距离语音聊天。

有关如何为你的服务器安装和配置 Bedrock Voice Chat 的更多信息,请查阅 BVC 维基:https://github.com/Alaydriem/bedrock-voice-chat/wiki/Hytale-Java-Support


为 Hytale 配置 Bedrock Voice Chat 模组

服务器模式

该插件支持两种部署模式,以适应不同的服务器设置。

外部服务器模式:连接到一个独立运行的 BVC 服务器实例。推荐用于:

  • 有 20 个以上并发语音聊天用户的服务器
  • 托管多个游戏服务器
  • 分布式服务器架构(例如,为每个世界、领域、维度等设置专用的语音聊天服务器)

嵌入服务器模式:直接在 Hytale 服务器内运行 BVC 服务器。非常适合:

  • 并发玩家数量较少的服务器
  • 本地开发和测试
  • 简化部署

安装

  1. 从文件部分下载 BVC Hytale 模组
  2. 将插件放入你的 Hytale 服务器的 mods 目录中
  3. 启动一次服务器以生成默认配置文件
  4. 停止服务器并配置模组(参见下面的配置章节)
  5. 重新启动你的服务器

配置

配置文件位于:

mods\com.alaydriem_bedrock-voice-chat\BedrockVoiceChatPlugin.json

外部服务器模式

连接到单独的 BVC 服务器实例时使用此配置:

{
  "BvcServer": "https://your-bvc-server.example.com:8444",
  "AccessToken": "<REPLACE_WITH_YOUR_ACCESS_TOKEN>",
  "MinimumPlayers": 1,
  "UseEmbeddedServer": false
}

配置步骤:

  1. BvcServer 设置为你外部 BVC 服务器的 URL(包括端口)
  2. AccessToken 设置为由你的 BVC 服务器管理员提供的令牌
  3. 根据你的需要调整 MinimumPlayers(达到此阈值时,语音聊天将激活)
  4. 保持 UseEmbeddedServer 设置为 false

嵌入服务器模式

在你的 Hytale 服务器内运行 BVC 服务器时使用此配置:

{
  "BvcServer": "",
  "AccessToken": "<GENERATE_A_SECURE_TOKEN>",
  "MinimumPlayers": 1,
  "UseEmbeddedServer": true,
  "EmbeddedConfig": {
    "HttpPort": 8444,
    "QuicPort": 8443,
    "PublicAddr": "your.server.ip.address",
    "BroadcastRange": 48.0,
    "TlsCertificate": "/path/to/certificate-chain.pem",
    "TlsKey": "/path/to/private-key.pem",
    "TlsNames": "127.0.0.1,your.server.ip.address,your.domain.com",
    "TlsIps": "127.0.0.1,your.server.ip.address",
    "LogLevel": "info"
  }
}

配置步骤:

  1. BvcServer 留空(或将其设置为你服务器的公共地址供客户端参考)
  2. 生成一个安全的 AccessToken(使用随机字符串生成器,长度至少设置为 32 个字符)
  3. UseEmbeddedServer 设置为 true
  4. 配置 EmbeddedConfig 部分(见下面的参数说明)

配置参数

核心参数

参数 类型 描述
BvcServer 字符串 外部服务器 URL(外部模式)或留空/公共地址(嵌入模式)
AccessToken 字符串 用于安全通信的身份验证令牌
MinimumPlayers 整数 激活语音聊天前所需的最少玩家数
UseEmbeddedServer 布尔值 嵌入模式为 true,外部模式为 false

嵌入服务器参数

参数 类型 描述 默认值
HttpPort 整数 用于 Web 界面和 API 的 HTTP/HTTPS 端口 8444
QuicPort 整数 用于语音数据传输的 QUIC 协议端口 8443
PublicAddr 字符串 客户端连接时使用的公共 IP 地址或主机名 -
BroadcastRange 浮点数 以方块为单位的最大语音聊天距离 48.0
TlsCertificate 字符串 TLS 证书链文件的路径(PEM 格式) -
TlsKey 字符串 TLS 私钥文件的路径(PEM 格式) -
TlsNames 字符串 TLS 有效主机名/IP 的逗号分隔列表 -
TlsIps 字符串 TLS 有效 IP 地址的逗号分隔列表 -
LogLevel 字符串 日志详细程度:debug, info, warn, error info

TLS 证书设置

对于嵌入模式,你需要有效的 TLS 证书。你可以:

选项 1:Let's Encrypt(推荐)

  • 免费、自动化的证书
  • 需要域名
  • 证书自动续期

选项 2:商业证书

  • 从证书颁发机构购买
  • 提供最大兼容性

证书文件路径:

  • Windows:使用双反斜杠 \\ 或正斜杠 /
    • 示例:C:\\certs\\certificate.pemC:/certs/certificate.pem
  • Linux:使用标准路径
    • 示例:/etc/letsencrypt/live/yourdomain.com/fullchain.pem

GitHub 仓库: https://github.com/Alaydriem/bedrock-voice-chat