PromptPilot
This plugin lets an ai config your server via a openrouter api key the ai can read files write files execute commands read logs and more
🤖 PromptPilot
AI-powered server automation. Just type what you want done.
PromptPilot connects your Minecraft server to an AI that can read files, write files, and run commands — all from a single chat prompt. No scripts, no complex setup. Just tell it what to do.
✨ What It Does
Instead of manually editing config files, reloading plugins, or running a chain of commands — you describe the task, and the AI handles it.
/prompt read the TAB config and change all colors to red and white, then reload
The AI will read the file, rewrite it with the new colors, and run /tab reload — automatically.
⚙️ How It Works
PromptPilot uses a multi-turn reasoning loop powered by OpenRouter. The AI is given a set of tools it can invoke in sequence:
| Tool | What it does |
|---|---|
READFILE | Read any file on the server |
WRITEFILE | Write or overwrite any file |
LISTDIR | Browse the server's directory structure |
CMD | Dispatch any console command |
SAY | Broadcast a message to all players |
After each action, the AI verifies the result via live server logs before deciding its next step. A built-in hallucination supervisor detects when the AI claims to have done something without actually executing it, and forces a retry.
🚀 Commands
| Command | Description |
|---|---|
/api set <key> | Set your OpenRouter API key |
/prompt <query> | Run an AI prompt against your server |
That's it. Two commands.
🔑 Setup
- Grab a free API key from openrouter.ai
- Drop the plugin in your
/pluginsfolder - Run
/api set <your-key> - Start prompting
Runs on Paper 1.21+ with Java 21.
⚠️ Permissions
Both commands are op-only by default. It is strongly recommended to keep it that way — the AI has full access to your server's file system and console.
Powered by OpenRouter · Default model: google/gemini-2.0-flash
