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:

Web Dashboard

Click your server on the 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.

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 for details.

---

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

Server Commands

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.

Skript Development

Write, install, test, and debug Skript scripts for custom commands, event handlers, scheduled tasks, scoreboards, kits, and complex game mechanics.

Plugin Management

Search Modrinth and Spiget, download the correct version for Paper 1.21, install plugins, hot-reload with PlugMan, and verify they loaded correctly.

World Building

Use WorldEdit to create structures, platforms, arenas, and builds at scale. Load and paste schematics. Modify terrain.

Server Configuration

Modify server.properties, spigot.yml, paper configs, manage the whitelist, operators, permissions, game rules, world border, and MOTD.

Troubleshooting

Read server logs, check TPS and performance, diagnose broken plugins, fix Skript errors, and identify what is causing issues.

---

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:

1. You send a message

   Your chat message is forwarded from the Minecraft server to the Claude agent.

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

3. 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
4. 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.

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

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

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

---

Next Steps

Chatting with AI

Learn AI mode, prefix mode, queuing, interrupts, and tips for great results

Examples

Browse dozens of real examples from quick commands to full minigames