FancyHelper

插件

· 作者 baicaizhale

一个专为 Minecraft 打造的 Agent 工具,简单易用,让 Fancy 为你包办一切

0 本站下载 0 关注 更新于 2 周前

最新 4.4.2 · 26.3 · Paper / Spigot

一键开服(送7天)

FancyHelper

使用自然语言管理你的 Minecraft 服务器。

Ask DeepWiki


是否厌倦了翻阅 Wiki 并死记硬背复杂的命令,仅仅为了修改一个权限或配置文件?

FancyHelper 就是为了解决这个问题而生的。安装后,你可以直接在游戏内与 AI 对话。例如,输入“将 baicaizhale 设为管理员”,它便会生成相应的命令,请求你的确认并执行。无需再记忆命令,也无需手动搜索。

功能特性

  • 基于聊天的管理 — 输入 /cli 进入对话模式。像与人类副管理员聊天一样管理你的服务器。
  • AI 命令生成 — 默认使用 FancyConsole(免密钥 AI 中继)。同时也支持兼容 OpenAI 的端点,如 OpenAI、DeepSeek 和 CloudFlare Workers AI(BYOK)。
  • 四种对话模式 — Normal(正常):每条命令都需要确认。YOLO:同意条款后,大多数命令会自动运行,但 op、ban 和 stop 等高风险命令仍会询问。SMART(智能):AI 判断风险并直接执行低风险命令。Plan(计划):先规划后执行——非常适合处理复杂任务。
  • 执行前确认 — 在 Normal 模式下,AI 生成的命令需要手动确认(y/n)以防止意外发生。
  • 实时状态栏 — 动作条(Action Bar)显示 AI 当前正在做什么(思考中 / 执行中 / 等待确认),并以逐词流式输出。
  • 内置 Wiki 搜索 — 预置了 LuckPerms、EssentialsX、WorldEdit 等主要插件的文档预设(Skills)。如果未找到相关内容,则回退到网络搜索(Tavily / Metaso)。
  • 技能系统 — 向 AI 注入特定插件的 Markdown 知识文件。提供在线市场以一键安装/更新。
  • 反馈循环 — 已执行命令的输出会反馈给 AI。如果操作失败,AI 可以自我纠正。
  • 文件工具 — 让 AI 读取和编辑服务器配置文件(#read / #edit / #write)。首次使用需要验证。
  • MCP 客户端 — 连接到外部 MCP 工具服务器,让 AI 调用任何外部工具。
  • 待办事项列表 — AI 通过 #todo 维护任务列表,在游戏中可作为书籍查看。
  • 偏好记忆 — AI 会记住每位玩家的长期偏好(#remember / #forget)。
  • 会话恢复 — 对话历史会被持久化保存。使用 /cli resume 即可接续之前的对话。
  • 自动更新 — 检测新版本后自动下载并热重载——无需重启服务器。
  • 多语言支持 — 插件 UI 支持简体中文 / English / 文言文。可在 config.yml 中切换。
  • 防循环保护 — 如果 AI 开始重复操作或发出过多调用,系统会自动拦截。

兼容性

服务端 版本 Java
Spigot 1.18+ 17+
Paper (推荐) 1.18+ 17+

推荐使用 Paper 及其分支(Purpur、Pufferfish 等)。Spigot 可用,但插件会在启动时发出警告,因为部分高级功能依赖于 Paper 特有的 API。

依赖项:

  • ProtocolLib 5.4.0+ — 必需,用于捕获命令输出并拦截系统消息。若无此依赖,插件将禁用自身。

快速入门

安装

  1. 下载 FancyHelper.jar 并将其放入服务器的 plugins 文件夹中。
  2. 安装所需的依赖项 ProtocolLib(确保版本与服务端匹配)。
  3. 重启服务器;配置文件将自动生成。

配置 AI

插件默认使用 FancyConsole(一种免密钥 AI 中继服务)。开箱即用,但你需要注册并绑定一次:

  1. 在游戏内输入 /cli 并点击注册链接,或访问 https://console.fancy.baicaizhale.top/register?server=<your-server-id>。
  2. 注册后,获取你的 API Key 并在游戏内绑定:/cli bind <API Key>。
  3. 绑定完成后,即可开始聊天。

自带密钥 (BYOK): 在 config.yml 中将 provider.ai 设置为 openai 或 cloudflare,然后填写相应的 api_key / cf_key。

CloudFlare Workers AI: 教程:

OpenAI 兼容 API(DeepSeek、OpenAI 等): 教程:

MCP 工具服务器: 教程:

使用方法

  • 在游戏内输入 /cli 或 /fancy 以启动 AI 聊天模式。
  • 只需输入你的请求,例如:“在我当前位置生成一个 10x10 的石台。”
  • AI 会生成命令;确认后执行。

常见交互:

输入 效果
exit 退出 CLI 模式
stop 中断 AI 或取消当前操作
y / n 确认 / 取消执行
agree 同意条款或启用 YOLO 模式
/cli yolo 切换到 YOLO 模式(自动执行)
/cli smart 切换到 SMART 模式(AI 判断风险)
/cli plan 进入 Plan 模式
/cli retry 重试上一次的 AI 响应
/cli exempt_anti_loop 临时禁用反循环检测
/cli resume 恢复之前的会话
/cli skill list 列出已安装的 Skills
/cli todo 打开待办事项书
!message 以 ! 开头发送普通聊天消息,绕过 AI

命令与权限

命令 描述 默认权限
/fancyhelper 主命令(别名:/cli, /fancy) fancyhelper.cli
/fancyhelper bind <key> 绑定 FancyConsole API Key OP
/fancyhelper reload [target] 重载插件配置(config / workspace / playerdata / skill / mcp / deeply) fancyhelper.reload
/fancyhelper status 显示插件状态 fancyhelper.cli
/fancyhelper yolo / smart / normal / plan 切换对话模式 fancyhelper.cli
/fancyhelper settings 打开个人设置(流式传输、显示位置、声音等) fancyhelper.cli
/fancyhelper tools 管理文件工具权限(读取 / 写入) fancyhelper.cli
/fancyhelper memory 管理 AI 偏好记忆 fancyhelper.cli
/fancyhelper resume 恢复之前的会话 fancyhelper.cli
/fancyhelper todo 打开待办事项列表 fancyhelper.cli
/fancyhelper skill <list|info|load> Skill 列表 / 详情 / 加载 fancyhelper.skill.use
/fancyhelper skill <reload|install|upgrade> 管理 Skills(重载 / 安装 / 更新) fancyhelper.skill.admin
/fancyhelper mcp tools 查看 MCP 外部工具 fancyhelper.cli
/fancyhelper checkupdate 检查插件更新 fancyhelper.cli
/fancyhelper upgrade 下载并安装新版本 fancyhelper.reload
/fancyhelper notice 查看插件公告 fancyhelper.notice
/fancyhelper lib install protocollib 下载并安装 ProtocolLib 依赖 OP
权限 描述 默认值
fancyhelper.cli 允许使用 CLI 模式 OP
fancyhelper.reload 允许重载配置 OP
fancyhelper.notice 允许查看插件公告 OP
fancyhelper.skill.use 允许使用 skill 命令 OP
fancyhelper.skill.admin 允许管理 skills OP

贡献

支持

构建

git clone https://github.com/baicaizhale/FancyHelper.git
cd FancyHelper
mvn clean package

需要 Java 17 + Maven。

赞助我们

为了创建 FancyHelper,我们熬夜工作并倾注了心血。如果这个工具对你有帮助,是否考虑请我们喝杯饮料或茶?


© 2026 baicaizhale. Licensed under the GNU General Public License v3.0.

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源