升级版本时请提前备份配置文件，以防数据丢失
插件交流群：825894832
现代化、高内聚、模块化的 Minecraft 服务器与 QQ/IM 机器人双向互通插件。同时支持 Paper/Spigot 后端子服 与 Velocity 跨服代理端。
- 多端跨服网络架构 (Multi-Platform Host)：
- Bukkit / Paper：单服实体服支持，覆盖死亡广播、成就广播、游戏主线程安全调度。
- Velocity 3.x / 4.x：代理端总控支持，前置白名单网关鉴权（未绑定直接在代理层切断，保护后端子服免受压测），支持子服跨服跳转群广播。
- 多协议适配矩阵 (Adapter Architecture)：
- OneBot (v11)：基于纯 Kotlin 协程 + 原生 WebSocket 双向通信，全结构化 JSON Segment 消息体设计，内置指数退避重连状态机与异步缓存预热（全平台跨端通用）。
- MiraiMC：通过本地桥接服务挂载 Mirai 框架，Bukkit 与 Velocity 代理端均已获得官方原生支持。
- 纯粹公开 API 契约 (
:api)：- 接口与实现完全物理隔离，命名空间统一为
me.regadpole.plumbot.api.*。 - 零内部实现泄露，提供自动化模块契约检查任务（
checkApiContract），保证第三方附属插件依赖的长期稳定性。 - 支持 Bukkit 服务管理器（
ServicesManager）或跨平台静态入口点（PlumBotAPI.get()）动态获取。
- 接口与实现完全物理隔离，命名空间统一为
- 远程运维与性能监控 (Remote Console & Monitoring)：
- 群内性能报告 (
/status//tps)：支持 1m/5m/15m 三段式 TPS 与平滑多级降级的 MSPT（毫秒级刻耗时采样），附带 JVM 堆内存与在线统计。 - 安全远程控制台 (
/cmd)：白名单 QQ 严格鉴权、控制台审计日志记录、主线程安全调度派发，基于OutputCapturingBuffer双通道拦截纯文本与 Adventure 组件回显。
- 群内性能报告 (
- 高性能敏感词过滤体系：
- 基于 Aho-Corasick (AC 自动机) 双向多模式匹配引擎，支持本地忽略标点/白名单字符跳过。
- 支持多源云端敏感词库拉取与本地快照自愈回退机制。
- 安全加固 (Security First)：
- 群聊转发到游戏全链路 MiniMessage 标签严格转义，杜绝群成员利用
<click:run_command>等标签在游戏控制台实施提权注入。
- 群聊转发到游戏全链路 MiniMessage 标签严格转义，杜绝群成员利用
- 现代异步持久层 & 协程缓存：
- 数据库引擎解耦支持 SQLite 与 MySQL。
- 引入
Aedile（基于 Caffeine 的 Kotlin 协程缓存封装），消除传统阻塞等待，保证主事件循环零卡顿。
PlumBot/
├── api/ # 纯粹对外 API 契约、领域模型与事件系统 (me.regadpole.plumbot.api.*)
├── common/ # 平台无关核心逻辑（敏感词过滤、白名单服务、数据库持久层、命令分发、回显捕获器）
├── bukkit/ # Paper/Bukkit 实体子服宿主实现、多源类库动态加载器
├── velocity/ # Velocity 跨服代理端宿主实现 (支持前置白名单鉴权、跨服换服广播)
├── hytale/ # Hytale 官方实体服务端宿主实现 (支持握手鉴权、ECS 世界性能采样)
└── adapter/
├── onebot/ # 基于纯协程 WebSocket 的 OneBot v11 独立适配层 (全平台支持)
└── miraimc/ # MiraiMC 协议桥接适配层 (支持 Bukkit 与 Velocity)
- JDK 21 或更高版本
- Gradle 9.x（推荐直接使用仓库自带的
./gradlew）
# 1. 编译全模块与测试代码
./gradlew compileKotlin compileTestKotlin
# 2. 执行全量单元测试与 API 契约静态校验
./gradlew test check checkApiContract
# 3. 构建多平台最终全量分发包（统一归集输出到 dist/ 目录）
./gradlew dist构建完成后，dist/ 目录将直接生成：
dist/PlumBot-Bukkit.jar(适用于 Spigot/Paper/Purpur 后端子服)dist/PlumBot-Velocity.jar(适用于 Velocity 跨服代理端)dist/PlumBot-Hytale.jar(适用于 Hytale 官方实体服务端)
本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0) 协议开源。