🤖 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