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

• Smart Configuration Editing: 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.
• Preserves YAML Formatting: When modifying configuration files, the plugin maintains your existing indentations and spacing so your configs won't break.
• Context-Aware Commands: 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.
• Built-in Safety: 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:

   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.