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

# Dashboard

> Manage your Minekube AI server from the web dashboard -- create servers, monitor status, and invite friends

# Dashboard

The Minekube AI dashboard at [minekube.com/dashboard](https://minekube.com/dashboard) is your web-based control panel for managing servers.

***

## Creating a Server

<Steps>
  <Step title="Sign in">
    Go to [minekube.com](https://minekube.com) and sign in with your **Discord** account.
  </Step>

  <Step title="Enter your invite code (if prompted)">
    During the beta, you need an invite code to create a server. Get one from our [Discord](https://minekube.com/discord) or from a friend's referral.
  </Step>

  <Step title="Click Create Server">
    Hit the **Create Server** button on the dashboard. Your Paper 1.21 server starts provisioning immediately.
  </Step>

  <Step title="Wait for it to start">
    Your server is ready in about 30 seconds. The dashboard shows the status changing from **Starting** to **Running**.
  </Step>

  <Step title="Copy your server address">
    Once running, your server address is displayed on the dashboard. Add it to Minecraft under **Multiplayer > Add Server**.
  </Step>
</Steps>

***

## Server Detail Page

Click any server on the dashboard to open its detail page with four tabs:

<CardGroup cols={2}>
  <Card title="AI Chat" icon="message-bot">
    Talk to your AI assistant from the browser. Full streaming responses with tool call details. Conversation history saved in the right sidebar.
  </Card>

  <Card title="Console" icon="terminal">
    View server logs and run commands directly. *(Coming soon)*
  </Card>

  <Card title="Files" icon="folder-open">
    Browse and edit server files -- plugins, scripts, configs. *(Coming soon)*
  </Card>

  <Card title="Settings" icon="settings">
    Change server settings through a visual interface. *(Coming soon)*
  </Card>
</CardGroup>

### AI Chat from the Dashboard

The **Chat** tab lets you interact with the same AI assistant as in-game, but from your browser:

* **Streaming responses** -- see the AI think, call tools, and write in real time
* **Tool call details** -- expandable panels showing exactly what commands were run
* **Markdown rendering** -- tables, code blocks, and formatting rendered properly
* **History sidebar** -- browse and resume past conversations from the right panel
* **Session persistence** -- conversations survive server restarts

***

## Server Controls

The dashboard gives you direct control over your server:

| Control              | What It Does                                                  |
| -------------------- | ------------------------------------------------------------- |
| **Start**            | Wake up a hibernated server or start a stopped server         |
| **Stop**             | Shut down the server gracefully (all data is saved)           |
| **Status indicator** | Shows whether your server is Running, Starting, or Hibernated |
| **Server address**   | The address to enter in Minecraft for connecting              |

***

## Auto-Hibernation and Wake-on-Connect

To conserve resources across the platform, servers automatically **hibernate** when no players are online for a period of time.

<Tabs>
  <Tab title="What Happens During Hibernation">
    * The server process stops, using **zero** CPU and memory
    * All data is preserved: worlds, plugins, scripts, configs, player data
    * Your server address remains the same
    * The Minecraft server list shows: **"Server is sleeping - Connect to wake it up!"**
  </Tab>

  <Tab title="How Wake-on-Connect Works">
    You do not need to visit the dashboard to wake your server:

    1. Open your **Minecraft server list** -- just viewing the server triggers the wake-up
    2. Wait about **30 seconds** for the server to boot
    3. Refresh the server list -- when you see a normal MOTD and green ping, join

    The server starts waking the moment your Minecraft client pings it from the server list.
  </Tab>
</Tabs>

<Info>
  You can also start your server manually from the dashboard by clicking **Start**. This is useful if you want the server ready before you open Minecraft.
</Info>

***

## Referral System

Invite friends to Minekube AI and help them get access during the beta:

* **Your referral code** is shown on the dashboard
* Share it with friends -- they enter it when signing up
* **Track referrals** on the dashboard to see how many people joined through your code

<Tip>
  Referral codes help your friends skip the invite code waitlist. Share yours on Discord, with your Minecraft group, or on social media.
</Tip>