GeminiBot AI 2.2

🌟 STOP USING STATIC NPCs. START USING TRUE INTELLIGENCE.

Are your players tired of reading endless holographic displays just to learn how to play on your server? Do your staff members spend hours answering the same basic questions over and over?

Introducing GeminiBot.

GeminiBot brings the cutting edge of Artificial Intelligence directly into your Minecraft chat. This isn't a simple chatbot; it is a context-aware, immersive spirit that lives within your server, learning your rules, understanding your other plugins, and guiding your players in real-time—all while respecting the immersion of the game.



🔥 KEY FEATURES (Why Owners Love GeminiBot)

🧠 Dynamic Contextual Memory
GeminiBot doesn't just answer questions; it holds conversations. Thanks to advanced memory management, players can ask follow-up questions.

1. Player: "How do I create a Town?"
2. Bot: Explains /t new.
3. Player: "And what does it cost?"
4. Bot: Understands the context and provides the cost.

🛡️ Smart Anti-Exploit & RP Focus
We know server owners fear AI hallucinating or helping players cheat. Our plugin includes professional-grade prompt engineering instructions that force the bot to stay in character (no "plugin" talk) and reject exploit attempts (like duplication glitches). It acts like a sagemaster, not software.

🧩 True Auto-Learning (Read External Configs)
Forget manually pasting your entire server wiki into a prompt. Unique Feature: GeminiBot can automatically read the .yml configuration files of your other plugins! Drop Towny's config.yml or Essentials' rules.txt into the special folder, and the bot automatically understands your custom economy prices, town rules, and warped locations.

📊 Native PlaceholderAPI Support
Let the bot deliver personalized data. If PlaceholderAPI is installed, the bot automatically reads player stats.

1. Ask: "What is my current balance?" and get the actual Vault economy value.
2. Ask: "What is my ping?" for live network status.

🚀 Zero Lag & Async Execution
Your server's performance is paramount. GeminiBot executes all API requests asynchronously in a separate thread. This means zero tps drops and zero lag for other players while the AI is thinking.

💰 Zero AI Operating Cost (User's Own Key)
This plugin utilizes the Google Gemini API. Your buyers will use their own API Key, which has an extremely generous FREE TIER (up to 1,500 requests per day at zero cost!). You can advertise this as "Zero Cost AI for your server!"

🛠️ COMMANDS & PERMISSIONS

/ask - Ask the AI a private question. (Permission: geminibot.ask)
/askpublic - Ask a question and broadcast response globally. (Permission: geminibot.public)
/geminireload - Reload configs, secrets, and external configs. (Permission: geminibot.admin)
/geminimute - Block a player's AI access for X minutes. (Permission: geminibot.admin)

Special Permissions:
geminibot.vip - Players with this permission bypass the cooldown timer. Great donor perk!

⚙️ PROFESSIONAL CONFIGURATION

GeminiBot gives you full control over aesthetic and behavior. Check out the clean, comment-rich config.yml that ships with the plugin:

# ==========================================
# GEMINIBOT v2.2 | CONFIGURATION
# ==========================================

# AESTHETICS & BEHAVIOR
bot_name: "&b[GuideCraft]"
default_ask_is_public: false
cooldown_seconds: 30
memory_turns: 5

# ==========================================
# THE BOT'S BRAIN (Roleplay Prompt)
# Note: Bot automatically reads external plugin configs!
# ==========================================
system_prompt: |-
  You are 'GuideCraft', the ancient spirit and magical assistant of this Minecraft world.
  ... (detailed anti-exploit rules already configured) ...

🚀 SIMPLE SETUP GUIDE

We pride ourselves on ease of use. Setting up GeminiBot takes less than 2 minutes.

1. Drop the GeminiBot.jar into your plugins folder and restart the server.

2. Open the newly created secrets.yml and paste your free Google Gemini API Key.

3. Open config.yml to customize the bot's name and roleplay style.

4. (Optional) Drop .yml config files from your other plugins into the external_configs folder.

5. Type /geminireload. Your intelligent assistant is ready!