FancyHelper

Manage your Minecraft server with natural language.

---

Tired of digging through Wikis and memorizing complex commands just to change a permission or a config file?

FancyHelper is here to solve this problem. Once installed, you can talk directly to an AI in-game. For example, say "Set baicaizhale as admin," and it will generate the corresponding command, ask for your confirmation, and execute it. No more command memorization, no more manual searching.

Features

• Chat-based Management — Type /cli to enter conversation mode. Manage your server as if you're chatting with a human co-admin.
• AI Command Generation — Defaults to FancyConsole (keyless AI relay). Also supports OpenAI-compatible endpoints such as OpenAI, DeepSeek, and CloudFlare Workers AI (BYOK).
• Four Conversation Modes — Normal: every command needs confirmation. YOLO: after agreeing to the terms, most commands run automatically, though high-risk ones like op, ban, and stop still ask. SMART: the AI judges risk and executes low-risk commands directly. Plan: plan first, then execute — great for complex tasks.
• Pre-execution Confirmation — In Normal mode, AI-generated commands require manual confirmation (y/n) to prevent accidents.
• Real-time Status Bar — The Action Bar displays what the AI is doing (Thinking / Executing / Waiting for confirmation), with streaming output word by word.
• Built-in Wiki Search — Comes with documentation presets (Skills) for LuckPerms, EssentialsX, WorldEdit and other major plugins. Falls back to web search (Tavily / Metaso) if nothing is found.
• Skill System — Inject markdown knowledge files into the AI for specific plugins. Online market for one-click install/update.
• Feedback Loop — The output of executed commands is fed back to the AI. If something fails, the AI can correct itself.
• File Tools — Let the AI read and edit server config files (#read / #edit / #write). First-time use requires verification.
• MCP Client — Connect to external MCP tool servers, letting the AI call any external tool.
• Todo List — The AI maintains a task list via #todo, viewable in-game as a book.
• Preference Memory — The AI remembers each player's long-term preferences (#remember / #forget).
• Session Resume — Conversation history is persisted. Use /cli resume to pick up where you left off.
• Auto Updates — Detects new versions, downloads and hot-reloads automatically — no server restart needed.
• Multi-language — Plugin UI supports Simplified Chinese / English / Classical Chinese. Switch in config.yml.
• Anti-Loop Protection — Automatically intercepts the AI if it starts repeating operations or making excessive calls.

Compatibility

Server	Version	Java
Spigot	1.18+	17+
Paper (recommended)	1.18+	17+

Paper and its forks (Purpur, Pufferfish, etc.) are recommended. Spigot works, but the plugin warns at startup because some advanced features rely on Paper-specific APIs.

Dependencies:

• ProtocolLib 5.4.0+ — Required, used to capture command output and intercept system messages. The plugin disables itself without it.

Quick Start

Installation

1. Download FancyHelper.jar and place it in the server's plugins folder.
2. Install the required dependency ProtocolLib (make sure to match the version to your server).
3. Restart the server; configuration files will be generated automatically.

Configure AI

The plugin defaults to FancyConsole (a keyless AI relay service). It works out of the box, but you need to register and bind once:

1. Type /cli in-game and click the registration link, or visit https://console.fancy.baicaizhale.top/register?server=<your-server-id>.
2. After registering, get your API Key and bind it in-game: /cli bind <API Key>.
3. Once bound, you can start chatting.

Bring Your Own Key (BYOK): Set provider.ai to openai or cloudflare in config.yml, then fill in the corresponding api_key / cf_key.

CloudFlare Workers AI: Tutorial:

OpenAI Compatible API (DeepSeek, OpenAI, etc.): Tutorial:

MCP Tool Servers: Tutorial:

Usage

• Enter /cli or /fancy in-game to start AI chat mode.
• Simply type your request, e.g., "Generate a 10x10 stone platform at my current location."
• The AI generates the command; confirm it to execute.

Common Interactions:

Input	Effect
exit	Exit CLI mode
stop	Interrupt the AI or cancel current operation
y / n	Confirm / Cancel execution
agree	Agree to terms or enable YOLO mode
/cli yolo	Switch to YOLO mode (auto-execute)
/cli smart	Switch to SMART mode (AI judges risk)
/cli plan	Enter Plan mode
/cli retry	Retry the previous AI response
/cli exempt_anti_loop	Temporarily disable anti-loop detection
/cli resume	Resume a previous session
/cli skill list	List installed Skills
/cli todo	Open the todo list book
!message	Start with ! to send normal chat messages, bypassing AI

Commands & Permissions

Command	Description	Default Permission
/fancyhelper	Main command (Aliases: /cli, /fancy)	fancyhelper.cli
/fancyhelper bind <key>	Bind a FancyConsole API Key	OP
/fancyhelper reload [target]	Reload plugin config (config / workspace / playerdata / skill / mcp / deeply)	fancyhelper.reload
/fancyhelper status	Show plugin status	fancyhelper.cli
/fancyhelper yolo / smart / normal / plan	Switch conversation mode	fancyhelper.cli
/fancyhelper settings	Open personal settings (streaming, display position, sound, etc.)	fancyhelper.cli
/fancyhelper tools	Manage file tool permissions (read / write)	fancyhelper.cli
/fancyhelper memory	Manage AI preference memory	fancyhelper.cli
/fancyhelper resume	Resume a previous session	fancyhelper.cli
/fancyhelper todo	Open the todo list	fancyhelper.cli
/fancyhelper skill <list|info|load>	Skill list / details / load	fancyhelper.skill.use
/fancyhelper skill <reload|install|upgrade>	Manage Skills (reload / install / update)	fancyhelper.skill.admin
/fancyhelper mcp tools	View MCP external tools	fancyhelper.cli
/fancyhelper checkupdate	Check for plugin updates	fancyhelper.cli
/fancyhelper upgrade	Download and install the new version	fancyhelper.reload
/fancyhelper notice	View plugin announcements	fancyhelper.notice
/fancyhelper lib install protocollib	Download and install ProtocolLib dependency	OP

Permission	Description	Default
fancyhelper.cli	Allows usage of CLI mode	OP
fancyhelper.reload	Allows reloading configuration	OP
fancyhelper.notice	Allows viewing plugin announcements	OP
fancyhelper.skill.use	Allows using skill commands	OP
fancyhelper.skill.admin	Allows managing skills	OP

Contributing

• Report a Bug
• Request a Feature
• Ask a Question
• Pull requests are welcome! Build from source using the instructions below and submit a PR.

Support

• GitHub Issues

Build

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

Requires Java 17 + Maven.

Sponsor Us

To create FancyHelper, we have burned the midnight oil and poured our hearts into it. If this tool helps you, would you consider inviting us for a drink or a cup of tea?

---

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