AIAgent

AIAgent

AIAgent is a server management plugin that integrates Google's Gemini AI directly into your Minecraft server. Instead of just acting as a chatbot, this plugin acts as an autonomous agent. It can read server files, modify configurations safely, and execute console commands based on natural language prompts.

You don't need to remember complex command syntaxes or dig through YAML files to find a specific setting. Just tell the AI what you want to do.

Features

* Free to Use: The AI doesn't just blindly guess config keys. If you ask it to modify a plugin (e.g., "disable update checks in ViaVersion"), the agent will first read the target `config.yml`, locate the exact correct key, and then apply the change. * Free to Use: When modifying configuration files, the plugin maintains your existing indentations and spacing so your configs won't break. * Free to Use: The AI knows who is executing the command. If you type `/aiagent make me op` or `/aiagent heal me`, it automatically targets your exact username. * Free to Use: By default, the AI will not execute anything immediately. It will tell you exactly which files it wants to edit, what keys it wants to change, or what commands it wants to run. You must type `/aiagent confirm` to apply the changes or `/aiagent cancel` to abort. * Free to Use: Powered by Google's Gemini API (defaults to `gemini-3-flash`), which offers a very generous free tier. API key required.

Examples

You can use plain English (or any other language Gemini understands) to control your server:

* `/aiagent change the render distance to 8` *(Finds view-distance in server.properties and updates it)* * `/aiagent make it morning and clear the weather` *(Executes /time set day and /weather clear)* * `/aiagent disable the check-for-updates in viaversion` *(Reads plugins/ViaVersion/config.yml, finds the right setting, and updates it)*

Setup & Installation

1. Drop the `AIAgent.jar` into your server's `plugins` folder. 2. Start the server once to generate the `config.yml` file. 3. Get a free API key from Google AI Studio. 4. Open `plugins/AIAgent/config.yml` and paste your API key: ```yaml gemini-api-key: "YOUR_API_KEY_HERE" model: "gemini-3-flash" require-confirmation: true ``` 5. Restart the server or reload the plugin.

Commands & Permissions

* `/aiagent <prompt>` - Ask the AI to do something. * `/aiagent confirm` - Approve the AI's proposed actions. * `/aiagent cancel` - Cancel the pending actions.

Permission node: `aiagent.admin` (Defaults to OP). Only grant this permission to highly trusted administrators, as it allows modifying root server files and executing console commands.