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

# Quick Start

> Create your Minekube AI server and start playing in under 2 minutes

# Quick Start

Go from zero to talking with your AI assistant in five steps.

<Note>
  Minekube AI is currently in **beta**. You need an invite code to create a server. Join our [Discord](https://minekube.com/discord) to get one.
</Note>

<Steps>
  <Step title="Sign Up">
    Go to [minekube.com](https://minekube.com) and sign in with **Discord**. If you have a referral code, enter it during signup.
  </Step>

  <Step title="Create Your Server">
    On the [dashboard](https://minekube.com/dashboard), click **Create Server**. Your Paper 1.21 server spins up in about 30 seconds with Skript, skript-reflect, and PlugMan pre-installed.
  </Step>

  <Step title="Add the Server in Minecraft">
    Open **Minecraft Java Edition** (1.21+):

    1. Go to **Multiplayer** and click **Add Server**
    2. Paste the server address shown on your dashboard
    3. Click **Done**

    Your server appears in the list. If it shows **"Server is sleeping"**, just wait about 30 seconds -- viewing it in the list wakes it automatically.
  </Step>

  <Step title="Join and Talk to the AI">
    Double-click your server to join. Once you are in-game, start chatting with the AI:

    <Tabs>
      <Tab title="AI Mode (Recommended)">
        Type `/ai` to toggle AI mode **on**. Now every chat message goes straight to the AI.

        ```
        /ai                        <- Toggle AI mode on
        give me diamonds           <- AI receives this
        build a house at spawn     <- AI receives this too
        /ai                        <- Toggle AI mode off (back to normal chat)
        ```

        Slash commands like `/gamemode` still work normally while AI mode is on.
      </Tab>

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

        ```
        AI> give me 64 diamonds
        AI> what plugins are installed?
        ```

        This is useful when you want to chat normally with other players but occasionally talk to the AI.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Try These First">
    Here are some great first requests to try:

    ```
    give me creative mode
    what plugins are installed?
    set time to day
    make a welcome message when players join
    build something cool at spawn
    ```

    The AI executes each request and reports back what it did.
  </Step>
</Steps>

***

## What Happens While the AI Works

When you send a message:

* **"AI is thinking..."** appears on your action bar (above your hotbar)
* **Tool calls** appear in chat as the AI runs commands (e.g., `[AI Tool] Bash`)
* **The AI's response** appears in chat when it finishes
* **Completion time** is shown (e.g., `[AI] Completed (3.2s)`)

<Info>
  You can keep sending messages while the AI is working. New messages are **queued** and processed in order. To cancel the current task, say **"stop"**, **"cancel"**, click the **\[Cancel]** link in chat, or type `/ai cancel`.
</Info>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Connecting" icon="wifi" href="/connecting">
    Detailed guide on server states, wake-on-connect, and troubleshooting
  </Card>

  <Card title="Chatting with AI" icon="comments" href="/ai/chatting">
    Master 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 simple commands to full minigames
  </Card>

  <Card title="AI Overview" icon="brain" href="/ai/overview">
    Understand how the AI agent works under the hood
  </Card>
</CardGroup>