- Versions
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.20.6
- 1.21
ServerAssistantAI (SAAI) is a Minecraft plugin that integrates an AI-based assistant into both your Minecraft and Discord server, providing instant, context-aware responses to player inquiries, enhancing their experience, and reducing the workload on server staff. It uses Embedding Models to retrieve only the most relevant information from server documents and Large Language Models (LLMs) to understand and generate human-like responses to player questions. Elevate your server's support system with AI efficiency and enhance the gaming experience for your community.
Key Features of ServerAssistantAI:
- Instant Dual-Platform AI Responses: Get immediate answers to questions asked in-game, as well as on Discord.
- Extensive AI Model Support (Free and Paid!): Choose between completely free and paid Large Language Models from 20+ AI Providers for diverse AI capabilities.
- Smart Question Detection: Question detection to identify and respond to server-related questions from players.
- Multi-Document Based Information: The documents/ directory supports multiple file formats (.txt, .md, .pdf, .docx, .pptx, .xlsx) and sub-folders, containing all server-related information.
- Embedding-Based Retrieval: Uses Embedding Models from free or paid providers to analyze and retrieve the most relevant information from the documents/ directory, ensuring only relevant context is sent to the AI, regardless of document size.
- Natural Language Understanding: Leverages Large Language Models (LLMs) from free or paid providers to understand and generate human-like context-aware responses to player questions.
- Configurable Interaction: Tailor AI persona and behavior to your server's unique needs along with many different configuration options.
- Fully Customizable Messages: The `messages.yml` file allows you to personalize all messages displayed by ServerAssistantAI in both Minecraft and Discord to adapt to your server's style.
- Public and Private Responses: Option for players to receive AI responses publicly in chat or privately.
- Forced Response Trigger: Ability to mention the bot's name in a message to force a response, even if the message is not a question.
- Continuous Chat Mode: Players can engage in a continuous private conversation with the AI.
- Daily Question Limits: Manage AI usage efficiently for both Discord and in-game, with ability to create multiple groups with different limits including a global limits system to help manage overall usage.
- PlaceholderAPI & MiniMessage Support: Extend functionality with custom placeholders and rich formatting.
- Discord Integration: Seamless connection with your Discord community using JDA 5 (Java Discord API). Operates as a fully standalone bot without requiring additional plugins.
- Discord Interaction Logging: Tracks player AI interactions in a specified Discord Channel or Discord Webhook for easy moderation and review for both Minecraft and Discord.
- JSON Mode: Option to receive AI responses in JSON format to reduce unnecessary additional text.
- Advanced Role Management: Customize interactions with admin roles, bypass roles, and blocked roles for full control over bot usage.
- Asynchronous Performance: Runs completely asynchronously, ensuring minimal impact on server performance.
- And much more!
- Advanced Question Detection: Addon which includes a custom-trained model to detect questions more accurately, reducing false positives and false negatives.
- Diverse Providers & Models: Access additional AI services and models to tailor the AI capabilities to your server's needs.
- ServerAssistantAI API: Enables developers to integrate ServerAssistantAI's functionality into their own plugins or create custom addons, expanding the potential of AI-assisted server management.
| |
Test Server: test.code-solutions.dev (MC Versions: 1.16-1.21.4)
Minecraft Commands & Permissions:
| Command | Description | Permission | Default |
| /serverassistantai ask | Privately ask the AI a question. | serverassistantai.use | Player |
| /serverassistantai chat | Start a continuous private conversation mode with the AI. | serverassistantai.chat | Player |
| /serverassistantai usage | See amount of questions asked and left for the day in Minecraft. | serverassistantai.usage | Player |
| /serverassistantai toggle | Toggle automatically answering player’s questions in chat. | serverassistantai.toggle | Player |
| /serverassistantai reset | Resets a specific player's usage for the day. | serverassistantai.reset | OP |
| /serverassistantai reload | Reloads the plugin’s configuration files, and document if changed. | serverassistantai.reload | OP |
Aliases: /saai, /ai, /assistant
serverassistantai.use is also the permission used for allowing players to ask questions in the public in-game chat, which is given by default.
Other Permissions:
| Permission | Description |
| serverassistantai.group.<group> | Assign a player to a specific group for daily question limits. Replace <group> with the group name from config.yml. |
| serverassistantai.bypass | Bypass the daily player limits in-game. |
| serverassistantai.helpful-information | View in-game helpful messages within an AI response when helpful_information is enabled. |
| serverassistantai.updatecheck | Allows players to be notified about ServerAssistantAI updates. |
Discord Commands:
| Command | Description |
| /ai usage | See amount of questions asked and left for the day on Discord. |
| /ai toggle | Toggle automatically answering user's questions on Discord. |
| /ai reset | Resets a specific user's usage for the day on Discord. |
Discord Apps:
| App | Description |
| Ask AI | Right-click any message, select 'Apps' > 'Ask AI' for an AI response, even if it's not your own message. |
Optional Dependencies:
- PlaceholderAPI integration for custom placeholder support with various plugins.
ServerAssistantAI comes with a wide range of configurable options, allowing you to customize the AI's behavior, appearance, and performance to suit your server's specific needs. For detailed information on each configuration option and how to set them up, please view our comprehensive configuration guide on our Wiki.
Additionally, the entire configuration, including key files like messages.yml and interaction messages have been fully translated into more than 30 languages. These translations are available for download on our Crowdin project page, or on our Discord.
ServerAssistantAI supports a diverse range of AI Providers for both language models (LLMs) and embeddings, giving you the flexibility to choose the best option for your server's needs and budget.
Not sure which model to choose? Our Recommended Models wiki page offers guidance on selecting the most suitable embeddings and LLMs for your server based on performance and cost.
ServerAssistantAI supports a variety of addons that can be installed to enhance the plugin's functionality and improve the overall user experience.
ServerAssistantAI provides a powerful API for developers to integrate the AI assistant's functionality into their own plugins or applications as well as create Addons for ServerAssistantAI. To view examples of addons made with the API, check out our official open-source addons for ServerAssistantAI here.