MC Versions: 1.16.5 – 1.21.4 •
JAR Size: 3.5 MB •
AI Models: Gemini, Claude, OpenAI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ Core Capabilities
Multi-API Integration — Seamlessly switch between Gemini, Claude, and OpenAI APIs to find the perfect balance of speed, intelligence, and cost for your server.
Lightweight & Optimized — Designed for performance, NSR-AI has a minimal impact on your server's resources, with a JAR size of approximately 3.5MB.
Custom Chat Presentation — Customize the look and feel of the AI's chat messages with configurable colors and prefixes for both regular and admin users.
API Key Rotation — Supports up to 20 API keys with automatic cycling to prevent rate-limiting and ensure high availability.
Persistent Knowledge Base — Teach the AI custom facts and information about your server that will be remembered across restarts.
Enhanced Error Handling — Clear and user-friendly error messages make it easy to diagnose and resolve any issues.
AI Self-Description — The AI can describe itself and its features to players on request.
Code Blocker — A security feature that prevents the AI from providing code snippets in its responses.
Addon Support
Extendable Architecture — The powerful addon system allows you to extend the functionality of NSR-AI with new features and commands.
Easy to Install — Simply drop the addon `.jar` file into the `addons` folder and restart the server.
✨ Major New Features in 1.1
Configuration Split: `config.yml` for core settings, and `features.yml` for all feature-related settings.
Advanced Memory & Caching System: A multi-layered system to manage conversation history with `/ai cache` and `/ai memory` commands.
Persistent Chat Logging: All conversations and summaries are automatically saved to disk.
Automatic Update Checker: The plugin automatically checks for new versions on startup.
New `/ai version` Command: View the current version and check for updates.
Granular Command Toggles: Enable or disable individual commands in `features.yml`.
Enhanced Knowledge Base:
AI-powered heading generation for new entries.
Improved search with relevance-based scoring.
`/ai data all` to view all knowledge base entries.
Configurable confirmation for adding entries.
Enhanced `/ai reload` Command: Granular reloading of configs, features, and the knowledge base.
New `/ai help` Command: A dynamic help message showing available commands.
Addon Enhancements:
Backward compatibility for older NSR-AI versions.
Improved `/ai privacy` command.
Detailed AFK time display in `/ai stats`.
Advanced Knowledge Base Search: More accurate and relevant search results with fuzzy search and weighted headings.
Optional Dependencies
PlaceholderAPI: Allows you to use NSR-AI placeholders in other plugins.
/ai <message> - Chat with the AI.
/ai data <query> - Query the knowledge base.
/ai version or /ai v - Check plugin version.
/ai help - Show help message.
Permissions
Code (Text):
nsr-ai.use — Default: true
nsr-ai.admin — Default: OP
nsr-ai.reload — Default: OP
# Features Plugin: features.yml
chat-colors:
ai: "&b"
user: "&7"
knowledge-base: "&a"
chat-prefixes:
ai: "&b[AI]"
user: "&7[You]"
admin-ai: "&c[AI]"
system-prompt: "You are a helpful AI assistant for a Minecraft server. Your answers should be concise and to the point. Prioritize answering questions about Minecraft. Do not provide code snippets or programming advice. If asked for code, respond with the configured message."
conversation-history-length: 10
code-blocker:
enabled: true
message: "&cThis is a game built for fun and answering, not for coding."
simple-knowledge-yml-approve: false
command-toggles:
data: true
admin: true
disable: true
version: true
add: true
add-confirm: true
remove: true
remove-confirm: true
memory-clear: true
memory-refresh: true
cache-clear: true
cache-refresh: true