> ## 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.

# AI Assistant Overview

> How the Minekube AI assistant works -- an autonomous Claude agent that manages your Minecraft server through conversation

# AI Assistant

Every Minekube AI server comes with a built-in AI assistant powered by **Claude** (Anthropic). It is an autonomous agent that can execute server commands, write scripts, install plugins, build structures, configure settings, and troubleshoot problems -- all from natural conversation.

You can talk to the AI in two ways:

<Tabs>
  <Tab title="Web Dashboard">
    Click your server on the [dashboard](https://minekube.com/dashboard) to open the **AI Chat** tab. Type messages in the chat interface and see streaming responses with tool call details. Your conversation history is saved -- use the **History** panel on the right to browse and resume past chats.
  </Tab>

  <Tab title="In-Game Chat">
    Toggle AI mode with `/ai` in Minecraft, or prefix messages with `AI>`. Responses appear directly in Minecraft chat. See [Chatting with AI](/ai/chatting) for details.
  </Tab>
</Tabs>

***

## Traditional Server Admin vs. Minekube AI

| Task                    | Traditional Approach                                                                | With Minekube AI                                                                      |
| ----------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Install a plugin        | Google it, find the right version, download the JAR, upload via FTP, restart server | Say *"install WorldEdit"* -- done in seconds                                          |
| Create a custom command | Learn Skript syntax, write code, upload file, debug errors                          | Say *"make a /heal command with cooldown"* -- AI writes, installs, and tests it       |
| Change server settings  | SSH in, edit server.properties, restart                                             | Say *"set difficulty to hard"* -- AI changes it and reloads                           |
| Build a spawn area      | Learn WorldEdit, practice commands, build manually                                  | Say *"build a 30x30 stone spawn platform with a fountain"* -- AI handles it           |
| Diagnose lag            | Read wiki articles, check TPS manually, hunt through logs                           | Say *"why is the server lagging?"* -- AI checks TPS, logs, and reports findings       |
| Set up a minigame       | Spend days coding, testing, debugging                                               | Say *"create a spleef minigame"* -- AI builds the arena and writes all the game logic |

***

## Capabilities

<CardGroup cols={2}>
  <Card title="Server Commands" icon="terminal">
    Execute any Minecraft command -- gamemode, teleport, give items, manage players, set game rules, weather, time, and more. The AI runs commands via RCON on your server.
  </Card>

  <Card title="Skript Development" icon="code">
    Write, install, test, and debug Skript scripts for custom commands, event handlers, scheduled tasks, scoreboards, kits, and complex game mechanics.
  </Card>

  <Card title="Plugin Management" icon="puzzle-piece">
    Search Modrinth and Spiget, download the correct version for Paper 1.21, install plugins, hot-reload with PlugMan, and verify they loaded correctly.
  </Card>

  <Card title="World Building" icon="cube">
    Use WorldEdit to create structures, platforms, arenas, and builds at scale. Load and paste schematics. Modify terrain.
  </Card>

  <Card title="Server Configuration" icon="gear">
    Modify server.properties, spigot.yml, paper configs, manage the whitelist, operators, permissions, game rules, world border, and MOTD.
  </Card>

  <Card title="Troubleshooting" icon="bug">
    Read server logs, check TPS and performance, diagnose broken plugins, fix Skript errors, and identify what is causing issues.
  </Card>
</CardGroup>

***

## How It Works Under the Hood

Your AI assistant is **Claude** (by Anthropic) running as an autonomous agent via the Agent SDK. It has access to a set of tools that let it interact with your server:

<Steps>
  <Step title="You send a message">
    Your chat message is forwarded from the Minecraft server to the Claude agent.
  </Step>

  <Step title="Claude plans and acts">
    The agent reads your message, decides what tools to use, and begins executing. It can chain multiple actions together for complex tasks.
  </Step>

  <Step title="Tools execute on your server">
    The agent has access to:

    * **RCON (mc-cmd)** -- executes Minecraft commands directly on the server
    * **File system** -- reads and writes server files, Skript scripts, plugin configs, and source code
    * **Package managers** -- searches and installs plugins from Modrinth and Spiget
    * **Build tools** -- compiles Java plugins with Gradle when needed
    * **Server logs** -- monitors and analyzes what is happening on your server
  </Step>

  <Step title="Results are sent to chat">
    The agent's response appears in your Minecraft chat. If it ran commands or created files, it tells you what it did and whether it worked.
  </Step>
</Steps>

The AI runs in its own container alongside your Minecraft server. It has the same level of access a server administrator would have -- but it is available instantly through chat.

***

## What the AI Can and Cannot Do

<Tabs>
  <Tab title="Can Do">
    * Run any server command (give, teleport, gamemode, gamerule, etc.)
    * Write and install Skript scripts of any complexity
    * Install, remove, and configure plugins from Modrinth/Spiget
    * Build structures using WorldEdit
    * Modify any server configuration file
    * Compile and install custom Java plugins
    * Read logs and diagnose problems
    * Manage players (kick, ban, op, whitelist)
    * Search the web for documentation, tutorials, and solutions
    * Call external APIs and fetch web content
    * Determine player positions (via teleport commands with relative coordinates)
    * Remember context within a conversation session
  </Tab>

  <Tab title="Cannot Do">
    * See your screen directly (but can infer position from commands)
    * Display images or rich media (Minecraft chat is text-only, dashboard renders markdown)
    * Use emojis in chat (they can crash Minecraft clients)
    * Modify the underlying server infrastructure (container, networking)
    * Act on other servers -- it only controls your server
  </Tab>
</Tabs>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Chatting with AI" icon="comments" href="/ai/chatting">
    Learn AI mode, prefix mode, queuing, interrupts, and tips for great results
  </Card>

  <Card title="Examples" icon="lightbulb" href="/ai/examples">
    Browse dozens of real examples from quick commands to full minigames
  </Card>
</CardGroup>