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.