GemServer v2.5 🎉

Created by MOOOODER and 2s2ones

GemServer is a comprehensive AI integration for Paper and Spigot servers that utilizes the Google Gemini API to provide a deeply contextualized assistant for both players and administrators. Unlike standard chatbots, GemServer has direct access to live server data and player-specific context, allowing it to provide accurate information about the game world and even assist with server management.

Installation and Setup

1. Place the gemserver-plugin-2.5-SNAPSHOT.jar into your server's plugins folder.
2. Restart the server to generate the configuration files.
3. Obtain a free or paid API key from Google AI Studio (aistudio.google.com).
4. Use the in-game command /api <your_key> or edit the config.yml manually.
5. In the configuration, set accept-google-ai-tos: true to unlock the plugin's functionality.

How to Interact

To speak with Gemini, players simply need to start a chat message with the phrase "Hey gemini, ". The plugin will cancel the public message, process the request, and open a private virtual book for the player containing the AI's response.

Example: "Hey gemini, what biome am I currently in?"

Commands and Permissions

All commands below require the gemserver.api permission, which is granted to Operators (OPs) by default.

• /gemini: Opens the main graphical interface (GUI). From here, you can view your personal statistics, browse your full question history, view your "Starred" responses, or read the Server Wiki.
• /gemhistory: A quick command to open a virtual book containing your previous questions.
• /api keep: When you receive a response from Gemini, you can use this command to receive a physical, permanent version of the book in your inventory.
• /api <key>: Sets the active Gemini API key.
• /api reload: Reloads the plugin configuration, wiki data, and resets the model cache.

Configuration Guide

The config.yml file allows you to customize the AI's behavior and safety settings. Below are the key sections:

# Set this to true to accept the Google AI Terms of Service.
# This is mandatory for the plugin to function.
accept-google-ai-tos: false

# Rate limit in seconds between player questions to prevent spam.
cooldown-seconds: 10

# Auto-Moderation settings for chat safety.
auto-moderation:
  enabled: true
  toxicity-threshold: 0.85
  action: "WARN" # Options: WARN, KICK, BAN
  staff-notification: "<red>[Gemini-Mod] <white>Player <yellow>%player% <white>is being toxic! Score: <red>%score%"

# Custom Knowledge Base
# Use this section to teach Gemini about your server's specific rules and features.
server-wiki: |
  Welcome to our server! 
  Rules: 1. No griefing. 2. Be respectful.
  Commands: Use /gemini to access the hub.

Advanced AI Features

• AI Function Calling: Gemini can suggest and execute server commands for OPs. For example, if an OP asks "Heal me," the AI can trigger the /heal command automatically.
• Context Awareness: The AI receives real-time data including player coordinates, biome, health, food level, experience, held items, server TPS, and memory usage.
• Conversational Memory: The AI retains context for the last three questions asked by a player, allowing for follow-up questions and natural dialogue.
• GUI Hub: A centralized menu for managing history and "Starring" important responses for future reference.

Changelog

v2.5-SNAPSHOT

• Complete overhaul of the plugin architecture.
• Implemented AI Function Calling for administrative tasks.
• Added AI-driven Auto-Moderation with toxicity scoring.
• Introduced the /gemini GUI Hub for statistics and history management.
• Added support for a custom Server Wiki knowledge base.
• Integrated deep server context (coordinates, health, TPS, etc.).
• Added conversational memory (last 3 interactions).
• Added the /api keep command to export AI responses to physical items.
• Integrated PlaceholderAPI support.
• Implemented a mandatory Terms of Service check for legal compliance.
• Refined book pagination and color rendering logic.