⚡ 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

• 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 of the 1.2

Admin Commands

/ai admin <activation_code> - Toggle admin mode.
/ai apikey ... - Manage API keys (see new features).
/ai pet ... - Manage pets (see new features).
/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 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
    ├── security/
    ├── pets/
    ├── config.yml
    ├── features.yml
    └── knowledge.yml

Need help or found a bug? Comment below & I’ll respond ASAP!