ServerAI - FREE AI Chat Assistant for Your Server

Actually free AI for Minecraft - no monthly costs, no paid APIs!

⚡ Why ServerAI?

Most AI plugins require paid API subscriptions. ServerAI uses Google's completely free Gemini API:

🎉 14,400+ FREE requests per day (per Gemma 3 model)
🔄 Multiple Gemma 3 models = 28.8K+ daily requests (basically unlimited for most servers)
💰 $0/month forever - Perfect for any server budget
⚡ 30-second setup - Just add your free API key and go!

Note: You can also use standard Gemini models for even better responses with huge context memory (1000+ messages!), but they have lower rate limits. Gemma 3 models are recommended for unlimited usage!

✨ Features

🧠 Smart AI Assistant

Context-Aware Responses - AI understands chat, joins/leaves, deaths, and more
Intelligent Response System - AI decides when to respond based on relevance (no command spam!)
Persistent Memory - Remembers players and conversations across sessions
Natural Conversations - Feels like chatting with a real player

🎨 Fully Customizable

Custom Personality - Helpful assistant, sarcastic bot, server guide, or roast master 💀
Server Knowledge - Teach it your rules, IP, Discord, commands, and features
Adjustable Behavior - Control response frequency, cooldowns, and safety filters
Multiple AI Models - Switch between Gemma 3 models (high rate limits) or standard Gemini models (better quality + huge 1000+ message context, but lower limits)
Advanced Config - Everything is extensively documented in the config file!

🔧 Server Integration

Zero Dependencies - Self-contained plugin, no external plugins needed
No Lag - Async processing keeps your server smooth
Extensive Config - Everything is customizable with detailed comments
Cross-Version - Works on 1.8 through latest versions

🚀 Quick Start

Get your FREE API key → Google AI Studio
Drop the JAR into your plugins/ folder

Edit plugins/ServerAI/config.yml:

api:  key: "YOUR_API_KEY_HERE"bot:  name: "ServerAI"  personality: "You are a helpful and friendly AI assistant..."

Restart and watch it work!

That's it! No complex setup, no monthly bills, no dependencies.

💬 What Can It Do?

Help Players

Player: "How do I claim land?"
AI: "Use /claim while holding a golden shovel! Right-click two corners to set your area."

Welcome New Players

NewPlayer joined the game
AI: "Welcome to the server, NewPlayer! Need help getting started? Just ask!"

Share Server Info

Player: "What's the Discord?"
AI: "Join our Discord at discord.gg/yourserver - that's where we hang out!"

Roast Mode 💀

Player: "Can I fly in survival?"
AI: "Yeah bro, just believe in yourself hard enough... or maybe read the rules lol"

Answer Questions

Player: "What's the best way to make money?"
AI: "Sell resources at /shop, complete jobs with /jobs, or set up your own player shop!"

⚙️ Configuration Examples

The config file is extensively documented! Here are some personality examples:

🤝 Helpful Assistant

personality: "You are a friendly server assistant. Help players with commands, rules, and gameplay. Be concise and welcoming!"
server_info: "Rules: No griefing, be respectful | IP: play.example.net | Discord: discord.gg/example"

😎 Sarcastic Guide

personality: "You're a sassy AI who loves friendly banter. Give players a hard time with playful roasts, but always help them in the end. Keep it funny!"

📚 Professional Server Guide

personality: "You're the official guide for this server. You know all rules, features, and commands. Be professional and informative."
server_info: "
Server: CoolCraft SMP
Rules: No griefing, PvP in arena only, be respectful
Commands: /spawn, /tpa, /home, /sethome, /shop, /jobs
Features: Custom enchants, player economy, land claiming, weekly events
Events: PvP tournament every Saturday 8PM EST
"

Check the config.yml for all available options - it's super well documented!

📊 Perfect For...

✅ Budget servers wanting AI features
✅ Community servers needing 24/7 help
✅ Servers wanting to boost player engagement
✅ Automating common questions and support
✅ Adding personality to your server
✅ Welcoming and retaining new players

🎮 Version Support

Version	Status
1.20+	✅ Latest - Fully Supported & Actively Maintained
1.13 - 1.19.x	✅ Modern - Fully Supported & Actively Maintained
1.8 - 1.12.x	🔜 Legacy - Coming Soon (Experimental)

🛠️ Commands & Permissions

Command	Permission	Description
`/serverai reload`	`serverai.admin`	Reload configuration
`/serverai status`	`serverai.admin`	View plugin status & stats
`/serverai debug`	`serverai.admin`	Toggle debug mode
`/serverai clear`	`serverai.admin`	Clear all data (memory)

Default permission: OP only

⚙️ Key Config Options

API Models: Choose between Gemma 3 (high rate limits) or Gemini (better quality)
Memory Size: Set chat history size (default 80, can go way higher like 1000+!)
Decision System: AI intelligently decides when to respond (saves tokens!)
Response Behavior: Cooldowns, response frequency, and more
Context Control: What the AI can see (commands, joins/leaves, deaths, stats)
Safety Filters: Adjustable content moderation
Temperature: Control creativity (0.0-2.0)

Everything is explained in detail in the config.yml file!

❓ Questions?

Got questions about ServerAI? Ask in the comments section below and I'll help you out!

🔮 Future Plans

Honestly made this for fun, but I'll probably add more stuff! Some ideas:

More features as I think of them
Whatever the community suggests
Cool stuff I haven't thought of yet

Feel free to suggest features!

💡 Pro Tips

🎯 Give it context! The more server info you provide in config, the better it helps players
🎯 Adjust cooldowns if it's too chatty or too quiet
🎯 Use custom instructions to teach it specific commands or features
🎯 Read the config file - seriously, it's super well documented with examples!
🎯 Experiment with models - Gemma 3 for unlimited usage, or Gemini for better quality + huge context (1000+ messages!)

🔗 Join our Discord server for support, updates, and community discussion!

⭐ Enjoying the plugin?

If ServerAI helps your server, spread the word and let other server owners know about it!

Made with ❤️ for the Minecraft community

No monthly fees. No hidden costs. Just free AI for your server.

ServerAI (Free Gemini API - No Dependencies)