NSR-AI

# <center>⚡︎ New Server Runtime – Artificial Intelligence ⚡︎</center> <center><b>“The AI Layer for Minecraft Servers.”</b></center> --- **✔ Multi-API** • **✔ RAG Knowledge** • **✔ Simple & Powerful** • **✔ Highly Customizable** • **✔ Minimal Lag** **MC Versions:** 1.16.x – 1.26.x • **JAR Size:** 3.5 MB • **AI Models:** Gemini, Claude, OpenAI • **Highly Optimized** --- ## &#x1F310;&#xFE0E; What is NSR-AI? NSR-AI (New Server Runtime – Artificial Intelligence) is a high-performance Minecraft AI plugin that acts as intelligent middleware bridging the gap between advanced Large Language Models and the Minecraft server environment. It is more than a simple chat tool; it is an intelligent ecosystem that weaves AI into the very fabric of your world—from automated staff support to emotionally intelligent companions. ## &#x1F680;&#xFE0E; Why Choose NSR-AI? - **Multi-API Sovereignty** — You are never locked into one provider. Switch between `Gemini`, `Claude`, and `OpenAI` in real-time. - **Uncompromising Security** — With our `Triple-Layer Encryption` (AES-256-GCM), your API keys are mathematically locked to your server and player UUIDs. - **High-Performance Intelligence** — Built on an entirely `Asynchronous Pipeline`, NSR-AI has `very minimal impact` on your server's TPS. - **Adaptive Narrative Memory** — Through `Memory Distillation`, your AI remembers your history, your server’s lore, and your players' names. ## &#x1F6E0;&#xFE0E; The Hybrid Intelligence Engine NSR-AI serves as a multi-role digital infrastructure for your server: 1. **24/7 Intelligent Support Agent:** Uses **RAG (Retrieval Augmented Generation)** to provide exact answers from your `knowledge.json` base, acting as a perfect staff assistant. 2. **Emotional Gameplay Companion:** Powering the **Pet Emotional System** with unique moods (`HAPPY`, `FURIOUS`, `TIRED`), bond levels, and unique relationships. 3. **Dynamic Content Generator:** Generates immersive lore-friendly quest descriptions and dialogue that adapt to each player's specific journey. 4. **Privacy-First Player Utility:** Allows players to bring their own keys, manage private "checkpoints," and control their own AI environment. 5. **Zero-Stall Architecture:** Handles complex AI logic in the background, keeping the server's heartbeat at a perfect 20.0 TPS. 6. **Extensible Developer Framework:** A foundation for growth with a robust **(https://github.com/BlackForgeOfficial/NSR-AI-API)** via the `/aia` command portal. ## &#x1F6E1;&#xFE0E; Technical Deep Dives - **Zero-Knowledge Security Standard:** Uses three-layer authenticated encryption (`AES-256-GCM`). Even if your files are stolen, your API keys remain unreadable to anyone else. Filesystem permissions are restricted to owner-only read/write. - **Context-Aware Memory Distillation:** Instead of forgetting, the AI "writes a diary" of your conversation. It summarizes history into a single memory message to keep context alive for thousands of messages. - **Staff-Free Knowledge Logic (RAG):** Turn your `knowledge.json` into a living database. The system extracts the "intent" of questions to provide the AI with factual "Cheat Sheets," preventing hallucinations. - **Self-Healing Infrastructure:** An automated background system monitors for bugs and applies security patches silently. If one AI provider fails, the system can automatically cycle to a fallback provider. --- ## &#x2699;&#xFE0E; Core Capabilities - **Zero-Lag Asynchronous AI Engine** — Completely decoupled from the Minecraft main thread, NSR-AI 1.5 ensures your server maintains 20 TPS even during heavy AI processing. - **Privacy & Anonymization Layer** — A robust, opt-in privacy system (`/ai opt in`) that masks player names and IPs before they reach external AI providers. - **Developer API & Interceptors** — Advanced API allowing addons to intercept and modify player input or AI responses in real-time. - **Multi-API Integration & Provider Detection** — Seamlessly switch between `Gemini`, `Claude`, and `OpenAI`. The system features `Automatic Provider Detection` for a zero-config setup. - **Smooth API Key Rotation & Load Balancing** — Cycle through up to `20 keys` automatically. If a key hits a rate limit, the system intelligently falls back to the next key for zero downtime. - **Triple-Layer Security Architecture** — API keys are protected by `AES-256-GCM` encryption across the `Server Master Key`, the `Player Master Key`, and the `Project Key`. - **Advanced Knowledge System (RAG)** — Uses `Retrieval Augmented Generation` and Hybrid Intent Recognition to find precise answers from your lore and facts. - **AI Pet Emotional System** — Tame and link pets with unique personalities, moods, and inventories. Includes a secure system to share pet access with friends. - **Advanced Memory & Context Awareness** — Features AI-powered `Summarization` and real-time `Context Tracking` to keep conversations coherent without lag. - **Master Ch