skills.rest
nacloos
nacloosCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Minecraft — Agent Skill Guide

Expose an HTTP API to control a Mineflayer-based Minecraft agent.

Updated Aug 23, 2026
Search Tags:#automation#agent#observe#http-api#minecraft#pathfinder#mineflayer
One-click install
npx skills add https://github.com/nacloos/clawblox --skill minecraft-agent-skill-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Minecraft — Agent Skill Guide
Source: https://github.com/nacloos/clawblox/tree/main/worlds/minecraft/minecraft-adapter
Command: npx skills add https://github.com/nacloos/clawblox --skill minecraft-agent-skill-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Exposes a programmable HTTP API to control a Mineflayer-based Minecraft agent, enabling automated observation, navigation, and interaction within a running world.

Core Features & Use Cases

  • HTTP endpoints to manage sessions, observe game state, and issue a broad set of actions (move, dig, place, chat, inventory, combat) against a Minecraft server.
  • Dual operation modes: a standard server-based adapter and an eval-based adapter with a real-time event stream over WebSocket, plus a built-in skill reference at /skill.md.
  • Real-world scenario: orchestrate a discovery and resource-gathering agent that can explore a world, collect items, craft, and interact with other players.

Quick Start

Launch the Minecraft adapter, create a session with /join, then observe with /observe and issue actions via /input to drive the agent.

Frequently Asked Questions about Minecraft — Agent Skill Guide

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

FAQPage Schema
How do I control a Minecraft agent via HTTP API?▼

You control a Minecraft agent via HTTP API by sending requests to a Fastify server. Use the /join endpoint to create a session, /observe to retrieve game state, and /input to dispatch navigation, combat, and inventory actions to the agent.

What is Mineflayer used for in Minecraft automation?▼

Mineflayer is used for Minecraft automation to create a programmable agent. This adapter wraps Mineflayer, exposing its navigation, interaction, and world observation capabilities through structured HTTP endpoints for external control.

Can I execute custom code inside a Minecraft agent environment?▼

Yes, you can execute custom code inside a Minecraft agent environment. The adapter provides an eval mode at server_eval.mjs that runs sandboxed code, offering a real-time event stream over WebSocket for dynamic agent manipulation.

Does the Minecraft HTTP API adapter require any external dependencies?▼

The Minecraft HTTP API adapter has no external dependencies. You simply need a running local or remote Minecraft server for the Mineflayer agent to join, allowing immediate session creation and observation without package installations.

What actions can I dispatch to a Mineflayer agent through HTTP?▼

You can dispatch a broad set of actions to a Mineflayer agent through HTTP, including moving, digging, placing blocks, chatting, managing inventory, and engaging in combat. These actions are issued via the /input endpoint.

Related Skills

Explore More Software Engineering Skills→
bdambrosiobdambrosio
10

mc-open

Open block-based Minecraft user interfaces via HTTP requests.

Community
Basic
ImChongImChong
20

lark-event

Subscribe to Feishu/Lark events via WebSocket and stream NDJSON to stdout.

Community
Intermediate
XeldarAlzXeldarAlz
3

navmesh

Configure Unity NavMesh surfaces and agents for dynamic pathfinding.

Community
Advanced
johnnystefanjohnnystefan

pattern-bridge

Decouple class hierarchies into independent abstraction and implementation layers.

Community
Intermediate