⚡︎ New Server Runtime – Artificial Intelligence ⚡︎

“The AI Layer for Minecraft Servers.”

✔ 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

🌐︎ 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.

🚀︎ 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.

🛠︎ The Hybrid Intelligence Engine

NSR-AI serves as a multi-role digital infrastructure for your server:

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.
Emotional Gameplay Companion: Powering the Pet Emotional System with unique moods (HAPPY, FURIOUS, TIRED), bond levels, and unique relationships.
Dynamic Content Generator: Generates immersive lore-friendly quest descriptions and dialogue that adapt to each player's specific journey.
Privacy-First Player Utility: Allows players to bring their own keys, manage private "checkpoints," and control their own AI environment.
Zero-Stall Architecture: Handles complex AI logic in the background, keeping the server's heartbeat at a perfect 20.0 TPS.
Extensible Developer Framework: A foundation for growth with a robust Open-Source Addon API via the /aia command portal.

🛡︎ 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.

⚙︎ 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 Chat Management — Take complete control of your dialogue history. Save, resume, or delete conversations using /ai chat with Asynchronous Persistent Logging.
Professional Admin Mode — Access advanced management tools through a secure code. Deactivate instantly by sneaking in-game or using the dedicated command.
Automatic Configuration Encryption — Any plain-text keys added to config.yml are automatically encrypted the moment the plugin reloads, preventing plain-text leaks.
User-Friendly Error Handling — Receive clear error messages with actionable solutions (e.g., Invalid Model - Suggestion: Use a valid model name) to fix issues instantly.
Proactive Maintenance & Auto-Fixer — An automated system that monitors, downloads, and applies critical Security Patches and Bug Fixes to keep your server stable.
Unified Add-on System (/aia) — A standardized modular framework where every extension like Player Stats or AFK Tracker is managed through the /aia command portal.
Sleek UI/UX & AI Awareness — A professional Cyber-Console interface with interactive [Stop], [Edit], and [Regenerate] buttons and animated status indicators.

🚀 What's New in 1.5

Definitive Gold Standard Optimization ⚡ — Massive reduction in object allocations and CPU hotpath churn. Replaced all legacy formatters with thread-safe modern Java DateTimeFormatter and pre-compiled regex matching patterns to guarantee lag-free execution.
Dual Management Architecture 🛡️ — Rebuilt the command routing to separate internal addons (/aia addon showing active, error, banned status) and external API hook integrations (/aia plugin showing author, version, description).
Human-Resonant In-build System Prompts 🤖 — Fully integrated an ecosystem-aware main system prompt containing details of all active plugin components (keys, RAG, memory, pets) with built-in anti-override security guards to block malicious prompt injections.
Open-Source API 3.5 Upgrade 📦 — Moved legacy classes to a dedicated V1 package, keeping the root API clean. Added dynamic pet stat manipulation (Mood, Bond, Hunger, Level, Health), async chat interceptors (Addon API), async error catchers, and a live memory bridge for RAG updates.
Provider-Specific Hardening 🔌 — Re-coded the Claude system role integration to respect Anthropic API specs and added mandatory candidate presence checks to prevent Gemini JSON format errors.
Security & Privacy Hardening 🔒 — Secured the chat-based key entry process to prevent keys from leaking to the console or log files. Enforced owner-only OS file permissions for server encryption keys, salt, and secrets, and transitioned the user cache to a bounded thread-safe LRU structure.

🚀︎ How to Setup

Download: Get the latest stable version of NSR-AI.
Install: Place the downloaded .jar file into your server's /plugins folder.
Configure: Start your server once to generate the files. Then, open config.yml located in the /plugins/NSR-AI/ folder and add your API key to the api-keys list.
Reload & Go: Start or reload your server. You're all set!

🔥 The BlackForge Studio AI Ecosystem Combo 🚀

Turn your server into an interactive, breathing, and responsive world with our three-part AI Ecosystem Combo. These plugins work hand-in-hand to create an unparalleled gameplay experience:

NSR-AI Core Engine: The foundation and brain of the server. A high-performance, asynchronous, multi-API Minecraft AI plugin featuring triple-layer encryption, memory distillation, and RAG knowledge base.
Advanced Player Stats 3.0 (APS): A standalone analytics engine that hooks into the NSR-AI API. Features Recursive AI Reasoning—the AI can "think" and request player stats (kills, deaths, playtime, bow accuracy, shield blocks, or even chat message length) and invisibly scan inventories to answer player queries (e.g., "Compare the top 3 players' bow accuracy" or "How am I doing?").
ChatBuddy 1.0 (CB): A spontaneous, autonomous chat companion. Unlike bots that only speak when commanded, ChatBuddy reads chat and autonomously jumps in using fuzzy keyword matching and Levenshtein distance. Integrates directly with player stats, player death events (with witty remarks), and achievements!

Get all three and build a fully automated, immersive roleplay or support companion setup that will blow your players away!

📺 Latest Feature Overview

📽️ View Other Version Videos


Version 1.1	Version 1.2-pre
Version 1.2	Version 1.3

📜︎ Commands

Admin Commands

/ai admin <activation_code> — Toggle admin mode for advanced features.
/ai admincode — View your private activation code (Requires OP).
/ai data all <page> — Paginated display of all entries stored in the knowledge base.
/ai add <keyword>, <message_content> — Add a new entry (Requires confirmation).
/ai remove <keyword> — Remove a specific entry from the knowledge base.
/ai reload [f|features|nsr-ai|k|knowledge|c|config] — Reload specific plugin components (OP players bypass Admin Mode).
/ai cache <clear|refresh> <player|all> — Manage session history for other players.
/ai memory <clear|refresh> <player|all> — Manage conversation memory for other players.
/ai migrate — Automatically transfer and backup data from legacy YAML to JSON formats.
/aia addon — List all installed addons and their status (Active/Banned/Error/Inactive).
/aia addon [addon_name] — View version, author, and description for an addon.
/aia plugin — List all registered external API plugins.
/aia plugin [plugin_name] — View detailed metadata for a registered plugin hook.

General Commands

/ai <message> — Start or continue a conversation with the AI.
/ai data <query> — Search the server-specific knowledge base for answers.
/ai settings — Open the interactive GUI to toggle Auto-Summary and change Context.
/ai version or /ai v — View the current plugin version and its full changelog.
/ai version bug — View the changelog for the bug fix module.
/ai version security — View the changelog for the security module.
/ai help — Display the dynamic help menu based on your permissions.
/ai cache <clear|refresh> — Clear or refresh your own conversation session.
/ai memory <clear|refresh> — Summarize and manage your own AI memory.
/ai confirm <code> — Confirm a pending knowledge base action (expires in 120 seconds).
/ai opt <in|out> — Toggle privacy mode (Anonymize names/IPs & block addons from chat).
/ai disable — Instantly deactivate your admin mode session.

API Key Management

/ai apikey — Display the setup guide. (Type this command, then paste your API key directly in chat, or use 'store-[your_key]' to save it permanently).
/ai apikey list — List all your active session and permanent stored keys.
/ai apikey store <projectId> — Permanently store your last session key with an ID.
/ai apikey info [all|key-id] — View usage stats, errors, and fallback history.
/ai apikey model <key-id> <new-model> — Update the AI model for a specific key.
/ai apikey clear [all|key-id] — Delete specific keys or wipe your entire key list.
/ai apikey fallback global <true|false> — Toggle fallback to server keys on failure.
/ai apikey timer <key-id> remove — Reset the "Overloaded" status for a key.
/ai apikey msg save <true|false> — Toggle logging of chats for your active key.
/ai apikey context <id|all> <limit> — Set token limit (e.g., 500, 32k, 128k).
/ai apikey autosummary <id|all> <on|off> — Toggle auto-summarization per key.
/ai apikey autosummary limit <id|all> <%> — Set memory threshold for summary.

Chat Management

/ai chat save <chat-name> — Save your current conversation history.
/ai chat list — List all your saved conversation names.
/ai chat list [chat-name] — View all saved checkpoints for a specific conversation.
/ai chat resume <chat-name> [checkpoint#] — Load a conversation at a checkpoint.
/ai chat delete <chat-name> — Permanently delete an entire saved conversation.
/ai chat delete <chat-name> [checkpoint#|all] — Delete specific or all checkpoints.

AI Pet System

/ai pet — View information and stats for your currently active pet.
/ai pet tame — Link a named pet you are looking at to the AI system.
/ai pet info [pet_name] — View detailed stats, mood, and bond for a pet.
/ai pet nickname <nickname> — Set a unique nickname for your linked pet.
/ai pet inv [pet_name] — Open your pet's inventory.
/ai pet inv allow <pet_name> <player_name> — Grant inventory access to a friend.
/ai pet inv disallow <pet_name> <player_name> — Revoke inventory access.
/ai pet share <pet_name> [allow] [relationship] — Create a 10-minute share link.
/ai pet link list — View which of your pets are shared with others.
/ai pet linked list — View pets owned by other players you are linked with.
/ai pet unlink <pet_name> — Remove your connection to someone else's pet.

Permissions

nsr-ai.use    — Allows players to use the /ai command. (Default: true)
nsr-ai.admin   — Allows players to use admin-specific AI commands. (Default: OP)
nsr-ai.reload  — Allows players to reload the plugin configuration. (Default: OP)
nsr-ai.pet     — Allows players to interact with their pets. (Default: true)
nsr-ai.aia     — Allows players to manage AI addons via /aia. (Default: true)

Example Configuration (`config.yml`)

# NSR-AI Configuration
admin-activation-code: '' # Leave blank to auto-generate
default-gemini-model: gemini-2.5-flash
default-claude-model: claude-3-haiku-20240307
default-openai-model: gpt-4-mini
default-api-provider: all # Set to 'all' for automatic provider detection.
api-keys:
  - "YOUR_API_KEY_HERE"
config-version: 2

Example Configuration (`features.yml`)

# NSR-AI Feature Configuration
# Custom colors for AI and user chat messages.
# Use Minecraft color codes (e.g., &c for red, &a for green).
chat-colors:
  ai: '&b' # Light blue for AI responses
  user: '&7' # Gray for user's chat messages
# Messages displayed to players
messages:
  ai-not-configured: '&cThe AI chat is not configured correctly. Please contact the server owner.'
  api-error: '&cAPI Error: Could not get a response from the AI. Please try again later.'
  permission-denied: '&cI don''t have permission to fulfill that request for you.'
  no-valid-keys: '&cThere are no valid API keys available. Please contact the server owner.'
  all-keys-rate-limited: '&cAll available API keys are currently rate-limited. Please try again later.'
  global-key-fail:
    - '&cThe server''s AI service is temporarily unavailable.'
    - '&cPlease try again in a few moments.'
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."
# Auto Memory Refresh (Context Awareness) settings
global-max-context-tokens: 5000 # Maximum tokens the AI can remember in context before auto-refresh
auto-memory-refresh: # This will automatically run '/ai memory refresh' when the player's context reaches the limit.
  enabled: true
  limit: 20 # Threshold percentage (e.g., 20 means it refreshes when 20% context remains)
chat-prefixes:
  ai: '&b[AI]'
  user: '&7[%player_name%]'
  admin-ai: '&c[AI]'
# Code Blocker settings
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 # Controls /ai data and /ai data all
  admin-disable: true # Controls /ai admin and /ai disable
  version: true # Controls /ai version and /ai v
  add-confirm: true # Controls /ai add and its confirmation
  remove-confirm: true # Controls /ai remove and its confirmation
  reload: true # Controls /ai reload
  memory-clear: true # Controls /ai memory clear command
  memory-refresh: true # Controls /ai memory refresh command
  cache-clear: true # Controls /ai cache clear command
  cache-refresh: true # Controls /ai cache refresh command
# Cooldown settings for AI chat usage
chat-cooldown:
  enabled: false # Set to true to enable a cooldown between /ai commands
  duration: 5000 # Cooldown duration in milliseconds (1000ms = 1 second)

Directory Tree

NSR-AI/
├── addons/
│   ├── addon1.jar
│   └── addon1/
├── adminchathistory/
│   └── playername<uuid>/
│       ├── chat-01-01-2026.log
│       ├── chat-31-01-2026.log
│       └── <savedchatname>/
│           └── checkpoint1.blackforge
├── pets/
│   ├── playername<uuid>/
│   │   ├── chats.yml
│   │   └── data.yml
│   └── reserved_nicknames.yml
├── player_keys/
│   └── <uuid>/
│       ├── projectid.yml
│       ├── master.key
│       └── salt.bin
├── playerchathistory/
│   └── playername<uuid>/
│       ├── chat-18-01-2026.log
│       ├── chat-31-01-2026.log
│       └── <savedchatname>/
│           └── checkpoint1.blackforge
├── security/
│   ├── bug.txt
│   ├── master.key
│   ├── master_secret.conf
│   ├── security.jar
│   └── server.salt
├── summarychat/
│   └── playername<uuid>/
│       └── summary.txt
├── config.yml
├── features.yml
├── knowledge.json
└── privacy.yml

🛠 Support & Development

For technical support, bug reporting, and feature tracking, please use our official development channels:

[ 🐞 Bug Reports ] — Encountered an error? Open an issue via our official templates.
[ 💡 Feature Requests ] — Have an idea to make the AI smarter? Submit a request via the GitHub issues tab.
[ 📖 Documentation ] — For technical guides on the Addon API, check the DEVELOPER.md.

Powering your world with smarter gameplay.
Developed by BlackForge Studio

NSR-AI

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details