
简单舒适KOOK
一个将simpleCom(简易通讯器)的语音实时连接并推送到KOOK的模组/插件。
SimpleComforKOOK - 将 Minecraft 语音桥接到 KOOK
将你的 Minecraft 服务器语音实时转发到 KOOK(开黑啦)语音频道!
🎙️ 功能特性
- 实时语音转发:将 Minecraft 玩家的语音自动转发到 KOOK 语音频道
- 多人混音:支持多个玩家同时说话,自动混音处理
- 跨平台支持:提供 Fabric、Forge 和 Bukkit/Spigot 三个版本
- 低延迟:优化的音频处理流程,确保语音传输流畅
- 自动保活:自动维持 KOOK 语音连接,无需手动重连
📋 使用前准备
1. 安装 SimpleCom 客户端
玩家需要在本地安装 SimpleCom 语音客户端,用于采集和传输语音。
2. 配置 KOOK Bot
服务器管理员需要:
- 在 KOOK 开发者平台创建一个 Bot
- 获取 Bot Token
- 将 Bot 添加到你的 KOOK 服务器
- 获取目标语音频道的 ID
3. 安装 SimpleCom 服务器
服务器需要运行 SimpleCom 服务器端,用于接收玩家语音数据。
🚀 快速开始
Fabric/Forge 用户
- 下载对应版本的 Mod 文件
- 将 Mod 放入
mods文件夹 - 启动服务器,会自动生成配置文件
- 编辑配置文件填入必要信息
- 重启服务器
Bukkit/Spigot 用户
- 下载 Bukkit 插件
- 将插件放入
plugins文件夹 - 启动服务器,会自动生成配置文件
- 编辑
plugins/SimpleComforKOOKConfig/config.yml - 重启服务器
⚙️ 配置说明
配置文件示例:
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
- 在 KOOK 中右键点击语音频道
- 选择"复制频道 ID"
- 粘贴到配置文件中
🎮 玩家使用指南
- 安装 SimpleCom 客户端:从官方仓库下载并安装
- 连接到服务器:使用 SimpleCom 客户端连接到 Minecraft 服务器
- 开始说话:按住 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 开源协议。
🔗 相关链接
- GitHub 仓库:https://github.com/xiaofanforfabric/SimpleComforKOOK
- SimpleCom 客户端:https://github.com/xiaofanforfabric/SimpleCom-core
- KOOK 开发者平台:https://developer.kookapp.cn/
作者:xiaofan
支持:如果这个 Mod 对你有帮助,请给个 Star ⭐
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。