介绍
本文档部分内容由 AI 生成，仅供参考，请以实际使用为准。 请查看 更新日志 获取最新信息。
EasyBot 是一款面向 Minecraft 服务器的一体化管理工具，它打通了游戏服务器与社交平台之间的壁垒，为服务器管理员提供了一套从玩家管理、消息互通到高级功能扩展的完整解决方案。无论是小型私人服务器还是大型社区网络，EasyBot 都能帮助您轻松构建高效、互动性强的游戏社区。
介绍视频
核心功能
消息同步
EasyBot 支持游戏服务器与 QQ 群之间的双向消息同步。服务器中的聊天消息可以实时转发到群聊，群聊消息也能同步到游戏内。此外，通过安装 ChatImage 模组，玩家还可在游戏中直接查看群聊中发送的图片。
从服务器同步到群聊的详细配置请查看 服务器消息同步到群，从群聊同步到服务器的配置请查看 群消息同步到服务器。
绑定管理
账号绑定是 EasyBot 的核心机制，它将玩家的游戏账号与社交账号关联起来。支持双向验证模式（游戏内获取验证码，群内输入完成绑定）和社交平台信任模式（群内直接输入游戏名绑定）。管理员可以设置强制绑定服务器，未绑定的玩家将无法进入游戏；同时还支持解绑、退群自动解绑、查询绑定信息以及将群名片自动修改为游戏 ID 等功能。
自定义命令
通过纯文本模式和图片模式，管理员可以自由配置关键词回复，支持 Minecraft 颜色代码（§ 格式）与 HEX 渐变色渲染，让机器人回复变得生动丰富。
AI 集成
EasyBot 支持对接 SiliconFlow 等 AI 平台，集成 DeepSeek-R1 等大语言模型，为服务器提供智能对话能力。具体接入教程请查看 对接 SiliconFlow。
图片模板
EasyBot 内置了基于浏览器渲染的高级图片模板引擎，可以渲染出各种复杂的图片，如服务器状态图、玩家排名图等。支持从模板市场下载官方和社区开发的模板，开发者也可以使用 easybot-image-sdk 配合 Vue、React 等前端框架自行开发自定义模板。渲染时机支持多种等待策略（Load、NetworkIdle 等），确保截图内容完整准确。
占位符与变量系统
EasyBot 提供了丰富的变量系统，包括：
- PlaceholderAPI 变量：用于查询玩家的绑定信息（绑定 ID、绑定名称、绑定状态等）
- 玩家状态变量：可查询玩家伤害量、死亡次数、击杀数、移动距离、与方块交互次数等数十种统计信息
- 占位符数学运算：支持在占位符中进行数学计算，支持多种舍入模式
插件系统
EasyBot 的插件系统基于微软 ClearScript 框架，支持使用 JavaScript 开发插件。提供丰富的 SDK 接口，包括服务器 Bridge API、HTTP 客户端/服务端、WebSocket、数据库操作、LiteDB 键值存储、事件系统、线程管理、机器人 API、Puppeteer 浏览器自动化、C# 标准库调用等。插件可以是单文件或多文件形式，支持热重载，方便开发者迭代。查看快速开始教程上手插件开发。
扩展开发
开发者可以通过 EasyBot 的 Bridge 核心开发服务器端扩展，在 Bukkit、Mod（Forge/NeoForge/Fabric）等平台上自定义功能，并直接调用 EasyBot 的统一接口。
高级管理功能
- 群组互动：支持群内登录、密码找回、Bilibili 三连检测自动过白名单
- 黑白名 单系统：支持封禁/解封时执行自定义命令
- 跨服互通：支持多服务器之间的消息同步与数据共享
- 聊天图片显示：通过模组在游戏中浏览社交平台分享的图片
平台支持
EasyBot 支持多种 Minecraft 服务端平台，各平台安装指南请参考对应文档：
| 平台 | 版本要求 | 说明 | 安装文档 |
|---|---|---|---|
| Bukkit/Spigot/Paper | ≥1.9 | 成熟的插件支持 | 安装指南 |
| Minecraft Mod | ≥1.20.1 | Forge/NeoForge/Fabric | 安装指南 |
| MCDR | - | Python 环境 | 安装指南 |
| Velocity | - | 代理端支持 | 安装指南 |
| 基岩版 | - | 通过 Geyser 联动 | 安装指南 |
部署方式
EasyBot 支持 Windows 和 Linux 系统部署，也提供 Docker 镜像，支持 FULL（含图片模板渲染器）和轻量化版本，满足不同规模服务器的需求。机器人端已支持 OneBot11（QQ 等）、Milky、Telegram 等多种协议。QQ 平台支持 NapCat、Lagrange 等多种实现方案，灵活适配您的运行环境。
