prismarinejs/mineflayer

Create Minecraft bots with a powerful, stable, and high level JavaScript API.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 3 minutes ago
Added to GitGenius on September 8th, 2026
Created on January 23rd, 2011
Open Issues & Pull Requests: 528 (+0)
GitHub issues: Enabled
Number of forks: 1,491
Total Stargazers: 7,420 (+0)
Total Subscribers: 97 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 13.1 hours
Mean response time: 36.1 days
90th percentile: 74.0 days
Tracked items: 264

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 96% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "new feature" is answered fastest, typically in about 3 hours, while "waiting info from op" waits about 3 days. 47% of tracked open issues have had no activity in three months. Only 4% of issues opened in the past year have been closed.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 168
New in 7 days: 2
Closed in 7 days: 2
Avg open age: 614 days
Stale 30+ days: 142
Stale 90+ days: 122

Recent activity

Opened in 7 days: 1
Closed in 7 days: 2
Comments in 7 days: 1
Events in 7 days: 6

Top labels

  • Stage1 (262)
  • possible bug (197)
  • new feature (65)
  • waiting info from op (11)
  • Stage3 (9)
  • question (7)
  • bug (6)
  • contribution-wanted (4)

Detailed Description

Mineflayer is a JavaScript library for creating Minecraft bots with a high-level API, also usable from Python.

The tool abstracts away the complexity of Minecraft's network protocol and game mechanics, allowing developers to write bot logic in JavaScript without managing low-level packet handling. It provides entity tracking, block querying with millisecond-scale performance, physics simulation including bounding boxes, inventory management, crafting, digging, building, and chat interaction. The library supports a wide range of Minecraft versions and handles movement, combat, and vehicle usage.

Mineflayer suits developers building automation tools, game AI, or interactive agents for Minecraft servers. It works well for both simple scripts and complex multi-bot systems. The project includes a tutorial for Node.js newcomers and Python examples for those preferring that language, with interactive notebooks available. The documentation covers the full API, a FAQ, and numerous examples demonstrating common tasks.

The project maintains active engagement with its community through documented contribution guidelines and a roadmap of planned features. Development shows consistent attention to version compatibility across a broad range of Minecraft releases. The codebase receives updates addressing both new game versions and underlying protocol changes, with examples and tutorials kept current to reflect the library's capabilities.