AskChat

An AI chat assistant for servers. Players ask questions in chat with !ask <question> and a configurable AI persona ("Notch" by default) answers, optionally calling tools to fetch live information.

Supports three providers — Gemini (default), Ollama (local or cloud), and NVIDIA NIM — with agentic tool use for web search (Brave) and the Minecraft Wiki.

Examples

Features

• Chat-Based Interface: Ask questions and receive answers without leaving your Minecraft world.
• Configurable:
  • Customize the AI's prompt to guide its responses.
  • Change the bot's name in chat.
  • Optionally broadcast both the question and the answer to the server.
• Lightweight: Designed to minimize impact on server performance.

Installation

1. Drop the matching jar into your server's plugins/ directory.
2. Start the server once to generate plugins/AiChatBuddy/config.yml.
3. Stop the server, edit config.yml (see below), and start again — or edit live and run /aichat reload.

---

Configuration

Default config.yml:

provider: gemini          # gemini | ollama | nvidia

bot-name: "Notch"
private-questions: false  # true = whisper replies, false = broadcast
max-history: 8            # rolling per-player message history; 0 = stateless
agent-max-steps: 8        # max tool-calling iterations before forcing a best-effort answer

prompt-template: |
  You are Notch — the ancient architect and silent overseer ...
  (full Notch persona, see config.yml)

providers:
  gemini:
    api-key: ""
    api-url: "https://generativelanguage.googleapis.com/v1beta/models/gemma-4-31b-it:generateContent"
    temperature: 0.5
    top-p: 0.99
  ollama:
    base-url: "http://localhost:11434"   # or https://ollama.com for cloud
    api-key: ""                          # cloud only
    model: "gpt-oss:20b"
    temperature: 0.7
  nvidia:
    base-url: "https://integrate.api.nvidia.com"
    api-key: ""                          # must start with nvapi-
    model: "meta/llama-3.3-70b-instruct"
    temperature: 0.5

tools:
  web-search:
    enabled: true
    api-key: ""           # Brave Search API key; tool is hidden from the LLM if blank
    max-results: 3
  minecraft-wiki:
    enabled: true
    max-results: 3

You only need to fill in the api-keys for the provider(s) and tool(s) you want to use. Unconfigured providers/tools are simply skipped.

---

Getting API keys

Gemini (default, free tier available)

1. Go to https://aistudio.google.com/apikey.
2. Sign in with a Google account.
3. Click Create API key.
4. Copy the key (starts with AIza…) into providers.gemini.api-key.

Switch models by editing providers.gemini.api-url — the URL contains the model name. Defaults to gemma-4-31b-it (function-calling capable, fast, free). Other good choices:

• gemini-2.5-flash — fast, low-cost, strong tool use.
• gemini-2.5-pro — better quality, slower.
• gemma-4-26b-a4b-it — bigger context window, only ~4B active params per token.

Brave Search (for the web_search tool)

1. Go to https://brave.com/search/api/.
2. Click Get Started and sign up.
3. Subscribe to the Free plan (1 query/sec, 2k queries/month).
4. In the dashboard, create an API key under API Keys.
5. Paste it into tools.web-search.api-key. Leave blank to disable web search.

NVIDIA NIM (free tier)

1. Go to https://build.nvidia.com/.
2. Sign in with NVIDIA Developer credentials.
3. Open any model (e.g. https://build.nvidia.com/meta/llama-3_3-70b-instruct).
4. Click Get API Key in the top right.
5. Copy the key (starts with nvapi-) into providers.nvidia.api-key.

Recommended models for providers.nvidia.model:

• meta/llama-3.3-70b-instruct (default)
• nvidia/llama-3.1-nemotron-70b-instruct
• mistralai/mixtral-8x22b-instruct-v0.1

Ollama

You can run Ollama locally (free, private) or use Ollama cloud.

Local:

1. Install Ollama from https://ollama.com/download.
2. Pull a model that supports tool calls, e.g. ollama pull llama3.1 or ollama pull qwen2.5.
3. In config.yml:
   • providers.ollama.base-url: "http://localhost:11434"
   • providers.ollama.api-key: "" (not needed locally)
   • providers.ollama.model: "llama3.1" (or whichever you pulled)

Cloud :

1. Sign up at https://ollama.com/.
2. Generate an API key under your account settings.
3. In config.yml:
   • providers.ollama.base-url: "https://ollama.com"
   • providers.ollama.api-key: "<your-key-key>"
   • providers.ollama.model: "gpt-oss:20b" (or gpt-oss:120b, qwen3-coder:480b, deepseek-v3.1:671b, glm-4.7, kimi-k2.6, etc.)

Switch providers at any time by editing provider: and running /aichat reload.

---

Commands

Command	Permission	Description
!ask <question>	aichatbuddy.ask (default: everyone)	Ask the AI in chat.
/aichat reload	aichatbuddy.reload (default: op)	Reload config.yml and clear in-memory history.
/aichat forget	aichatbuddy.forget.self (default: everyone)	Clear your own conversation history.
/aichat forget <player>	aichatbuddy.forget.others (default: op)	Clear another player's history.

---

Usage

Type !ask followed by your question in the chat, e.g., !ask How do I make a crafting table?. The AI will respond with an answer.

Support & Feedback

If you have any questions, issues, or feature requests, please open an issue on [GitHub](link-to-your-github-repo.

Contributing

Contributions are welcome! Please feel free to fork this repository and submit pull requests.

License

This project is licensed under the MIT License.