⚙️ 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 3MB.

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.2-pre

🐾 Pet Emotional Communication System

• Pet Linking & Nicknames: Use the /ai pet tame command while looking at a tamed and named pet to link it to the AI. Give your pets a special nickname with /ai pet nickname <nickname>.
• Advanced AI-Powered Chat: Your pets now have their own AI-powered brain! They will respond to your messages with unique and in-character dialogue. A pet's mood and its bond with you will directly affect its personality. Every pet type has its own unique sound and set of emojis! Ask your pet "what is your mood" or "how are you feeling" to get a direct response about its current mood.
• New Commands:
  • /ai pet list: See a list of all your linked pets and their status.
  • /ai pet info <pet_name>: Get detailed information about a specific pet, including its mood, bond level, and more.
• Pet Lifecycle: Your pet now remembers when it was tamed and when it was linked to the AI. When a pet is low on health, it will say a heartfelt goodbye. When a pet dies, its link with the AI is broken.
• Ownership: Only a pet's true owner can chat with it and change its nickname.

🔑 Per-Player API Keys

• Bring Your Own Key: Players can now add their own API keys for Gemini, OpenAI, or Claude using the /ai apikey <key> command.
• Session-Based & Secure: Player-provided API keys are only valid for the current session and are never stored on the server. API keys are not visible to admins or in the console.
• Fallback System: If a player has not provided their own API key, the server's global API key will be used as a fallback.
• New Commands:
  • /ai apikey(then paste the api key in the chat): Add a temporary API key for your session.
  • /ai apikey list: View your active session keys (masked for security).
  • /ai apikey clear: Remove all your active session keys.

🛡️ Automatic Security & Bug Fixer Downloader

• Automatic Security Updates: The plugin periodically checks for updates to its security module. If a new version is available, it will be automatically downloaded and reloaded.
• Automated Bug Fixes: The plugin also periodically checks for critical bug fixes for the main plugin. If a new bug fix is available, it will be automatically downloaded.
• Intelligent Version Tracking: A dedicated bug.txt file tracks the installed bug-fix version.
• Server Restart for Main Plugin Updates: For bug fixes that involve changes to the main plugin's core code, a server restart will be required to fully apply the update.
• Transparent Logging: The system provides clear log messages in your server console, informing you about update checks, downloads, and when a restart is required.

🔗 Optional Dependencies

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

🎬 Video Demonstration

🎬 Video Demonstration of the 1.2-pre

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

General Commands

/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.
/ai pet tame - Link a named pet to the AI.
/ai pet nickname <nickname> - Give your linked pet a unique nickname.
/ai pet list - See a list of all your linked pets and their status.
/ai pet info <pet_name> - Get detailed information about a specific pet.
/ai apikey - type the api key in the chat then it Add a temporary API key for your session.
/ai apikey list - View your active session keys (masked for security).
/ai apikey clear - Remove all your active session keys.

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

# 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"]

# 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 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

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