NSR-AI Version 1.0.2

(Released: 2025-08-28)

Overview

NSR-AI is a next-generation AI plugin for Minecraft servers, designed to bring intelligent conversations, admin tools, and extensibility directly in-game.

It supports Gemini, Claude, and OpenAI APIs, making it one of the most flexible AI plugins available. With its addon system, server owners can expand functionality, while players enjoy smooth, natural interactions.

The latest release, (2025-08-28), focuses on stabilizing addons, improving performance, and fixing issues from 1.0.2 before the full 1.1 release.

🆕 New Features in Version 1.0.2

  • Multi-API Support: The plugin now supports multiple AI providers — Gemini, Claude, and OpenAI. Configure the default provider and API keys in config.yml.
  • Code Blocker: A new security feature that prevents the AI from providing code snippets. Fully configurable in config.yml with a custom warning message.
  • Addon Support: Introduced a modular addon system. Addons are placed in plugins/NSR-AI/addons and extend functionality with new features and commands.
  • Advanced Player Stats Addon: A new optional addon with:
    • 📊 In-depth stats (playtime, kills, deaths, blocks mined, etc.)
    • 🔒 Per-player privacy controls
    • ⏳ AFK tracker with admin notifications
    • 💬 Natural language commands for easier interaction
    • ✍️ “Did you mean?” correction for player name typos

Available Commands

  • /ai <message>
    Example: /ai Hello, how are you?
    → The AI replies directly in chat.
  • /ai admin <code>
    Example: /ai admin 123456
    → Activates Admin Mode for the player BlackForge using the secure code.
  • /ai msg <code> [keyword]
    Example: /ai no pvp is server rules
    → Adds the server rule is no pvp temporary by BlackForge.
  • /ai reload
    Example: /ai reload
    → Reloads the plugin configuration and any updated knowledge base entries.

Command Permissions

  • /ai <message> → Permission: nsrai.chat (default: all players)
  • /ai admin <code> → Permission: nsrai.admin (default: ops only)
  • /ai reload → Permission: nsrai.admin (reload configuration)

By default, player chat with /ai is open to everyone, while management commands are restricted to operators or players with nsrai.admin permission.

Key Features (up to Version 1.0.2)

  • Multi-API Integration: Supports Gemini, Claude, and OpenAI with configurable API provider selection and automatic key rotation (up to 20 keys).
  • Addon Support: Extend functionality by dropping addon .jar files into the addons/ folder. Includes the Advanced Player Stats addon (tracks kills, deaths, AFK, playtime, and supports privacy).
  • Custom Chat Presentation: Fully configurable colors and prefixes for AI and admin chat.
  • Performance & Safety: Asynchronous API calls to prevent lag, enhanced error handling, and clean chat formatting.
  • Security Features: Built-in Code Blocker prevents unsafe code sharing.
  • Version 1.1-pre1: Added personalized greetings and responses using your player name.

Improvements & Bug Fixes

  • Addon Configurations: Fixed issues where certain addon setups could result in console spam or unstable logs.
  • AI Response Looping: Resolved a rare bug where the AI would generate repetitive or looping answers in some conversations.
  • Compatibility: Improved stability across Minecraft versions (1.16–1.21) and broader Java environments for smoother operation.
  • Documentation: Updated and clarified setup instructions, making it easier for new admins to configure the plugin.

Optional Dependencies

  • PlaceholderAPI: Allows you to use NSR-AI placeholders in other plugins.
  • NSR-AI-Advanced-Player-Stats (Addon): Optional addon that provides detailed player stats, privacy controls, and an AFK tracker.

Configuration (config.yml)


# NSR-AI Configuration

# The secret code to enter admin mode.
admin-activation-code: '3637'

# 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 API keys are currently rate-limited. Please try again later.'

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

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

chat-prefixes:
  ai: '&b[AI]'
  user: '&7[You]'
  admin-ai: '&c[AI]'





  
# Chat history settings
chat-history:
  enabled: true
  max-size: 100 # per player

# Code Blocker settings
code-blocker:
  enabled: true
  message: "&cThis is a game built for fun and answering, not for coding."
  
# Versioning
config-version: 2

Known Issues

  • Addon API Documentation: Full developer documentation for the addon system is still pending and will be released with the stable 1.1 update.
  • Complex AI Behaviors: Some advanced or multi-step AI interactions may require additional fine-tuning for best performance, and could occasionally behave unpredictably.
  • Addon Developer Support: While the API has been expanded, examples and tutorials are still limited, which may make it harder for new developers to create addons.