NSR-AI icon

NSR-AI -----

Gemini + ChatGPT Powered AI Chat for Minecraft: Fast, Smart & Server-Friendly




⚡ New Simulation Runtime – Artificial Intelligence
“The AI Layer for Minecraft Servers.”

Advanced Multi-API AI Chat Plugin for Minecraft
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✔ Multi-API✔ Addon Support✔ Easy Setup✔ Powerful & highly Customizable

MC Versions: 1.16.5 – 1.21.4 • JAR Size: 3.5 MB • AI Models: Gemini, Claude, OpenAI

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙ 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.

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!
NSR-AI's setup is simple, even with its many features. The advanced system automatically detects the API provider from your key. You only need to change the model in the config if you wish to use a specific one other than the default.

✨ Major New Features in 1.2
  • Advanced API Key Manager — A powerful new system under /ai apikey for players to manage their own API keys with enhanced security and control.
    • Intelligent Key Rotation: Automatically cycles through available keys to maximize uptime and avoid rate limits.
    • Detailed Stats: Track usage, errors, and fallbacks for each key with /ai apikey info.
    • Player Control: Add, store, and delete your own keys without admin intervention.
    • Enhanced Security: Keys are stored with military-grade AES-256-GCM encryption.
  • Pet System Enhancements — Your companions are now more interactive and personalized than ever.
    • New Pet Types: Wolf, Cat, Horse, Parrot, Pig, Panda, Sheep, and Cow.
    • Shareable Pet Links: Share access to your pets with friends using a unique link system (/ai pet share).
    • Pet Inventories & Stats: Pets now have their own inventory, level, XP, health, and hunger.
  • Open-Source Addon API — A new API that allows developers to create powerful addons that can interact with NSR-AI's core features, such as GUI, knowledge base, and player states.
  • Advanced Knowledge Search (RAG) — The /ai data command now uses a sophisticated hybrid AI system (Retrieval Augmented Generation) to provide more accurate, context-aware answers from the local knowledge base.
  • Enhanced Chat & Logging
    • Chat History Preference: Players can choose whether their AI conversations are saved (/ai apikey msg save).
    • Organized Logs: Chat logs are now stored in dedicated folders with daily rotation.
  • Security & UI Upgrades
    • Configuration Encryption: Sensitive data in config.yml is now automatically encrypted.
    • Cyber-Console UI: A sleek new interface for all apikey commands.

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.

Optional Dependencies

Video Demonstration (v1.2)


Admin Commands
Code (Text):

/ai admin  - Toggle admin mode.
/ai apikey ... - Manage API keys (see new features).
/ai pet ... - Manage pets (see new features).
/ai add ,  - Add knowledge with AI-generated heading.
/ai remove  - 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  [player|all] - Manage session cache.
/ai memory  [player|all] - Manage AI-powered memory.
 
General Commands
Code (Text):

/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
Code (Text):

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
 
Code (Text):

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

Code (Text):

# 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
 

Code (Text):

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Need help or found a bug? Comment below & I’ll respond ASAP!
Resource Information
Author:
----------
Total Downloads: 121
First Release: Aug 6, 2025
Last Update: Nov 16, 2025
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings