/mineflayer-collectblock

A simple utility plugin for Mineflayer that add a higher level API for collecting blocks.

Primary LanguageTypeScriptMIT LicenseMIT

mineflayer-collectblock

A small utility plugin for allowing users to collect blocks using a higher level API.


Showcase

You can see a video of the plugin in action, here. The source code of the bot in the video can be seen in the examples folder, here.

Getting Started

This plugin is built using Node and can be installed using:

npm install --save mineflayer-collectblock

Simple Bot

The brief description goes here.

// Create your bot
const mineflayer = require("mineflayer")
const bot = mineflayer.createBot({
  host: 'localhost',
  username: 'Player',
})
let mcData

// Load collect block
bot.loadPlugin(require('mineflayer-collectblock').plugin)

async function collectGrass() {
  // Find a nearby grass block
  const grass = bot.findBlock({
    matching: mcData.blocksByName.grass_block.id,
    maxDistance: 64
  })

  if (grass) {
    // If we found one, collect it.
    try {
      await bot.collectBlock.collect(grass)
      collectGrass() // Collect another grass block
    } catch (err) {
      console.log(err) // Handle errors, if any
    }
  }
}

// On spawn, start collecting all nearby grass
bot.once('spawn', () => {
  mcData = require('minecraft-data')(bot.version)
  collectGrass()
})

Documentation

API

Examples

License

This project uses the MIT license.

Contributions

This project is accepting PRs and Issues. See something you think can be improved? Go for it! Any and all help is highly appreciated!

For larger changes, it is recommended to discuss these changes in the issues tab before writing any code. It's also preferred to make many smaller PRs than one large one, where applicable.