Mineflayer

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

Features

Supports Minecraft 1.8, 1.9, 1.10, 1.11 and 1.12.
Entity knowledge and tracking.
Block knowledge. You can query the world around you.
Basic physics and movement - currently blocks are either "solid" or "empty".
Attacking entities and using vehicles.
Inventory management.
Crafting, chests, dispensers, enchantment tables.
Digging and building.
Miscellaneous stuff such as knowing your health and whether it is raining.
Activating blocks and using items.
Chat.

Roadmap

Brewing stands, and anvils.
Better physics (support doors, ladders, water, etc).

Usage

Without version specified, the version of the server will be guessed automatically, you can set a specific one using the version option. For example version:"1.8".

Echo Example

var mineflayer = require('mineflayer');
var bot = mineflayer.createBot({
  host: "localhost", // optional
  port: 25565,       // optional
  username: "email@example.com", // email and password are required only for
  password: "12345678",          // online-mode=true servers
});
bot.on('chat', function(username, message) {
  if (username === bot.username) return;
  bot.chat(message);
});

More Examples

In the examples folder.
vogonistic's REPL bot

Third Party Plugins

Mineflayer is pluggable; anyone can create a plugin that adds an even higher level API on top of Mineflayer.

navigate - get around easily using A* pathfinding. YouTube Demo
radar - web based radar interface using canvas and socket.io. YouTube Demo
blockfinder - find blocks in the 3D world
scaffold - get to a target destination even if you have to build or break blocks to do so. YouTube Demo
auto-auth - chat-based bot authentication
Armor Manager - automatic armor managment
Bloodhound - determine who and what is responsible for damage to another entity

Projects Using Mineflayer

rom1504/rbot
- YouTube - building a spiral staircase
- YouTube - replicating a building
Darthfett/Helperbot
vogonistic/voxel - visualize what the bot is up to using voxel.js
JonnyD/Skynet - log player activity onto an online API
MinecraftChat (last open source version, built by AlexKvazos) - Minecraft web based chat client https://minecraftchat.net/
Cheese Bot - Plugin based bot with a clean GUI. Made with Node-Webkit. http://bot.ezcha.net/

Installation

npm install mineflayer

Documentation

Testing

Some setup is required after first cloning the project but after that is done it's very easy to run them.

Setup

In order to get all tests to run successfully you must first:

create a new folder in which to store minecraft server jars
set the MC_SERVER_JAR_DIR to this folder

Example:

mkdir server_jars
export MC_SERVER_JAR_DIR=/full/path/to/server_jars

Where the "/full/path/to/" is the fully qualified path name.

Ongoing

Simply run: npm test

Updating to a newer protocol version

Wait for a new version of node-minecraft-protocol to be released which supports the new Minecraft version.
npm install --save minecraft-protocol@latest
Apply the protocol changes where necessary.
Run the test suite. See Testing above.

Licence

MIT

bitk0der / mineflayer