ServerAssistantAI
Every Minecraft server owner knows the struggle: the same questions scroll through chat day after day. Where is the shop? How do I claim land? Who are the admins? Staff members burn out repeating answers, and new players wander off before they ever find help. ServerAssistantAI solves that problem by putting an AI-powered assistant directly inside your Minecraft Java server, ready to answer questions in any language at any hour.
What Is ServerAssistantAI?
ServerAssistantAI is a plugin that connects your server to Google Gemini AI. Instead of a generic chatbot that knows nothing about your world, this assistant reads a plain text file you write yourself and uses that information to answer player questions accurately. Players simply type /assistance <prompt> in chat, and the plugin sends their question, along with your server details, to the AI. The response appears in chat moments later.
Because the assistant is grounded in your own documentation, it can explain your economy, land protection system, ranks, events, rules, and anything else you choose to include. It even responds in the same language the player used, so a French question gets a French answer and an Indonesian question gets an Indonesian answer.
Key Features at a Glance
- Google Gemini AI integration with configurable model selection
- Server-specific answers pulled from your own information file
- Automatic detection of updates to server-information.txt, no restart required
- Cooldown system to prevent spam and control API usage
- Permission nodes for both the assistant command and reload command
- Asynchronous AI requests that never lag the main server thread
- Support for all languages the AI model understands
- Fully customizable messages with Minecraft color code support
Supported Versions and Server Software
ServerAssistantAI is built for Minecraft Java Edition and works across a wide range of server platforms. It is compatible with Paper, Spigot, CraftBukkit, Folia, Purpur, Pufferfish, and Leaves, which covers most modern Java servers from recent releases back through older 1.16-era builds. If your network runs a fork of Paper or Spigot, chances are this plugin will load without complaint.
How to Install ServerAssistantAI
Getting the plugin running takes only a few minutes. Follow these steps in order:
- Download the latest plugin jar from the official repository.
- Place the .jar file into your server's plugins folder.
- Start or restart the server to generate the configuration files.
- Open plugins/ServerAssistantAI/config.yml and enter your Gemini API key.
- Open plugins/ServerAssistantAI/server-information.txt and replace the template text with your own server details.
- Restart the server, then test with /assistance how do I buy land?
If you prefer a smoother setup, the foxygame.net launcher handles the entire process in a single click, dropping ServerAssistantAI into your plugins folder and keeping it current with automatic updates whenever a new build ships. That means one less thing to manage when you are already juggling a dozen other add-ons.
Configuring the Assistant
AI Settings
The main configuration lives in config.yml. You can set the Gemini model, your API key, the maximum response length in tokens, and the cooldown between requests. A cooldown of 3, for example, forces players to wait three seconds before asking again, which keeps chat readable and API costs predictable. Never share your API key publicly, and avoid placing passwords or database credentials inside server-information.txt, since that text is sent to the AI with each question.
Writing Your Server Information
The server-information.txt file is intentionally plain text rather than YAML or JSON. This lets you describe your server naturally, the way you would explain it to a new player. Include sections for your shop commands, land claiming system, staff list, rules, ranks, and events. Lines starting with // are treated as comments and are stripped before the text reaches the AI, so you can organize the file however you like.
One of the best parts of ServerAssistantAI is that edits to this file are picked up automatically. Change "Use /shop to open the shop" to "Use /market to open the shop," and the very next question will reflect the update. No reload, no restart.
Commands and Permissions
- /assistance <prompt> asks the assistant a question, available to everyone by default
- /assist <prompt> is a shorter alias for the same command
- /assistance reload reloads the plugin configuration and requires operator status
A Note on AI Safety
ServerAssistantAI treats player input as untrusted, and the AI is instructed to ignore attempts to override its rules or reveal internal instructions. That said, no AI system can guarantee complete protection against prompt injection, so keep sensitive data out of your information file entirely.
Final Thoughts
ServerAssistantAI fills a gap that most server plugins ignore: the endless stream of beginner questions. By pairing Google Gemini with your own documentation, it delivers accurate, multilingual answers without adding staff workload. Whether you run a small survival world or a large network on Paper or Folia, this assistant is a practical addition that players will notice immediately. Set it up once, keep your information file current, and let the AI handle the rest.