🤖 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

1. Grab a free API key from openrouter.ai
2. Drop the plugin in your /plugins folder
3. Run /api set <your-key>
4. 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