NSR-AI 1.1

⚙ Core Capabilities

1. Multi-API Integration — Seamlessly switch between Gemini, Claude, and OpenAI APIs to find the perfect balance of speed, intelligence, and cost for your server.
2. Lightweight & Optimized — Designed for performance, NSR-AI has a minimal impact on your server's resources, with a JAR size of approximately 3MB.
3. 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.
4. API Key Rotation — Supports up to 20 API keys with automatic cycling to prevent rate-limiting and ensure high availability.
5. Persistent Knowledge Base — Teach the AI custom facts and information about your server that will be remembered across restarts.
6. Enhanced Error Handling — Clear and user-friendly error messages make it easy to diagnose and resolve any issues.
7. AI Self-Description — The AI can describe itself and its features to players on request.
8. Code Blocker — A security feature that prevents the AI from providing code snippets in its responses.

Addon Support

1. Extendable Architecture — The powerful addon system allows you to extend the functionality of NSR-AI with new features and commands.
2. Easy to Install — Simply drop the addon `.jar` file into the `addons` folder and restart the server.

✨ Major New Features in 1.1

1. Configuration Split: `config.yml` for core settings, and `features.yml` for all feature-related settings.
2. Advanced Memory & Caching System: A multi-layered system to manage conversation history with `/ai cache` and `/ai memory` commands.
3. Persistent Chat Logging: All conversations and summaries are automatically saved to disk.
4. Automatic Update Checker: The plugin automatically checks for new versions on startup.
5. New `/ai version` Command: View the current version and check for updates.
6. Granular Command Toggles: Enable or disable individual commands in `features.yml`.
7. Enhanced Knowledge Base:
   
   1. AI-powered heading generation for new entries.
   2. Improved search with relevance-based scoring.
   3. `/ai data all` to view all knowledge base entries.
   4. 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:

1. Backward compatibility for older NSR-AI versions.
2. Improved `/ai privacy` command.
3. 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

1. PlaceholderAPI: Allows you to use NSR-AI placeholders in other plugins.
2. NSR-AI-Advanced-Player-Stats (Addon): This addon is optional, but it provides the player stats, privacy, and AFK tracker features.

🎬 Video Demonstration
https://youtu.be/RUFdvojbQKw

Admin Commands

/ai admin  - Toggle admin mode.
/ai disable - Disable admin mode.
/ai add ,  - Add knowledge with AI-generated heading.
/ai remove  - Remove knowledge.
/ai confirm  or /ai confirm yes - Confirm actions.
/ai reload [config|features|knowledge|nsr-ai] - Reload parts of the plugin.
/ai cache  [player|all] - Manage session cache.
/ai memory  [player|all] - Manage AI-powered memory.

General Commands

/ai  - Chat with the AI.
/ai data  - Query the knowledge base.
/ai version or /ai v - Check plugin version.
/ai help - Show help message.

Permissions

nsr-ai.use    — Default: true
nsr-ai.admin   — Default: OP
nsr-ai.reload  — Default: OP

# Addon Permissions
nsr-ai.stats.view — Default: true
nsr-ai.stats.view.others — Default: true
nsr-ai.privacy — Default: true
nsr-ai.admin.privacy — Default: OP
nsr-ai.admin.privacy.bypass — Default: OP

Example Configuration -config.yml

# Main Plugin: config.yml
admin-activation-code: "3637"
default-gemini-model: "gemini-1.5-flash"
default-claude-model: "claude-3-opus-20240229"
default-openai-model: "gpt-4"
default-api-provider: "all"
api-keys: ["your_key_here"]

Example Configuration-features.yml

# 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

Directory Tree

plugins/
└── NSR-AI/
    ├── addons/
    ├── playerchathistory
    ├── adminchathistory
    ├── summarychat
    ├── config.yml
    ├── features.yml
    └── knowledge.yml