Create Minecraft bots with a powerful, stable, and high level JavaScript API.
1.13 and 1.14 support are not available, if you're interested to contribute on that, read PrismarineJS#712 (comment)
- 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.
- Brewing stands, and anvils.
- Better physics (support doors, ladders, water, etc).
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"
.
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
version: false // false corresponds to auto version detection (that's the default), put for example "1.8.8" if you need a specific version
});
bot.on('chat', function(username, message) {
if (username === bot.username) return;
bot.chat(message);
});
bot.on('error', err => console.log(err))
You can enable some protocol debugging output using DEBUG
environment variable:
DEBUG="minecraft-protocol" node [...]
On windows :
set DEBUG=minecraft-protocol
node your_script.js
- 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
- auto-auth - chat-based bot authentication
- Armor Manager - automatic armor managment
- Bloodhound - determine who and what is responsible for damage to another entity
- tps - get the current tps (processed tps)
- rom1504/rbot
- 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. https://bot.ezcha.net/
- Chaoscraft - Minecraft bot using genetic algorithms, see its youtube videos
npm install mineflayer
- See docs/api.md.
- See docs/history.md.
- See examples/.
- See docs/unstable_api.md.
- See docs/contribute.md.
Please read https://github.com/PrismarineJS/prismarine-contribute
Some setup is required after first cloning the project but after that is done it's very easy to run them.
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.
Simply run: npm test
- 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.