FancyHelper

FancyHelper

用说人话的方式管理你的 Minecraft 服务器。

---

每次想给玩家调个权限、改个配置都要翻半天 Wiki？背指令背到头疼？

FancyHelper 就是来解决这个问题的。装好之后，你在游戏里直接跟 AI 说需求，比如"把 baicaizhale 设成管理员"，它会自己生成对应的指令，问你确认，然后执行。不用背指令，不用翻文档。

---

功能

• 聊天式管理 — 输入 /cli 进入对话模式，像跟真人管理员聊天一样管服务器
• AI 自动生成指令 — 接入 CloudFlare Workers AI（默认 gpt-oss-120b），你说需求它出指令
• 多 AI 可选 — 除了 CloudFlare，也支持 OpenAI、DeepSeek、Azure OpenAI、Ollama 本地模型等
• 执行前确认 — AI 生成的指令默认需要手动确认（y/n）才会执行，不会乱来
• YOLO 模式 — 嫌确认麻烦？同意协议后大部分指令自动执行，但 op、ban、stop 这种高危操作仍会问你
• 实时状态条 — 动作栏显示 AI 当前在干嘛（思考中 / 执行中 / 等你确认）
• 内置 Wiki 搜索 — 自带 LuckPerms、EssentialsX、WorldEdit 等主流插件的文档预设，搜不到还能自动全网搜
• 执行反馈闭环 — 指令跑完的结果会告诉 AI，错了它能自己改
• 配置文件自动更新 — 升级插件不用手动改配置，它会自己处理
• 防死循环 — AI 如果开始重复操作或疯狂调用，会自动拦截
  

兼容性

服务端

版本

Java

Spigot1.18+17+

Paper

1.18+

17+

依赖：

• ProtocolLib 5.4.0+（强烈建议装，用来捕获命令输出）
  

快速开始下载插件

💡 推荐下载最新版本，包含最新功能和修复。

安装

• 下载最新的 FancyHelper.jar，丢进服务器的 plugins 文件夹
• 同时装上依赖 ProtocolLib （26.1以上版本请使用dev构建）
• 重启服务器，配置文件会自动生成
  

配置 AI（可选，默认用 CloudFlare）

CloudFlare Workers AI（默认）： 去 CloudFlare 控制台或者 Key 共享站搞个 API Key，然后改 plugins/FancyHelper/config.yml：

cloudflare:  cf_key: 你的_CLOUDFLARE_API_KEY  model: "@cf/openai/gpt-oss-120b"

改完在游戏里输 /fancyhelper reload 重载。

OpenAI 兼容 API： 也支持 OpenAI 官方、DeepSeek、Ollama 本地模型、Azure OpenAI 等。在 config.yml 里：

openai:  enabled: true  api_url: "https://api.openai.com/v1/chat/completions"  api_key: "your-openai-api-key"  model: "gpt-4o"开用

• 游戏里输 /cli 或 /fancy 进入 AI 对话模式
• 直接打字说需求，比如"在当前位置生成一个 10x10 的石头平台"
• AI 会生成指令，你看没问题就确认执行
  

常用交互：

输入

作用

exit退出 CLI 模式

stop

打断 AI 或取消当前操作

y / n

确认 / 取消执行

agree

同意用户协议，或开启 YOLO 模式

/cli retry

重试上一次的 AI 响应

/cli exempt_anti_loop

临时关闭防死循环检测

!消息

以 ! 开头直接发聊天消息，不走 AI

常见问题

日志里刷 [WARN]: Failed to update secure chat state for <player>: 'Chat disabled due to missing profile public key. Please try reconnecting. 警告？

这是 Minecraft 的 enforce-secure-profile 安全聊天验证导致的，不是本插件的锅。 FancyHelper 会自动尝试把 server.properties 里的这个选项改成 false，改完重启就好。如果自动改失败了，手动改一下再重启。

为什么要装 ProtocolLib？

用来捕获命令输出和拦截系统消息，不装也能跑，但功能不完整。 你可以使用 /fancy lib install protocollib 命令自动下载安装（需要 OP 权限）。

指令与权限

指令

描述

默认权限

/fancyhelper插件主指令 (别名: /cli, /fancy)fancyhelper.cli

/fancyhelper reload

重载插件配置

fancyhelper.reload

/fancyhelper lib install protocollib

下载并安装 ProtocolLib 依赖

OP

权限

描述

默认

fancyhelper.cli允许使用 CLI 模式OP

fancyhelper.reload

允许重载配置

OP

fancyhelper.notice

允许查看插件公告

OP

构建git clone https://github.com/baicaizhale/FancyHelper.gitcd FancyHelpermvn clean package

需要 Java 17 + Maven。

---

© 2026 baicaizhale 保留所有权利。