简单舒适KOOK

简单舒适KOOK

一个将simpleCom(简易通讯器)的语音实时连接并推送到KOOK的模组/插件。

SimpleComforKOOK - 将 Minecraft 语音桥接到 KOOK

将你的 Minecraft 服务器语音实时转发到 KOOK(开黑啦)语音频道!

🎙️ 功能特性

  • 实时语音转发:将 Minecraft 玩家的语音自动转发到 KOOK 语音频道
  • 多人混音:支持多个玩家同时说话,自动混音处理
  • 跨平台支持:提供 Fabric、Forge 和 Bukkit/Spigot 三个版本
  • 低延迟:优化的音频处理流程,确保语音传输流畅
  • 自动保活:自动维持 KOOK 语音连接,无需手动重连

📋 使用前准备

1. 安装 SimpleCom 客户端

玩家需要在本地安装 SimpleCom 语音客户端,用于采集和传输语音。

2. 配置 KOOK Bot

服务器管理员需要:

  1. 在 KOOK 开发者平台创建一个 Bot
  2. 获取 Bot Token
  3. 将 Bot 添加到你的 KOOK 服务器
  4. 获取目标语音频道的 ID

3. 安装 SimpleCom 服务器

服务器需要运行 SimpleCom 服务器端,用于接收玩家语音数据。

🚀 快速开始

Fabric/Forge 用户

  1. 下载对应版本的 Mod 文件
  2. 将 Mod 放入 mods 文件夹
  3. 启动服务器,会自动生成配置文件
  4. 编辑配置文件填入必要信息
  5. 重启服务器

Bukkit/Spigot 用户

  1. 下载 Bukkit 插件
  2. 将插件放入 plugins 文件夹
  3. 启动服务器,会自动生成配置文件
  4. 编辑 plugins/SimpleComforKOOKConfig/config.yml
  5. 重启服务器

⚙️ 配置说明

配置文件示例:

voiceAPIHOST: 127.0.0.1:3003          # SimpleCom 服务器地址
token: 123456                          # SimpleCom 认证令牌
KOOKBOTtoken: your_kook_bot_token     # KOOK Bot 令牌
channel_id: your_channel_id            # KOOK 语音频道 ID

获取 KOOK 频道 ID

  1. 在 KOOK 中右键点击语音频道
  2. 选择"复制频道 ID"
  3. 粘贴到配置文件中

🎮 玩家使用指南

  1. 安装 SimpleCom 客户端:从官方仓库下载并安装
  2. 连接到服务器:使用 SimpleCom 客户端连接到 Minecraft 服务器
  3. 开始说话:按住 PTT(Push-to-Talk)键说话,你的声音会自动转发到 KOOK

⚠️ 注意事项

  • 单向通信:目前仅支持 Minecraft → KOOK 的语音转发,KOOK 频道的语音不会被转发回 Minecraft
  • 网络要求:需要稳定的网络连接以确保语音质量
  • 性能影响:语音处理会占用一定的服务器资源,建议在配置较好的服务器上使用

🔧 技术细节

  • 音频格式:48kHz, Mono, 20ms 帧
  • 编解码器:Opus
  • 传输协议:RTP over UDP
  • 混音算法:实时 PCM 混音,支持多人同时说话

📦 版本支持

Fabric

  • Minecraft 1.20.1
  • Fabric Loader 0.14.x+

Forge

  • Minecraft 1.20.1
  • Forge 47.x.x+

Bukkit/Spigot

  • Minecraft 1.16.5+
  • Paper/Spigot

🐛 问题反馈

遇到问题?请在 GitHub Issues 提交反馈。

📄 开源协议

本项目采用 GNU General Public License v3.0 开源协议。

🔗 相关链接


作者:xiaofan
支持:如果这个 Mod 对你有帮助,请给个 Star ⭐