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

• Supports Minecraft 1.8.3.
• 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.

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

var mineflayer = require('mineflayer');
var bot = mineflayer.createBot({
  host: "localhost", // optional
  port: 25565,       // optional
  username: "[email protected]", // 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);
});

• In the examples folder.
• vogonistic's REPL bot

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

• 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] (https://github.com/JonnyD/Skynet) - log player activity onto an online API
• [AlexKvazos/MinecraftChat] (https://github.com/Alexkvazos/MinecraftChat) - Minecraft web based chat client https://chat.alexkvazos.com/

npm install mineflayer

1. Follow the Windows instructions from node-minecraft-protocol
2. npm install mineflayer

• See doc/api.md.
• See doc/history.md.
• See examples/.
• See doc/unstable_api.md.
• See doc/contribute.md.

npm test

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

MIT