ExAI

ExAI — AI Assistant Plugin for Minecraft

ExAI brings an LLM-powered, in-game AI assistant to your Minecraft server. It answers player questions with a community-curated knowledge base, using RAG (vector retrieval + LLM) for grounded, server-specific replies. Everything happens inside a chest GUI — no command memorization required.

Project: https://github.com/Crossroadscodes/MC-ExAI

Features

• Chest GUI assistant — players talk to the AI through a clean menu, no chat spam.
• Public chat response — auto-replies to questions in public chat by keyword triggers (configurable, with cooldown).
• Knowledge base with review workflow — players submit Q&A via a written book → OP approves/rejects in GUI → approved entries enter the vector store.
• RAG retrieval — DashScope text-embedding-v3 (1024-dim) for semantic search; configurable similarity threshold.
• Reward system — Vault currency + custom item rewards for approved submissions.
• OP tools — chat history viewer, knowledge base editor, per-record edit-and-promote.
• Flexible storage — choose between MySQL or pure local YAML files via storage.type; zero database setup required for small servers.
• i18n — built-in zh_CN / en_US, hot-reloadable.
• LLM backend — OpenAI-compatible API (default Aliyun DashScope / Qwen, easy to swap to OpenAI, DeepSeek, etc.).

Screenshots

Main menu — Start a chat Hover the player head and click to begin a single-turn dialogue with the assistant.

Start Chat

Main menu — Upload knowledge

The paper item shows usage info and the current cooldown.

Upload Knowledge

Click the book to receive a writable book; fill in Q: ... A: ... and close it to submit for review.

Main menu — Reviewer panel (OP)

Open the per-page review GUI. Left-click to approve (writes to the knowledge base and pays rewards), right-click to reject.

Main menu — Chat history (OP)

Browse player questions and AI replies; left-click to edit and promote a record into the knowledge base, right-click to delete.

Main menu — Knowledge base (OP)

View and edit every accepted entry. Left-click to edit, right-click to delete; the knowledge base auto-reloads.

Public chat in action

Type a question with a configured keyword (?, how, what, etc.) and the assistant replies on broadcast.

Commands & Permissions

Command Description /exai opengui Open the assistant GUI /exai question Send a question to a player (OP) /exai reload Reload config (OP) /exai help Show help Permission node: exai.op (knowledge review).

Quick Setup

1. Drop ExAI.jar into plugins/.
2. Start the server once → edit plugins/ExAI/config.yml:
3. Choose storage.type: yml (default, no DB) or mysql.
4. If mysql, fill in MySQL credentials.
5. Fill in your LLM API key (llm.apiKey).
6. Adjust assistant name / language / rewards.
7. (Optional) Edit plugins/ExAI/knowledge.yml to seed your knowledge base.
8. /exai reload.

Storage modes

• yml (default)
• mysql

Requirements

• Spigot/Paper 1.12.2 or compatible
• Java 8+
• MySQL 5.7+ — only if storage.type: mysql
• Vault — optional, for currency rewards
• An OpenAI-compatible LLM endpoint + embedding endpoint