> ## Documentation Index
> Fetch the complete documentation index at: https://minekube.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Chatting with AI

> How to talk to your AI assistant -- from the web dashboard or in Minecraft chat, with queuing, interrupts, and streaming responses

# Chatting with AI

You can talk to your AI assistant in **three ways**:

<CardGroup cols={3}>
  <Card title="Web Dashboard" icon="browser">
    Click your server on the dashboard to open the AI Chat tab. Full streaming with tool details and conversation history.
  </Card>

  <Card title="AI Mode" icon="message-circle">
    Type `/ai` in Minecraft to toggle AI mode. Every message goes to the AI.
  </Card>

  <Card title="Prefix Mode" icon="type">
    Prefix any Minecraft chat message with `AI>` to send it to the AI.
  </Card>
</CardGroup>

***

## Web Dashboard Chat

The **Chat** tab on your server's dashboard page gives you a rich chat interface:

* **Streaming responses** -- see text appear in real time as the AI works
* **Tool call details** -- expandable panels show exactly what commands were run (e.g., `mc-cmd list`)
* **Markdown rendering** -- tables, code blocks, headers, and links rendered properly
* **Conversation history** -- the right sidebar shows all past conversations, click to resume any
* **Session persistence** -- conversations survive server restarts

<Tip>
  The dashboard chat is especially useful for complex tasks where you want to see tool execution details and formatted output. In-game chat is better for quick commands while playing.
</Tip>

***

## In-Game Chat

### Two Modes

<Tabs>
  <Tab title="AI Mode (Recommended)">
    Toggle AI mode with the `/ai` command. When enabled, **every chat message** you type is sent to the AI automatically.

    ```
    /ai                          <- Turn on AI mode
    build me a house             <- AI receives this
    now add a pool               <- AI receives this too
    make it bigger               <- AI remembers context
    /ai                          <- Turn off AI mode
    regular chat message         <- Goes to normal Minecraft chat
    ```

    You will see a confirmation message:

    * **Green text**: "AI chat mode enabled. All your messages will be sent to AI."
    * **Red text**: "AI chat mode disabled. Use 'AI>' prefix or /ai to enable."

    <Info>
      Slash commands (like `/gamemode creative` or `/tp`) still work normally while AI mode is on. Only regular chat messages are forwarded to the AI.
    </Info>
  </Tab>

  <Tab title="Prefix Mode">
    Without AI mode enabled, prefix any message with `AI>` to send it to the AI:

    ```
    AI> give me 64 diamonds
    AI> what's the server TPS?
    AI> install a shop plugin
    ```

    Messages without the prefix go to normal Minecraft chat. This is ideal when you are playing with others and want to talk to the AI only occasionally.
  </Tab>
</Tabs>

***

## While the AI Is Working

When you send a message, the AI starts processing immediately. Here is what you see:

| What You See                | Where                     | Meaning                          |
| --------------------------- | ------------------------- | -------------------------------- |
| **"AI is thinking..."**     | Action bar (above hotbar) | The AI is planning its response  |
| **`[AI Tool] Bash`**        | Chat                      | The AI is running a command      |
| **"Running Bash..."**       | Action bar                | A tool is actively executing     |
| **`[AI] response text`**    | Chat                      | The AI's reply                   |
| **`[AI] Completed (3.2s)`** | Chat                      | Task finished, with elapsed time |

***

## Queuing and Interrupting

You can send additional messages while the AI is still working on a previous request.

<Tabs>
  <Tab title="Queue a Follow-Up">
    Type your next request normally. It is added to the queue and processed after the current task finishes.

    ```
    give me a diamond sword             <- AI starts working on this
    and enchant it with sharpness 5     <- Queued: "Got it, I'll do that next."
    also give me a shield               <- Also queued
    ```

    The AI processes queued messages in order.
  </Tab>

  <Tab title="Interrupt and Redirect">
    Start your message with an **interrupt word** to cancel the current task and start a new one:

    ```
    build me a castle at spawn          <- AI starts building
    stop, make me creative instead      <- Cancels castle, switches gamemode
    ```

    **Recognized interrupt words:**
    `stop`, `cancel`, `no no`, `nevermind`, `forget it`, `instead`, `nvm`
  </Tab>
</Tabs>

### Three Ways to Cancel

1. **Click `[Cancel]`** -- a clickable link shown in chat when the AI starts processing
2. **Type `/ai cancel`** -- works at any time
3. **Say an interrupt word** -- "stop", "cancel", "nevermind", etc.

After cancelling, you can immediately send a new request.

***

## Tips for Great Results

<AccordionGroup>
  <Accordion title="Be specific about what you want">
    The more detail you give, the better the result:

    ```
    -- Vague (AI has to guess)
    make something cool

    -- Specific (AI knows exactly what to build)
    build a medieval castle at spawn with a moat, drawbridge, and four corner towers
    ```

    ```
    -- Vague (AI does not know which script or what is wrong)
    fix it

    -- Specific (AI can find and fix the problem)
    the /kit command is not giving diamond armor, fix the kit script
    ```
  </Accordion>

  <Accordion title="Use plain natural language">
    You do not need to know Minecraft commands, Skript syntax, or server admin terminology. Just describe what you want in everyday words:

    ```
    make it always daytime
    give everyone on the server 10 levels
    when a player joins, teleport them to spawn and give them a starter kit
    stop it from raining
    ```
  </Accordion>

  <Accordion title="Ask for complex multi-step tasks">
    The AI handles tasks that involve many steps:

    ```
    create a PvP arena with kit selection, score tracking, and a 5 minute timer
    install WorldEdit and build a spawn platform with shops around it
    set up a survival server with keep inventory, no mob griefing, and starter kits
    ```

    The AI plans out the steps, executes them in order, and reports back.
  </Accordion>

  <Accordion title="Build iteratively">
    You do not have to get everything right in one message. The AI remembers context within a session:

    ```
    build a shop                 -> AI builds a shop
    make it bigger               -> AI knows you mean the shop
    add a sign that says "VIP"   -> Still in context
    now add a second floor       -> Continues building on the same shop
    ```

    Starting simple and adding features step by step often produces better results than one massive request.
  </Accordion>

  <Accordion title="Ask the AI to explain what it did">
    If you want to understand how something works:

    ```
    show me the skript you wrote for the kit system
    explain how the welcome message script works
    what plugins are installed and what do they do?
    ```
  </Accordion>
</AccordionGroup>

***

## Limitations

<Warning>
  Keep these limitations in mind when chatting with the AI:
</Warning>

* **Text-only responses** -- Minecraft chat does not support images, formatting beyond color codes, or rich media. Long responses may be split across multiple messages.
* **No screen vision** -- the AI cannot see your screen or what you are looking at. However, it can determine your position using teleport commands with relative coordinates, and can check your inventory via server commands.
* **No emojis** -- emojis can crash Minecraft clients, so the AI avoids them entirely.
* **Processing time** -- simple commands complete in seconds, but complex tasks (writing scripts, installing plugins, building structures) can take 30-60 seconds.
* **Session context** -- the AI remembers your conversation within a session. If the server restarts or you reconnect, it starts fresh.