mindcraft-bots/mindcraft

Mindcraft is a Minecraft AI bot framework that uses large language models and Mineflayer to create autonomous agents capable of playing Minecraft.

The project addresses the challenge of building intelligent agents that can perceive and act within Minecraft environments. It works by connecting an LLM to the Mineflayer bot library, which provides programmatic control over a Minecraft client. The agent receives information about its surroundings and uses the LLM to decide what actions to take, executing those decisions through Mineflayer's API. The framework supports multiple LLM providers through configurable API keys and allows customization of agent behavior through JSON profile files that define the agent's name, model choice, and system prompts.

Mindcraft suits developers interested in AI agent research, Minecraft automation, or exploring how LLMs perform in interactive environments. It works with Minecraft Java Edition and requires Node.js, an API key from a supported provider, and a local Minecraft world opened to LAN. The project includes built-in safety considerations: code execution is disabled by default, though it can be enabled for advanced use cases with awareness of injection attack risks. Users should consult the FAQ for platform-specific installation guidance, particularly on macOS where native module builds may require additional setup.

The project maintains a substantial user base, with nearly all open issues originating from external users rather than the core team. Maintainers typically respond to new issues and pull requests within a few days. Work in the issue tracker centers on bug reports, enhancement requests, and user questions.