node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



A Node.js Minecraft bot that helps you out by performing menial tasks.

Current Project Status

Supports Minecraft 1.4.7

Available In-game Commands

You can give a bot a command by talking in chat, or in whispered chat. You can direct a specific bot in chat by speaking their name first, e.g. "helperbot, come".

  • come - Make the bot come to your current location.
  • echo message - Repeat the given 'message' into chat.
  • find block name - Make the bot find the coordinates of the nearest 'block name' block.
  • follow [username] - Start following a player.
  • follow.stop - Stop following players.
  • give username [count] block name - Make the bot /give 'username' 'count' of a given block.
  • gimme [count] block name - Make the bot /give you 'count' of a given block.
  • help command - Gives help on a given command.
  • list - List the bot's inventory.
  • masters [add/rm username] - Display the bot's list of masters, or add/remove a master.
  • mine block name - Start mining 'block name'. You can add multiple target blocks.
  • mine.resume - Resume mining after an interruption.
  • mine.status - Display information about the current mining job.
  • mine.stop - Stop mining.
  • quiet mode [on/off] - Enable/disable quiet mode.
  • quit - Make the bot leave the server.
  • strip - Start strip mining whatever chunk the bot is in.
  • strip.stop - Stop strip mining.
  • toss [player] [count] [item name] - Toss 'player' 'count' items that match 'item name'.


Usage: node helperbot.js [SERVER] [USERNAME] [OPTIONS]
Connect a mineflayer bot to SERVER as USERNAME.
By default connects 'helperbot' to localhost.
      --help               display this help and exit
      -l, --login          prompt for credentials and login to
      --password=PASSWORD  connect to with the given PASSWORD
      -p, --port=PORT      connect to the given port (defaults to 25565)
      --masters=usr1,...   set the bot's masters to usr1, ...
  • Example online mode:
helperbot server username --password=12345678
  • Example online mode #2:
helperbot server --login
  • Example offline mode:
helperbot server


npm install -g helperbot