NSR-AI 1.1

⚡ NSR-AI 1.2
Advanced Multi-API AI Chat Plugin for Minecraft



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

✔ Multi-API • ✔ Addon Support • ✔ Easy Setup

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

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

⚙ Core Capabilities

1. Multi-API Integration — Seamlessly switch between Gemini, Claude, and OpenAI APIs to find the perfect balance of speed, intelligence, and cost for your server.
2. Lightweight & Optimized — Designed for performance, NSR-AI has a minimal impact on your server's resources, with a JAR size of approximately 3MB.
3. 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.
4. API Key Rotation — Supports up to 20 API keys with automatic cycling to prevent rate-limiting and ensure high availability.
5. Persistent Knowledge Base — Teach the AI custom facts and information about your server that will be remembered across restarts.
6. Enhanced Error Handling — Clear and user-friendly error messages make it easy to diagnose and resolve any issues.
7. AI Self-Description — The AI can describe itself and its features to players on request.
8. Code Blocker — A security feature that prevents the AI from providing code snippets in its responses.

🔌 Addon Support

1. Extendable Architecture — The powerful addon system allows you to extend the functionality of NSR-AI with new features and commands.
2. Easy to Install — Simply drop the addon `.jar` file into the `addons` folder and restart the server.

✨ Major New Features in 1.2

1. Multi-API Support: Switch between Gemini, Claude, and OpenAI.
2. Addon System: Extend functionality with custom addons.
3. Advanced Player Stats: A new addon for tracking player statistics.
4. Natural Language Commands: More intuitive command usage.
5. "Did you mean?" Feature: Corrects spelling mistakes in player names.

Optional Dependencies

1. PlaceholderAPI: Allows you to use NSR-AI placeholders in other plugins.
2. NSR-AI-Advanced-Player-Stats (Addon): This addon is optional, but it provides the player stats, privacy, and AFK tracker features.

Admin Commands

/ai admin  - Toggles admin mode (perm: nsr-ai.admin)
/ai admin remember   - Teach custom responses
/ai reload - Reload configs (perm: nsr-ai.reload)

General Commands

/ai  - Chat with the AI (perm: nsr-ai.use)
/ai help stats - Shows a list of all player data commands (from the addon)

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

Example Configuration

# 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"]
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:
  enabled: true
  max-size: 100
code-blocker:
  enabled: true
  message: "&cThis is a game built for fun and answering, not for coding."
config-version: 2

Directory Tree

plugins/
└── NSR-AI/
    ├── addons/
    │   ├── NSR-AI-Advanced-Player-Stats.jar
    │   └── NSR-AI-Advanced-Player-Stats/
    │       ├── playerprivacy/
    │       │   └── -.yml
    │       └── privacy.yml
    ├── config.yml
    └── knowledge.yml