# FancyHelper<\/p>\n
> Manage your Minecraft server with natural language.<\/p>\n
Tired of digging through Wikis and memorizing complex commands just to change a permission or a config file?<\/p>\n
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.<\/p>\n
## ASKING FOR HELP? \u2192 <\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Chat-based Management** \u2014 Type `\/cli` to enter conversation mode. Manage your server as if you’re chatting with a human co-admin.
\n– **AI Command Generation** \u2014 Integrated with CloudFlare Workers AI (default: `gpt-oss-120b`). You state the intent; it writes the command.
\n– **Multi-Model Support** \u2014 Supports CloudFlare, OpenAI, DeepSeek, Azure OpenAI, local Ollama models, and more.
\n– **Pre-execution Confirmation** \u2014 AI-generated commands require manual confirmation (`y`\/`n`) by default to prevent accidents.
\n– **YOLO Mode** \u2014 Tired of confirming? After agreeing to the terms, most commands execute automatically, though high-risk operations like `op`, `ban`, and `stop` still require approval.
\n– **Real-time Status Bar** \u2014 The Action Bar displays what the AI is currently doing (Thinking \/ Executing \/ Waiting for confirmation).
\n– **Built-in Wiki Search** \u2014 Includes documentation presets for LuckPerms, EssentialsX, WorldEdit, and more. It can even search the web if not found locally.
\n– **Feedback Loop** \u2014 The output of executed commands is fed back to the AI. If something fails, the AI can correct itself.
\n– **Automatic Config Updates** \u2014 No need to manually edit configs during upgrades; it handles them automatically.
\n– **Anti-Loop Protection** \u2014 Automatically intercepts the AI if it starts repeating operations or making excessive calls.<\/p>\n
## Compatibility<\/p>\n
| Server | Version | Java |
\n|——–|——|——|
\n| Spigot | 1.18+ | 17+ |
\n| Paper | 1.18+ | 17+ |<\/p>\n
**Dependencies:**
\n– ProtocolLib 5.4.0+ (Highly recommended for capturing command output).<\/p>\n
## Quick Start<\/p>\n
### Download Plugin<\/p>\n
<\/p>\n
> \ud83d\udca1 Recommended to download the latest version for the newest features and fixes.<\/p>\n
### Installation<\/p>\n
1. Download the latest `FancyHelper.jar` and place it in the server’s `plugins` folder.
\n2. Install the dependency ProtocolLib (For versions 26.1+, please use dev builds).
\n3. Restart the server; configuration files will be generated automatically.<\/p>\n
### Configure AI (Optional, defaults to CloudFlare)<\/p>\n
**CloudFlare Workers AI (Default):**
\nObtain an API Key from the CloudFlare console or a shared key provider, then edit `plugins\/FancyHelper\/config.yml`:<\/p>\n
“`yaml
\ncloudflare:
\n cf_key: YOUR_CLOUDFLARE_API_KEY
\n model: “@cf\/openai\/gpt-oss-120b”
\n“`<\/p>\n
After editing, run `\/fancyhelper reload` in-game to apply.<\/p>\n
**OpenAI Compatible API:**
\nSupports official OpenAI, DeepSeek, Ollama local models, Azure OpenAI, etc. In `config.yml`:<\/p>\n
“`yaml
\nopenai:
\n enabled: true
\n api_url: “https:\/\/api.openai.com\/v1\/chat\/completions”
\n api_key: “your-openai-api-key”
\n model: “gpt-4o”
\n“`<\/p>\n
### Usage<\/p>\n
– Enter `\/cli` or `\/fancy` in-game to start AI chat mode.
\n– Simply type your request, e.g., “Generate a 10×10 stone platform at my current location.”
\n– The AI generates the command; confirm it to execute.<\/p>\n
**Common Interactions:**<\/p>\n
| Input | Effect |
\n|——|——|
\n| `exit` | Exit CLI mode |
\n| `stop` | Interrupt the AI or cancel current operation |
\n| `y` \/ `n` | Confirm \/ Cancel execution |
\n| `agree` | Agree to terms or enable YOLO mode |
\n| `\/cli retry` | Retry the previous AI response |
\n| `\/cli exempt_anti_loop` | Temporarily disable anti-loop detection |
\n| `!message` | Start with `!` to send normal chat messages, bypassing AI |<\/p>\n
## FAQ<\/p>\n
**Seeing `[WARN]: Failed to update secure chat state for This is caused by Minecraft’s `enforce-secure-profile` security setting, not the plugin itself. **Why install ProtocolLib?**<\/p>\n It’s used to capture command output and intercept system messages. It works without it, but some features will be incomplete. ## Commands & Permissions<\/p>\n | Command | Description | Default Permission | | Permission | Description | Default | ## Build<\/p>\n “`bash Requires Java 17 + Maven.<\/p>\n —<\/p>\n **\u00a9 2026 baicaizhale All Rights Reserved.**<\/p>\n","protected":false},"excerpt":{"rendered":" An Agent tool made for Minecraft, easy to use, let Fancy do everything for you<\/p>\n","protected":false},"featured_media":68656,"template":"","meta":{"_minecraft_slug":"fancyhelper","_minecraft_project_id":"PQQFs3yj","_minecraft_author":"baicaizhale","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":33,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"fancyhelper.zip","_minecraft_size_bytes":15534001,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T21:54:03.405720Z","_minecraft_date_created":"2026-02-28T03:08:09.490977Z","_minecraft_date_modified":"2026-05-03T01:04:49.459210Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/fancyhelper","_minecraft_icon_attachment_id":68656,"_minecraft_imported_at":"2026-06-03T22:01:15+00:00","_minecraft_import_hash":"8517c8069ae6278a391383fe97aa9510","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,129,92],"mod_loader":[132,134],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-68655","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nFancyHelper will automatically attempt to set this to `false` in `server.properties`. Restart the server after the change. If it fails, edit manually and restart.<\/p>\n
\nYou can use the `\/fancy lib install protocollib` command to download and install it automatically (OP permission required).<\/p>\n
\n| :— | :— | :— |
\n| `\/fancyhelper` | Main command (Aliases: `\/cli`, `\/fancy`) | `fancyhelper.cli` |
\n| `\/fancyhelper reload` | Reload plugin configuration | `fancyhelper.reload` |
\n| `\/fancyhelper lib install protocollib` | Download and install ProtocolLib dependency | OP |<\/p>\n
\n| :— | :— | :— |
\n| `fancyhelper.cli` | Allows usage of CLI mode | OP |
\n| `fancyhelper.reload` | Allows reloading configuration | OP |
\n| `fancyhelper.notice` | Allows viewing plugin announcements | OP |<\/p>\n
\ngit clone https:\/\/github.com\/baicaizhale\/FancyHelper.git
\ncd FancyHelper
\nmvn clean package
\n“`<\/p>\n