Repolode
提交项目
PrismarineJS

PrismarineJS/mineflayer

用 JavaScript 编写 Minecraft 机器人的高层 API，可加入服务器、移动、挖掘、合成并与世界交互。

在 GitHub 查看官网
Star
7,724
Fork
1,547
未关闭 Issue
557
最近提交
11天前

这是什么？

Mineflayer 是一个用于创建 Minecraft 机器人的 Node.js 库。开发者编写脚本连接到 Minecraft 服务器后，机器人便能感知并操作游戏世界：追踪实体、查询周围方块、基于物理引擎移动、管理背包、合成物品、使用箱子和熔炉、挖掘与放置方块，并发送聊天消息。

该库支持 Minecraft 1.8 至 26.1 的多个版本，可通过微软账号或离线模式服务器进行认证。它构建在 PrismarineJS 模块体系之上，由其负责协议解析、方块与物品数据及物理引擎。项目还提供寻路、浏览器实时查看机器人视角以及接入 Discord 等示例。

社区插件进一步扩展了基础 API，涵盖自动寻路、PvP 战斗、方块收集以及基于 MCP 的大模型控制等功能。

核心功能

  • 01追踪附近实体并查询世界中的方块。
  • 02模拟玩家与载具的移动和物理行为。
  • 03管理背包，支持合成、箱子、熔炉和附魔台。
  • 04挖掘和放置方块，激活方块或使用物品。
  • 05支持 Minecraft 1.8 至 26.1，可用微软或离线方式认证。

适用场景

  • 为 Minecraft 服务器开发自动化辅助机器人。
  • 搭建通过大模型玩 Minecraft 的 AI 智能体原型。
  • 自动执行种植、建造蓝图等重复性游戏任务。
  • 借助 Node.js 学习游戏自动化与协议处理。

快速上手

  1. 1

    从 nodejs.org 安装 Node.js 18 或更高版本

  2. 2

    安装 mineflayer 包

    npm install mineflayer
  3. 3

    创建机器人脚本并连接服务器（参见 README 中的回声示例）

使用前须知

  • 需要 Node.js 18 或更高版本，并需编写 JavaScript 代码来控制机器人。
  • 使用微软账户认证时，首次使用需要在浏览器中登录。

标签

#minecraft#bot#nodejs#javascript#game-automation#minecraft-bot#minecraft-api#network

常见问题

mineflayer 是什么？
用 JavaScript 编写 Minecraft 机器人的高层 API，可加入服务器、移动、挖掘、合成并与世界交互。 Mineflayer 是一个用于创建 Minecraft 机器人的 Node.js 库。开发者编写脚本连接到 Minecraft 服务器后，机器人便能感知并操作游戏世界：追踪实体、查询周围方块、基于物理引擎移动、管理背包、合成物品、使用箱子和熔炉、挖掘与放置方块，并发送聊天消息。
mineflayer 可以免费使用吗？用的什么许可证？
mineflayer 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
mineflayer 还在维护吗？
活跃维护中。mineflayer 最近一次提交是在 2026年10月27日。
mineflayer 适合用来做什么？
为 Minecraft 服务器开发自动化辅助机器人。 搭建通过大模型玩 Minecraft 的 AI 智能体原型。 自动执行种植、建造蓝图等重复性游戏任务。 借助 Node.js 学习游戏自动化与协议处理。
mineflayer 怎么安装和运行？
从 nodejs.org 安装 Node.js 18 或更高版本 安装 mineflayer 包: npm install mineflayer 创建机器人脚本并连接服务器（参见 README 中的回声示例）
在哪里获取 mineflayer？
源代码和安装说明在 GitHub 上：https://github.com/PrismarineJS/mineflayer

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目