🤖 KookBot-Unturned 插件
适用于 Unturned 服务器的 KOOK 机器人桥接插件,支持游戏与 KOOK 频道之间的双向消息同步,并提供丰富的远程管理功能,让你在 KOOK 上也能高效管理服务器。
✨ 功能特色
💬 消息同步
-
游戏聊天与 KOOK 频道实时互通
-
支持自定义消息前缀
-
双向消息传输,无缝体验
📡 事件推送
自动推送以下游戏事件到 KOOK 频道:
-
玩家加入服务器
-
玩家离开服务器
-
玩家死亡事件
-
玩家复活事件
-
PvP 受伤事件
-
服务器启动与关闭
🎮 远程管理
通过 KOOK 频道直接执行服务器管理指令:
-
查看玩家列表
-
广播消息
-
踢人、封禁
-
玩家传送
-
治疗玩家
-
给予物品
🔐 权限控制
-
仅配置文件中列出的管理员 ID 才能使用管理指令
-
有效防止指令滥用
-
灵活的权限管理机制
⚙️ 可定制化
-
支持独立开关每个事件推送
-
支持独立开关每个管理指令
-
满足不同服务器的个性化需求
📦 安装方法
步骤 1:创建 KOOK 机器人
-
前往 KOOK 开发者平台
-
创建新的机器人应用
-
获取 Bot Token(后续配置需要)
步骤 2:安装插件
-
下载 KookBot-Unturned 插件 DLL 文件
-
将 DLL 文件放入 Unturned 服务器的
Rocket/Plugins
目录 -
确保服务器已安装 RocketMod 框架
步骤 3:生成配置文件
-
启动 Unturned 服务器
-
插件会自动生成配置文件:
KookBot_UnturnedConfiguration.xml
-
服务器启动完成后关闭服务器
步骤 4:配置插件
编辑 KookBot_UnturnedConfiguration.xml
文件:
-
ServerName: 设置服务器显示名称
-
BotToken: 填写步骤1获取的 KOOK 机器人 Token
-
ChannelId: 填写目标 KOOK 频道 ID
-
Admin: 添加管理员的 KOOK 用户 ID 到列表
步骤 5:启动服务器
重启 Unturned 服务器,插件即可正常工作。
🎯 管理员指令
注意: 只有在配置文件
Admin
列表中的 KOOK 用户才能使用以下指令。
指令 | 参数 | 功能描述 |
---|---|---|
/help |
无 | 查看帮助信息 |
/list |
无 | 查看当前在线玩家列表 |
/say |
<消息内容> |
向游戏内所有玩家广播消息 |
/cmd |
<控制台指令> |
执行服务器控制台指令 |
/kick |
<玩家名> |
踢出指定玩家 |
/ban |
<玩家名> |
封禁指定玩家 |
/tp |
<玩家1> <玩家2> |
将玩家1传送到玩家2位置 |
/heal |
<玩家名> |
治疗指定玩家 |
/give |
<玩家名> <物品ID> [数量] |
给予玩家指定物品 |
⚙️ 配置文件详解
完整配置示例
<?xml version="1.0" encoding="utf-8"?>
<!-- XML 文件头,声明版本和编码 -->
<KookBot_UnturnedConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<!-- 根节点 -->
<ServerName>Unturned</ServerName>
<!-- 服务器名称,会显示在 KOOK 消息里 -->
<BotToken>Token</BotToken>
<!-- KOOK 机器人 Token(在 KOOK 开发者平台获取) -->
<ChannelId>ID</ChannelId>
<!-- KOOK 机器人发送消息的目标频道 ID -->
<EnableSync>true</EnableSync>
<!-- 是否启用消息同步(true=启用,false=关闭) -->
<MessagePrefix>[Unturned]</MessagePrefix>
<!-- KOOK 消息前缀,可自定义 -->
<KookToGame>true</KookToGame>
<!-- 是否允许 KOOK 消息发回游戏(true=允许,false=禁止) -->
<!-- 游戏 → KOOK 事件推送开关 -->
<GameToKookSettings>
<SettingItem><Key>PlayerJoined</Key><Value>true</Value></SettingItem>
<SettingItem><Key>PlayerLeft</Key><Value>true</Value></SettingItem>
<SettingItem><Key>PlayerDeath</Key><Value>true</Value></SettingItem>
<SettingItem><Key>PlayerRevive</Key><Value>true</Value></SettingItem>
<SettingItem><Key>ChatMessage</Key><Value>true</Value></SettingItem>
<SettingItem><Key>PlayerDamaged</Key><Value>true</Value></SettingItem>
<SettingItem><Key>ServerStart</Key><Value>true</Value></SettingItem>
<SettingItem><Key>ServerStop</Key><Value>true</Value></SettingItem>
</GameToKookSettings>
<!-- KOOK → 游戏 指令开关 -->
<CommandSettings>
<SettingItem><Key>help</Key><Value>true</Value></SettingItem>
<SettingItem><Key>list</Key><Value>true</Value></SettingItem>
<SettingItem><Key>say</Key><Value>true</Value></SettingItem>
<SettingItem><Key>cmd</Key><Value>true</Value></SettingItem>
<SettingItem><Key>console</Key><Value>true</Value></SettingItem>
<SettingItem><Key>exec</Key><Value>true</Value></SettingItem>
<SettingItem><Key>kick</Key><Value>true</Value></SettingItem>
<SettingItem><Key>ban</Key><Value>true</Value></SettingItem>
<SettingItem><Key>tp</Key><Value>true</Value></SettingItem>
<SettingItem><Key>teleport</Key><Value>true</Value></SettingItem>
<SettingItem><Key>god</Key><Value>true</Value></SettingItem>
<SettingItem><Key>heal</Key><Value>true</Value></SettingItem>
<SettingItem><Key>give</Key><Value>true</Value></SettingItem>
</CommandSettings>
<!-- 管理员 ID 列表(只有这里的 KOOK ID 才能执行管理指令) -->
<Admin>
<string>123456</string>
<string>654321</string>
</Admin>
<Debug>false</Debug>
<!-- 调试模式(true=开启调试日志) -->
</KookBot_UnturnedConfiguration>
配置参数说明
基础设置
-
ServerName: 服务器在 KOOK 中显示的名称
-
BotToken: KOOK 机器人的认证令牌
-
ChannelId: 消息发送目标频道的 ID
-
EnableSync: 是否启用消息同步功能
-
MessagePrefix: KOOK 消息的前缀标识
-
KookToGame: 是否允许 KOOK 消息转发到游戏
事件推送设置 (GameToKookSettings)
可以单独控制每个事件是否推送到 KOOK:
-
PlayerJoined: 玩家加入服务器
-
PlayerLeft: 玩家离开服务器
-
PlayerDeath: 玩家死亡
-
PlayerRevive: 玩家复活
-
ChatMessage: 聊天消息
-
PlayerDamaged: 玩家受伤
-
ServerStart: 服务器启动
-
ServerStop: 服务器关闭
指令设置 (CommandSettings)
可以单独启用或禁用每个管理指令:
-
help: 帮助指令
-
list: 玩家列表指令
-
say: 广播指令
-
cmd/console/exec: 控制台指令执行
-
kick: 踢人指令
-
ban: 封禁指令
-
tp/teleport: 传送指令
-
god: 无敌模式指令
-
heal: 治疗指令
-
give: 给予物品指令
管理员设置
在 <Admin>
标签内添加管理员的 KOOK 用户 ID,每个 ID 用 <string>
标签包围。
🐛 故障排除
常见问题
Q: 机器人无法连接到 KOOKA: 请检查 BotToken 是否正确,确保机器人已邀请到服务器且有发送消息权限。
Q: 消息无法同步A: 检查 ChannelId 是否正确,确保机器人在该频道有发送和查看消息权限。
Q: 管理指令无效A: 确认你的 KOOK 用户 ID 已添加到配置文件的 Admin 列表中。
Q: 插件加载失败A: 检查服务器是否已正确安装 RocketMod,插件文件是否完整。
调试模式
将配置文件中的 <Debug>
设置为 true
可以开启详细日志,帮助排查问题。
📞 技术支持
如果遇到 Bug 或有新功能建议,欢迎通过以下方式联系:
QQ 交流群: 464790203
开发者邮箱: yoghurtk@qq.com
🔄 更新日志
定期关注插件更新,获取最新功能和 Bug 修复。建议加入 QQ 群获取第一手更新信息。
💡 提示: 首次使用建议先在测试环境中配置,确认功能正常后再部署到正式服务器。
隐藏内容需要回复可以看见