[免费]KookBot-Unturned互联

# KookBot-Unturned

一个用于 Unturned 服务器的 Kook（开黑啦）机器人插件，支持双向消息同步和服务器管理功能。

## ✨ 功能特性

### 🔄 双向消息同步

– **游戏 → Kook**: 自动同步服务器事件到 Kook 频道

  – 服务器启动/关闭通知

  – 玩家加入/离开通知

  – 玩家聊天消息

  – 玩家死亡/复活事件

  – PvP 伤害事件

– **Kook → 游戏**: 支持在 Kook 频道发送消息到游戏内

### 🎮 服务器管理指令

支持在 Kook 频道中执行核心管理指令：

– `/help` – 显示帮助信息

– `/status` – 实时查看 TPS / 在线 / 排队 / 延迟

– `/say <内容>` – 服务器广播消息

– `/cmd <指令>`（别名 `/console` `/exec`）- 执行控制台指令

### 🧊 卡片 & 富文本

– 服务器启动/关闭、状态面板等关键动作全部使用 KOOK 卡片展示

– `/status` 指令返回富文本监控卡片，移动端/桌面端均可读

– 自定义字段自动排版，信息更紧凑

### 🛡️ 智能聊天防护

– 可配置的消息速率限制与刷屏自动禁言

– 违禁词即时拦截（可选择自动禁言）

– 脏话检测支持掩码或直接阻断，并允许自定义词表/正则

– Debug 模式提供详细日志，默认情况下保持控制台干净

### ⚙️ 灵活的配置

– 可单独启用/禁用每个事件类型

– 可单独启用/禁用每个指令

– 支持自定义消息前缀

– 支持管理员权限控制

### ⬆️ 自动更新

– 支持从 GitHub Releases 自动检测并下载更新

– 支持预发布版本包含选项

– 支持更新后自动重启服务器

– 更新过程自动发送 KOOK 通知卡片

## 📋 系统要求

– **.NET Framework**: 4.8 或更高版本

– **RocketMod**: 3.x

– **Unturned**: 服务器版本

– **Kook 机器人**: 需要在 Kook 开发者平台创建机器人并获取 Token

## 🚀 安装说明

### 1. 下载插件

从 [Releases]( 链接) 页面下载最新版本的 `KookBot-Unturned.dll`

### 2. 安装插件

将 `KookBot-Unturned.dll` 文件复制到 Unturned 服务器的以下目录：

“`

Unturned服务器目录/Rocket/Plugins/KookBot-Unturned.dll

“`

### 3. 获取 Kook 机器人 Token

1. 访问 [Kook 开发者平台]( 链接)

2. 创建应用并获取机器人 Token

3. 获取频道 ID（Channel ID）

### 4. 配置插件

首次运行后，插件会生成配置文件：`Rocket/Plugins/KookBot-Unturned/KookBot-Unturned.configuration.xml`

编辑配置文件，填写以下信息：

“`xml

<Configuration>

  <ServerName>我的服务器</ServerName>

  <BotToken>你的机器人Token</BotToken>

  <ChannelId>你的频道ID</ChannelId>

  <EnableSync>true</EnableSync>

  <MessagePrefix>[Unturned]</MessagePrefix>

  <KookToGame>true</KookToGame>

  <Admin>

    <string>你的Kook用户ID</string>

  </Admin>

  <Debug>false</Debug>

  <!– 更多配置项… –>

</Configuration>

“`

### 5. 重启服务器

重启 Unturned 服务器，插件将自动加载并连接到 Kook。

## 📖 配置说明

### 基本配置

| 配置项 | 说明 | 默认值 |

|——–|——|——–|

| `ServerName` | 服务器名称（用于通知消息） | `Unturned` |

| `BotToken` | Kook 机器人 Token | `Token` |

| `ChannelId` | Kook 频道 ID | `ID` |

| `EnableSync` | 是否启用消息前缀 | `true` |

| `MessagePrefix` | 消息前缀 | `[Unturned]` |

| `KookToGame` | 是否启用 Kook 到游戏的消息转发 | `true` |

| `Admin` | 管理员 Kook 用户 ID 列表 | – |

| `Debug` | 是否启用调试模式 | `false` |

> 🔁 **配置热更新**：保存 `KookBot-Unturned.configuration.xml` 后，插件会自动检测并应用改动（BotToken/Channel 变更仍建议重启）。

### 事件配置

可以单独启用/禁用以下事件：

– `PlayerJoined` – 玩家加入事件

– `PlayerLeft` – 玩家离开事件

– `PlayerDeath` – 玩家死亡事件

– `PlayerRevive` – 玩家复活事件

– `ChatMessage` – 聊天消息事件

– `PlayerDamaged` – 玩家受伤事件（PvP）

– `ServerStart` – 服务器启动事件

– `ServerStop` – 服务器关闭事件

### 指令配置

可以单独启用/禁用以下指令：

– `help`, `status` – 普通指令

– `say`, `cmd`, `console`, `exec` – 控制台/广播指令

## 🎯 使用方法

### 在 Kook 频道中使用

1. **发送消息到游戏**: 在配置的频道中直接发送消息，消息会自动转发到游戏内

2. **执行指令**: 以 `/` 开头发送指令，例如：

   – `/status` – 查询 TPS/在线/排队/延迟

   – `/say 大家好！` – 广播消息

   – `/cmd <任意控制台指令>` – 执行服务器指令

   – `/help` – 查看帮助

### 🧩 配置与热重载（中文简要指南）

– 配置文件路径优先自动探测，常见位置：

  – `Servers/<实例名>/Rocket/Plugins/KookBot-Unturned/KookBot-Unturned.configuration.xml`

– 修改 XML 保存后，1-2 秒内自动热重载并应用（日志会显示“✅ Configuration hot reload applied.”）。

– 如修改 `BotToken` 建议重启一次以重连 KOOK。

– 推荐先从 Release 附件的 `KookBot-Unturned.configuration.template.xml` 复制为正式配置并按注释修改。

常用配置项说明：

– 基础

  – `ServerName`：服务器名（用于卡片标题）

  – `BotToken`：KOOK 机器人 Token

  – `ChannelId`：推送目标频道

  – `ExposeReviveCoordinates`：复活卡片是否显示坐标（默认 false）

– 指令开关

  – `help`、`status`、`say`、`cmd`（含别名 `console`、`exec`）可独立启用/禁用

  – 被禁用时，用户会收到“指令已被禁用”的卡片提示

– 事件开关

  – `PlayerJoined/Left/Death/Revive/ChatMessage/PlayerDamaged/ServerStart/ServerStop` 可独立控制

– 聊天风控（可并行启用，满足任一条件即拦截）

  – `MinimumSecondsBetweenMessages`：相邻两条消息的最小间隔（逐条节流）

  – `SpamMessageLimit` + `SpamIntervalSeconds`：时间窗口限流（例：8 秒内最多 5 条）

  – `MaxMessagesPerSecond`：每秒上限（瞬时尖峰控制，默认 3；设 0 关闭该项）

  – 可配置自动禁言时长与提示文案；违禁词/脏话支持词表与正则

### 权限说明

– **普通用户**: 可以使用 `/help` 和 `/status` 指令

– **管理员**: 可以使用所有管理指令（需要在配置文件中添加 Kook 用户 ID）

## 🛠️ 编译项目

### 环境要求

– Visual Studio 2019 或更高版本

– .NET Framework 4.8 SDK

– RocketMod 3.x

### 编译步骤

1. 克隆仓库：

“`bash

git clone 链接

cd KookBot-Unturned

“`

2. 还原 NuGet 包：

“`bash

dotnet restore

“`

3. 编译项目：

“`bash

# Debug 版本

dotnet build

# Release 版本

dotnet build -c Release

“`

4. 编译产物位于：

   – Debug: `bin/Debug/net48/KookBot-Unturned.dll`

   – Release: `bin/Release/net48/KookBot-Unturned.dll`

## 📝 更新日志

### v1.2.4 (2025-11-16)

#### 🕐 时间显示修复

– 修复 KOOK 消息中的时间显示问题，所有用户可见的时间戳从 UTC 改为本地时间

– 内部逻辑（如禁言过期时间）仍使用 UTC 保持一致性

### v1.2.2 (2025-11-16)

#### ⬆️ 自动更新功能

– 新增自动更新功能，支持从 GitHub Releases 自动检测、下载并应用更新

– 支持预发布版本包含选项

– 支持更新后自动重启服务器选项

– 更新检测、下载、完成时自动发送 KOOK 通知卡片

– 智能版本比较，正确处理带元数据的版本号

### v1.2.1 (2025-11-15)

#### 🎨 全面卡片化

– 所有游戏事件（聊天、玩家加入/离开、死亡/复活、PvP）统一使用 KOOK 卡片格式

– 所有指令响应（`/say`、`/cmd`、禁用/未知指令）统一使用 KOOK 卡片格式

– 提供更一致、更美观的用户体验

#### ⚙️ 配置增强

– 新增 `ExposeReviveCoordinates` 配置项，可控制复活事件是否显示坐标

– 新增 `MaxMessagesPerSecond` 配置项，支持每秒消息数限制（默认 3 条/秒）

### v1.2.0 (2025-11-14)

#### 🧊 富文本与状态面板

– KOOK 卡片模板上线：服务器启动/关闭、`/status` 指令均以卡片展示

– `/status` 新增 TPS、排队、平均/最高延迟、运行时长等字段

#### 📊 监控能力

– 新增 `ServerMetricsProvider` 捕获运行指标，替代 `/list`

– `/status` 指令对外提供实时 TPS/玩家/排队/延迟信息

#### ♻️ 配置热更新

– `ConfigurationHotReloadService` 自动监听配置文件，保存即可生效

– 聊天风控、事件开关、指令权限可立即更新

### v1.1.0 (2025-11-13)

#### 🔄 配置与代码精简

– 统一默认事件/指令设置，自动去重并保持配置文件干净

– 精简 KOOK 指令，仅保留 `/help` `/status` `/say` `/cmd` 四类核心能力

– 抽象聊天风控流水线，代码结构更清晰，易于扩展

#### 🛡️ 聊天防护升级

– 新增脏话过滤支持掩码替换或直接拦截，可自定义词表与正则

– 违禁词、刷屏、最小间隔逻辑统一管理，并支持自动禁言

– Debug 开关控制日志输出，默认保持控制台整洁