skulk-minecraft

Connect an AI agent to a Minecraft Java Edition server as an autonomous bot.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/Kitsune-Den/skulk-skills --skill skulk-minecraft
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skulk-minecraft
Source: https://github.com/Kitsune-Den/skulk-skills/tree/main/skills/skulk-minecraft
Command: npx skills add https://github.com/Kitsune-Den/skulk-skills --skill skulk-minecraft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Connect an AI agent to a Minecraft Java Edition server as an autonomous bot.

Core Features & Use Cases

  • Per-agent personality configurations and server-auth integration.
  • Microsoft device-code authentication flow with token caching.
  • Auto-reconnect, error-detection, and survival behaviors (mining, farming, crafting, storage).

Quick Start

Start the bot by running the setup script to initialize and connect to your Minecraft server.

Frequently Asked Questions about skulk-minecraft

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect an autonomous AI bot to a Minecraft Java Edition server?▼

You connect an autonomous AI bot to a Minecraft Java server using a Mineflayer-based script with per-agent configs. It handles Microsoft device-code authentication and survival behaviors like mining, farming, and crafting.

Does a Minecraft bot require Microsoft device-code authentication to join servers?▼

Yes, Minecraft bots require Microsoft device-code authentication to join secure servers. This Skill implements the authentication flow with token caching to enable seamless automated reconnections.

How do I configure a Mineflayer bot for different personalities and tasks?▼

You configure a Mineflayer bot by defining per-agent personality configurations under the config directory. This allows you to assign specific survival behaviors like mining, farming, or storage management to each agent.

Do I need Node.js 22 to run a Minecraft automation bot?▼

Yes, you need Node.js 22 or newer to run this Minecraft automation bot. The Mineflayer-based bot code relies on this runtime environment to execute its autonomous server connection and survival scripts.

Why does my Minecraft bot fail to connect with an authentication error?▼

Your Minecraft bot might fail to connect if the server is not configured with enforce-secure-profile=false. The Skill includes auto-reconnect with error-detection to handle authentication failures and profile mismatches.