NoriAI

Have you ever wanted an AI assistant in your Minecraft server chat that can answer player questions, provide help, and even look up Minecraft wiki information without needing expensive API keys?

Luckily for you, there's my plugin that makes it possible!

I originally made this for my Paper server on version 1.21.1, but I think it should work on higher versions too.

So, the plugin includes:

---

LOCAL AI (NO API KEYS)

• Uses Ollama — completely free and local
• No monthly fees or API limits
• Your data stays on your server
• Works offline

---

TRIGGER SYSTEM

• Players mention the AI by keyword (configurable)
• Example: "Nori, how to craft a netherite sword?"
• Case-insensitive matching
• Configurable substring or whole word matching

---

KNOWLEDGE DATABASE

• Built-in Minecraft wiki database (SQLite with FTS5)
• Fast full-text search
• Auto-lookup for questions
• Configurable search limit
• Admin commands to manage database

---

CHAT CONTEXT

• AI sees recent chat messages
• Responds with context awareness
• Configurable history length
• Optional player names in history

---

TWO RESPONSE MODES

• Private — only the asking player sees the answer
• Global — everyone sees the answer (prefix with !)
• Configurable broadcast mode

---

COOLDOWN & CONCURRENCY

• Per-player cooldown (configurable seconds)
• Maximum concurrent requests limit
• Prevents spam and overload
• Custom cooldown message

---

CUSTOM SYSTEM PROMPT

• Load from system_prompt.txt
• Define AI personality
• Include server info
• Full customization

---

SERVER INFORMATION

• Load from server_info.txt
• AI knows about your server
• Custom rules and information
• Easy to update

---

ADMIN COMMANDS

Command	Description
/noriai reload	Reload configuration
/noriai status	View plugin status
/noriai clearhistory	Clear chat history
/noriai kb clear	Clear knowledge database
/noriai kb search <query>	Search knowledge base

---

PERMISSIONS

Permission	Description
NoriAI.use	Use the AI assistant
NoriAI.admin	Access to admin commands

---

REQUIREMENTS

• Ollama installed on your server (ollama.ai)
• AI model downloaded (ollama pull llama3)
• Paper 1.21.1 or higher

---

CONFIGURATION

Option	Description
Trigger keyword	What word activates the AI
Ollama model	Which AI model to use
Cooldown	Seconds between requests
Response length	Maximum characters
History size	How many messages to remember
Broadcast mode	Private or global responses

---

If you run into any issues, contact me on Telegram! @AlexsandrDeveloper

(Also message me if you're interested in buying the plugin's source code)