NSR-AI

NSR-AI v1.4 — The Developer Empowerment Update

Plugin Version: 1.4  |  API Version: 3.0-pre  | 

NSR-AI v1.4 is the most significant update for developers and server owners to date. This release transforms NSR-AI from a standalone tool into a full-fledged Development Platform — featuring a completely rebuilt programmatic API, granular AI controls, a powerful chat interception layer, and deep stability hardening across every system in the codebase. Whether you're a server admin who wants plug-and-play reliability, or a developer building on top of NSR-AI, this update delivers. ---

Quick Summary

| Area | What's New | |---|---| | New Features | Privacy system, Pet API, session control, command routing, middleware, and more | | Bug Fixes | Several critical, security, pet, and engine stability fixes | | Optimization | Major RAM reduction, CPU hardening, and full codebase consolidation | | Developer API | Builder-pattern registration, async futures, interceptors, RAG access | ---

Jump To Section

[ New Features](#-new-features)  ·  [ Bug Fixes & Stability](#-bug-fixes--stability)  ·  [ Performance & Optimization](#-performance--optimization)  ·  [ Developer API](#-developer-api) ---

New Features

Asynchronous High Performance

NSR-AI v1.4 completely decouples the AI engine from the Minecraft main thread, keeping your server running smoothly at all times. - Zero-Lag AI Requests: askAI and sendMsg now run entirely in the background — your server stays at 20 TPS even during complex AI reasoning. - Async Persistence: Saving AI logs via SaveMsg or updating the Knowledge Base no longer causes disk lag or server hiccups. - Future-Ready API: All critical paths now use CompletableFuture, giving developers precise control over when to handle AI responses without blocking the game thread. ---

Chat Interception System (Middleware)

NSR-AI 1.4 introduces a powerful Interceptor System that allows addons to sit between the player and the AI, enabling custom processing at every stage of a conversation. #### Middleware Capabilities Addons can now register an AIInterceptor to: - Read & Edit Player Input — Modify what the player says before it reaches the AI. - Read & Edit AI Response — Transform the AI's answer (e.g. add branding or filter content) before the player sees it. - Cancel Interactions — Block specific inputs or responses based on custom logic (e.g. filtering bad words or enforcing game rules). #### Knowledge Base Bridge (RAG Access) - Programmatic Access: Addons can now query and mutate the knowledge.yml store directly. - Hierarchical Permissions: read-knowledge and edit-knowledge nodes control access globally and per-addon. - Addon Identification: The core plugin now uses stack-trace analysis to verify which addon is making an API call, preventing unauthorized knowledge tampering. #### Smart System Prompt Injection - Core Context Extension: Addons can use the onSystemPrompt interceptor to append dynamic instructions to the /ai global system prompt. - API Isolation: When an addon calls askAI or sendMsg, the core NSR-AI system prompt is bypassed, allowing the addon to supply its own pure system instructions. #### Universal Command Routing (/aia) - Addon Namespace: Commands are now routed via /aia <AddonName>, keeping /ai exclusively for core features. - Tab Completion Delegation: The core plugin handles the first argument (addon list) and then delegates all subsequent arguments and tab suggestions to the target addon. - SimpleAddon Builder: Enhanced to support .onTabCompleteHandler() for rapid development. #### Integrated Pet System API - AIPet Data Model: Addons can now programmatically access pet details (Name, Mood, Bond, Level, Hunger, etc.). - Dynamic Manipulation: New API methods allow addons to change a pet's mood, bond, or level on the fly — perfect for RPG or training addons. - Status Interrogation: Fetch a list of all pets owned by a player to display in custom GUIs or menus. ---

Advanced Permission Architecture

With great power comes great responsibility. NSR-AI 1.4 adds a multi-layered permission system to keep your server secure. - Global Master Switch: A central permissions.yml allows admins to disable chat reading or editing for all addons at once. - Automatic Per-Addon Folders: NSR-AI automatically creates a dedicated folder and permissions.yml for every registered addon. - Granular Permissions: Control exactly what each addon can do — read-player-input, edit-ai-response, cancel-player-input, and more. ---

Smart AI Routing

The internal engine has been upgraded with intelligent routing logic that handles multi-provider setups seamlessly. - Provider Sovereignty: Automatically detects whether a key is Gemini, Claude, or OpenAI and formats the request perfectly for each provider. - Dual-Mode Intelligence: Automatically switches between Player API keys and Global Fallback keys based on developer requirements. - Thread-Safe Memory: Shared memory and conversation histories are now handled with full thread-safety, ensuring data integrity during async operations. ---

Advanced Session & Memory Control

Developers now have granular control over how the AI remembers and forgets across conversations. - Summarize Chats: Compress long conversations into a summary that the AI retains in its memory. - Cache Refresh / Clear: Manually reload a conversation session from disk or wipe it entirely for a fresh "clean slate." - Memory Access: Programmatically read, update, or clear the AI's long-term summaries for each player. - Shared Memory Store: A global key-value store that allows different addons to share context with each other. ---

Flexible Component Reloading

You no longer have to reload the entire plugin for a small change. The new API supports targeted reloads for any component: | Mode | What It Reloads | |---|---| | FULL | Everything | | CONFIG | config.yml only | | KNOWLEDGE | RAG knowledge base only | | FEATURES | Feature toggles only | ---

Dynamic Model & Provider Control

Take full control over the AI engine programmatically, without ever restarting the server. - Global Swapping: Change the server's default model or API provider (Gemini, OpenAI, Claude) on the fly via the API. - Per-Request Overrides: Addons can specify a different model or provider for a specific request without affecting global settings — perfect for complex tasks that require a "Pro" model. ---

Structured Addon Command Aliases

NSR-AI 1.4 overhauls how addons integrate commands into the server, providing a clean, collision-free namespace. - Dedicated Namespace: Addons use /aia, leaving /ai exclusively for core plugin features. - Custom Aliases: Every addon can define a short "Main Command" alias (e.g. /aia aps). - Deep Tab Completion: Addon aliases are automatically suggested, and sub-commands are fetched directly from the addon for a professional, native feel. - Collision-Free Routing: Commands are routed based on aliases, preventing multiple addons from conflicting with each other. ---

Privacy & Anonymization (Opt-In / Opt-Out)

NSR-AI 1.4 introduces a robust privacy layer that gives players full control over their data. - Privacy Mode (Opt-In): Players can use /ai opt in to enable maximum privacy. This swaps sensitive information (like Player Names and IPs) with random codes (e.g. PlayerName → R2d13n) before sending data to the AI. It also blocks all addon and plugin access to the player's chat, preventing any middleware from reading or editing their AI interactions. - Normal Mode (Opt-Out — Default): By default, NSR-AI uses real names and allows registe

NSR-AI 1.3: The Hybrid Intelligence Engine – Technical Briefing

Welcome to the next evolution of server-side intelligence. NSR-AI v1.3 is a high-performance middleware architecture designed to bridge the gap between advanced Large Language Models (LLMs) and the Minecraft environment. This update is not just a feature drop; it is a fundamental shift toward precision control, latency masking, and adaptive memory engineering. ---

The Interactive Control Pipeline

We have re-engineered the communication layer to give you granular control over the AI's generation stream.

1. Granular Generation Controls

- 🛑 [Stop] — Interrupt Display Stream: Immediately "mutes" the AI's current message. Perfect for when you need to pivot your query or handle a sudden in-game threat. Technical Detail: Note that clicking `[Stop]` interrupts the display stream only. Because the request has already been sent to the API provider, tokens are still consumed.* Think of it like canceling a broadcast; the signal was already sent, you just stopped listening. - ✍️ [Edit] — Prompt Refinement: Mistyped a command? The [Edit] button acts as a "Time Machine." It instantly pulls your last message back into your chat bar so you can fix typos or tweak your instructions without retyping the whole paragraph. - 🔄 [Regenerate] — Multi-Mode Divergence: If the AI didn't quite get it right, don't retype. Just hit [Regenerate] and choose a new "Brain Mode": Detailed, Simple, Default, Creative, or Concise. The AI will try again with a different perspective.

2. Fact-Checking & Knowledge (RAG)

Say goodbye to AI "hallucinations" (when AI makes things up). - The "Cheat Sheet" System: Using Retrieval Augmented Generation (RAG), the AI reads your knowledge.yml file before it speaks. It extracts facts about your server lore, rules, or shop prices and uses them as a "cheat sheet" to give 100% accurate answers. ---

Advanced Conversation Chronicles: /ai chat

Your interactions are more than just text—they are serialized data structures that define your server's lore. - Persistent State Management: Use /ai chat save <name> to immortalize complex role-play narratives. This saves the AI's current memory state, not just the text. - The Checkpoint System: Like a save-game in an RPG, the Checkpoint System (/ai chat resume) lets you jump back to a previous part of the conversation. If a narrative goes wrong, you can "rewind" to a specific checkpoint and try a different path. ---

Adaptive Context & Memory Distillation

We have moved beyond primitive history limits. The AI now manages its own "attention span" to stay sharp. - Context Meter (The HUD): You can see exactly how much the AI remembers via a percentage meter (e.g., Context: 24%). - Memory Distillation (Auto-Summary): As the chat gets too long, the AI doesn't just forget; it "writes a summary" of the past. It turns 50 messages of history into 1 concise "Diary Entry." This keeps the AI smart for thousands of messages without causing lag. - The Efficiency Edge (Tokens, Time & Cost): - Token & Cost Optimization: By distilling thousands of words into compact summaries, we drastically reduce the "payload" sent to the API. You only pay for the essential context, not redundant history, significantly cutting your API costs. - Ultra-Fast Processing: Smaller, distilled contexts are processed much faster by AI providers. This reduces the "Thinking" time, delivering answers to your chat in record time. - Peak Accuracy: Distillation removes the "noise" of old, irrelevant chat data. This prevents the AI from getting confused by outdated topics, ensuring every answer is sharp, factual, and hyper-relevant to the current conversation. - Multi-API Sovereignty: You are never locked into one brain. Switch between Gemini, Claude, and OpenAI in real-time. If one key hits a limit, the system can automatically cycle to a fallback key for zero downtime. ---

The Unified Add-on Portal: /aia

NSR-AI 1.3 functions as a Micro-Kernel platform. The core handles the intelligence, while the extensions handle the gameplay mechanics. - Standardized Extension API: The /aia command portal is your "Control Center." Manage all modular add-ons like AFK Trackers, Player Stats, or Economy Bridges from one place. - Ecosystem Integrity: Check versions, verify authors, and manage technical health through a single, clean command structure. --- Powering your world with intelligence that is Complex Inside, Simple Outside. Unmatched Power. Zero-Lag Performance. Hardened Security. Effortless Control. NSR-AI 1.3: Elevate Your Protocol.

NSR-AI v1.2.1 Patch Update Critical Hotfix for AI Response & Message Sender Module A new maintenance release is rolling out: NSR-AI 1.2.1. This patch delivers major stability improvements by fixing two core issues inside the nsr-ai-api layer: Fixed Issues 1. AI Response Handler Bug Some users on v1.2 experienced delayed or incomplete AI replies. This has been fully resolved with optimized pipeline handling. 2. AI Message Sender Error Outgoing AI messages were failing under certain player data states. This patch stabilizes the message dispatch flow for all players. Auto-Update Policy (Important) Players currently on NSR-AI v1.2 will receive an automatic bug-fix update to v1.2.1. This is a targeted patch. Auto-update applies ONLY to v1.2 users. Earlier versions remain unaffected, as the bug existed exclusively in the 1.2 build. Stability Boost. Cleaner Logs. Smoother AI. NSR-AI 1.2.1 ensures a more reliable in-game AI experience, sharper message delivery, and fewer interruptions. Your server AI just leveled up. Powering your world with smarter gameplay.

NSR-AI v1.2: Enhanced Pet System, API Key Management & Open-Source Addon Platform

Welcome to a smarter, more resilient NSR-AI! This update introduces a highly advanced API Key Management system, designed for ultimate control, security, and flexibility, alongside the groundbreaking NSR-AI Open-Source Addon API and significant enhancements to the Pet System.

Core Improvements

The entire API key, pet, API, and configuration systems have been thoroughly modified to enhance security, efficiency, and speed. Unmatched Security:* Stored keys are protected with military-grade AES-256-GCM encryption, salted with your unique player data. Player Empowerment:* You have full control over your own keys directly in-game, reducing reliance on server admins. Enhanced Reliability:* The intelligent rotation and fallback system ensures a much smoother and more reliable AI chat experience. Simplified Error Messages:* All API key errors now use a clear three-part format: Error [Code]: [Name]. Suggestion: [Fix]. Player-specific errors are shown only in-game, keeping the console clean. Enhanced Help Command:* The /ai help command now provides detailed descriptions for all commands and subcommands, making it easier for users to understand plugin functionalities.

New Features & Major Enhancements

Advanced API Key Manager

The entire key system has been rebuilt from the ground up, now consolidated under the powerful /ai apikey command. #### Refined API Key Entry Workflow When you type /ai apikey, you will now see these instructions: To add a session-based key (temporary):* Directly paste your API key in chat. To store an existing session-based key (permanent):* Type /ai apikey store <projectId>. This command will convert your most recently added session key into a permanent stored key, associating it with the provided <projectId>. To store a new API key from scratch (permanent):* First type /ai apikey, then type store-<your_api_key>. The system will automatically generate a unique Project ID for it. #### Intelligent Key Rotation & Fallback NSR-AI now automatically rotates through your available API keys for each request. This distributes the load and maximizes uptime. Automatic Fallback:* If a key is busy, rate-limited, or hits an error, the system automatically tries the next available key in your list, ensuring your conversation continues seamlessly. #### Detailed Key Status & Statistics Use /ai apikey info <key-id> to see a detailed breakdown of your key's performance. Key Status Glossary:* 🟢 Active (`ACTIVE`):* The key is valid and ready, waiting in the wings. 🟠 Using (`USING`):* This is the key currently processing your AI requests. 🟡 Overloaded (`OVERLOADED`):* The key is temporarily rate-limited. The system will automatically skip it and try again later. 🚫 Limit Reached (`LIMIT_REACHED`):* The key has hit a hard usage limit (e.g., daily/monthly quota) and will be skipped until the quota resets. 🔴 Inactive (`INACTIVE`):* The key is invalid or has an error (e.g., wrong model, or other error ). It will not be used until it is changed to the active through timer reset. Statistics Glossary:* Uses:* The total number of successful AI responses this key has delivered. Errors:* How many times the key has failed (e.g., other API errors). Fallbacks: The number of times the key had to switch from* this key to another one because of an error and also includes the due to rate limits. #### Manual Overload Timer Removal A new command has been added to manually clear the overloaded status of an API key. Command:* /ai apikey timer <key-id> remove Functionality:* This command allows administrators to immediately remove the rate-limited or overloaded status from a specific API key (either player-specific or global). This is useful if an API provider issue has been resolved, and you wish to re-enable the key before its natural cooldown period expires. Permissions:* This command requires player permissions. #### API Key Deletion A new command allows for the removal of unwanted or corrupted API keys. Command:* /ai apikey clear <all|projectId> Functionality:* This command enables you to delete specific API keys by their projectId or clear all your API keys. This is particularly useful for removing corrupted, expired, or unused keys, helping to maintain a clean and efficient API key management system. Permissions:* Requires players permissions to manage API keys. #### Automatic Provider Detection When you add a key, NSR-AI instantly detects the provider (Google, Anthropic, OpenAI) and assigns a suitable default model, streamlining the setup process. #### Per-Player Fallback System - You can now control whether the plugin uses server keys if your personal key fails. - Command: /ai apikey fallback global <true|false> - Default: false. The plugin will stop if your key fails. - Tab Completion: This new command has full tab-completion for ease of use.

Enhanced Chat and Logging

#### Chat History Saving Preference Players now have granular control over whether their AI chat conversations are saved to the plugin's logs. Command:* /ai apikey msg save <true|false> Functionality: This command allows a player to enable or disable the saving of their AI chat history for their active* API key. * If set to true, chat messages (excluding API key entry messages) will be logged. If set to `false`, chat messages will not* be logged. Default:* false (chat history saving is disabled by default for enhanced privacy). #### Enhanced Chat Logging and Session Management The plugin now features a robust chat logging system designed for clarity, organization, and session tracking. Dedicated Log Folders:* Player and admin chat histories are stored in separate, dedicated folders (playerchathistory and adminchathistory) within the plugin's data directory. Daily Log Rotation:* A new log file is automatically created for each day, ensuring logs are easy to navigate and manage. Files are named chat-MM-dd-yyyy.log. Intelligent Session Tracking:* * If a player disconnects and reconnects within 5 minutes, their chat continues to be logged in the same daily log file. * If a player reconnects after more than 5 minutes, or on a new day, a new session-specific log file is created. These files are appended with a numerical suffix (e.g., chat-MM-dd-yyyy-1.log, chat-MM-dd-yyyy-2.log), providing clear separation of chat sessions. In-Game Color Preservation:* Chat logs accurately preserve the in-game color formatting, making them easier to read and review. API Key Exclusion:* All API keys (global and player-specific) and direct API key entry messages (store-<your_api_key>) are strictly excluded from all chat logs to ensure maximum security and prevent sensitive information leakage. Pet Chat Logging (Optional):* Chat interactions with pets can also be logged in a dedicated pet folder under the player's name (if enabled).

Security and Error Handling

#### Enhanced Security While API keys are entered via chat, the plugin now employs advanced filtering to ensure that messages containing API keys (both global and player-specific) or those used for direct API key storage (store-<your_api_key>) are never written to the plugin's chat history logs. This provides an additional layer of security, preventing sensitive information from being inadvertently recorded. #### Error Message Philosophy - For Player Keys: Error messages for a player's personal key are inbuilt (hardcoded) and are only shown to the player in-game. The console remains clean. This is for security and privacy, as server owners do

NSR-AI v1.2-pre - Pet Emotional Communication System!

Get ready to connect with your beloved Minecraft pets like never before! Version 1.2 of NSR-AI introduces the Pet Emotional Communication System, a revolutionary feature that brings your tamed companions to life with unique personalities, moods, and the ability to chat with you. ---

Pet System

Pet Linking & Nicknames

Link Your Pets:* Use the /ai pet tame command while looking at a tamed and named pet to link it to the AI. This will allow your pet to start communicating with you. Unique Nicknames:* Give your pets a special nickname with /ai pet nickname <nickname>. Each pet's nickname must be unique!

Advanced AI-Powered Chat

Real Conversations:* Your pets now have their own AI-powered brain! They will respond to your messages with unique and in-character dialogue. Emotional Intelligence:* A pet's mood and its bond with you will directly affect its personality. A happy pet with a strong bond will be affectionate and playful, while a neglected pet might be cold and distant. Species-Specific Identity:* Every pet type has its own unique sound and set of emojis! Wolves will "woof," cats will "meow," and their messages will be full of personality. Check Your Pet's Mood:* 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

Tamed & Linked Dates:* Your pet now remembers when it was tamed and when it was linked to the AI. Ask them about it! A Pet's Farewell:* When a pet is low on health, it will say a heartfelt goodbye. When a pet dies, its link with the AI is broken. If you try to talk to a pet that has passed away, it will respond with a special message.

Ownership

A Special Bond:* Only a pet's true owner can chat with it and change its nickname. Any other player who tries to interact with your pet will be ignored or receive a cold shoulder. ---

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 command. Session-Based:* Player-provided API keys are only valid for the current session and are never stored on the server. Secure:* 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 type the key in the chat to 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. ---

How to Get Started

1. Tame a Pet: Tame a wolf, cat, or any other supported animal in Minecraft. 2. Give it a Name: Use a nametag to give your new companion a name. 3. Link to the AI: Look at your pet and type /ai pet tame. 4. Give it a Nickname: Use /ai pet nickname <nickname> to give your pet a unique nickname. 5. Start Chatting! Mention your pet's name or nickname in the chat to start a conversation. We are incredibly excited for you to try out the new Pet Emotional Communication System and form a deeper bond with your furry (and feathery) friends! ---

Automatic Security & Bug Fixer Downloader

NSR-AI now includes a robust, automated system to keep your plugin secure and up-to-date with the latest bug fixes. This system operates silently in the background, ensuring your server benefits from continuous improvements and protection without manual intervention for updates.

How it Works:

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, ensuring your server always has the latest protections. 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, preventing redundant downloads and ensuring efficient updates. 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. The plugin will clearly notify you in the console when a restart is needed. Transparent Logging:* The system provides clear log messages in your server console, informing you about update checks, downloads, and when a restart is required. This ensures your NSR-AI experience is always stable, secure, and running the latest enhancements.

NSR-AI v1.1 - Comprehensive Update

This update introduces significant improvements to configuration management, and a powerful, multi-layered system for handling conversation history, designed for optimal performance and user control. ---

Configuration Split

For better organization and easier management, the plugin's configuration has been split into two distinct files: `config.yml`*: This file now contains the core settings for the plugin, such as: * Admin activation code * Default AI models (Gemini, Claude, OpenAI) * Default API provider * API keys `features.yml`*: This new file contains all feature-related settings, including: * Chat colors for the AI and users * Customizable messages for various events (e.g., API errors, permission denied) * The system prompt for the AI * Conversation history length * Chat prefixes for AI and users * Code blocker settings ---

Advanced Memory & Caching System

This system provides granular control over conversation history, balancing AI context with server performance. #### 1. Simple Session Caching (`/ai cache`) These commands offer quick control over a player's active chat session without involving AI processing. They are ideal for fast resets. `/ai cache clear`* Action:* Instantly clears the AI's short-term memory for the specified target. Result:* The next message will start a completely fresh conversation. Usage:* Player:* /ai cache clear (Clears your own session) Admin:* /ai cache clear <playername> (Clears a specific player's session) Admin:* /ai cache clear all (Clears all online players' sessions) `/ai cache refresh`* Action:* Reloads the most recent conversation from the long-term log files back into the AI's short-term memory for the specified target. Result:* Allows continuation of a conversation that was previously cleared. Usage:* Player:* /ai cache refresh (Reloads your own session) Admin:* /ai cache refresh <playername> (Reloads a specific player's session) Admin:* /ai cache refresh all (Reloads all online players' sessions) #### 2. AI-Powered Memory (`/ai memory`) This advanced feature uses AI to summarize and compress long conversations, enabling a nearly infinite memory while optimizing resource usage. `/ai memory clear` (Summarize and End Session)* Action:* The AI summarizes the current conversation history, and then the session is ended. Process:* The generated summary is saved to summarieschat/. If an old summary existed, it's archived into the main chat log. The AI's short-term memory is then cleared. Use Case:* To "bank" important information from a conversation as a summary before starting a new topic. Usage:* Player:* /ai memory clear (Summarizes and ends your own session) Admin:* /ai memory clear <playername> (Summarizes and ends a specific player's session) Admin:* /ai memory clear all (Summarizes and ends all online players' sessions) `/ai memory refresh` (Summarize and Continue Session)* Action:* The AI summarizes the current conversation history, and then replaces the detailed history with the summary, allowing the conversation to continue. Process:* The AI's short-term memory is replaced with a single system message containing the new summary. Result:* This frees up memory while allowing the AI to "remember" the context of the prior conversation in a compressed form, enabling very long and detailed interactions. Use Case:* To optimize memory during long, complex conversations without losing context. Usage:* Player:* /ai memory refresh (Summarizes and continues your own session) Admin:* /ai memory refresh <playername> (Summarizes and continues a specific player's session) Admin:* /ai memory refresh all (Summarizes and continues all online players' sessions) Important Notes on AI-Powered Memory: API Usage:* These commands will make calls to the AI API for summarization, incurring usage costs. Time:* Summarization is a complex task and may take a few moments to complete. These operations are asynchronous to prevent server lag. ---

Persistent Chat Logging

All conversations and generated summaries are automatically saved to disk, ensuring no chat history is lost. This process is asynchronous to maintain high server performance. Log Locations:* * Regular chats: plugins/NSR-AI/playerchatshistory/ * Admin-mode chats: plugins/NSR-AI/adminchatshistory/ * Latest summaries: plugins/NSR-AI/summarychat/ ---

Permissions

Player Commands:* Any player can use /ai cache clear/refresh and /ai memory clear/refresh for themselves. Admin Commands:* Commands targeting other players or all require the user to be in admin mode.

New Features Added to NSR-AI Plugin

This update introduces several enhancements to the NSR-AI plugin, focusing on improved user experience and maintainability: Automatic Update Checker:* The plugin now includes an integrated update checker that automatically verifies if you are running the latest version upon startup. This helps ensure you always have access to the newest features and bug fixes. New In-Game Version Command:* A new command, /ai version (or /ai v), has been added. Players can use this command to: * View the current version of the plugin. * See if their plugin is up-to-date or if a newer version is available. * Access a list of features included in the latest available version. Outdated Version Notifications:* If your plugin is outdated, the server console will display a clear notification. Additionally, administrators will receive in-game messages with direct links to download the latest version from official platforms like Modrinth, SpigotMC, and Polymart. Cloudflare Worker Integration:* The update checking mechanism is powered by a Cloudflare Worker, ensuring efficient and reliable version verification. Enhanced Plugin Startup Message:* The plugin now features a more visually engaging startup message in the server console, presenting the plugin's name, version, and developer information in a clear and formatted manner.

Recent Feature Enhancements

This section outlines the latest additions and improvements to the NSR-AI plugin: Enhanced Command Set:* `/ai admin <activation_code>`:* A fully functional command to toggle administrator mode, allowing access to privileged commands. `/ai data <query>`:* This command now specifically queries the local knowledge base for answers, reducing reliance on external AI APIs for known information. `/ai add <keyword> <heading> <response>`:* Allows administrators to add new entries to the plugin's knowledge base directly in-game. `/ai remove <keyword>`:* Allows administrators to remove entries from the knowledge base directly in-game. `/ai reload`:* Enables administrators to reload the plugin's configuration without restarting the server. API Load Reduction:* Implemented a strategy to prioritize responses from the local knowledge base for /ai data commands, significantly reducing calls to external AI APIs and minimizing the "model overloaded" issues. Improved Plugin Lifecycle Messages:* The onDisable() message in the server console now provides more informative feedback, indicating whether the plugin disabled gracefully or due to errors. Enhanced `/ai add` command:* * New command structure: /ai add <keyword>, <message_content> * AI-generated headings for knowledge base entries b