Mineflayer Toolbox

A set of tools aiming to make your anarchy experience with your bot better with some useful modules based off popular hack clients.

Current modules (not all are documented yet):

Auto Totem
Auto Armor
Auto Eating
Spammer
Filespammer
AntiAFK
Greeter
Velocity
Chatlogger
Confighandler

All features are toggleable and execute actions on every physicsTick.

Features

Auto Totem (`bot.autototem(action, hand)`)

Automatically equips a Totem of Undying in the desired hand when none is equipped.

Arguments:

action – "on" to activate, "off" to deactivate
hand – "mainhand" or "offhand" (optional, defaults to "offhand")

Behavior:

Checks if the offhand (slot 45) is empty.
If a totem is found in inventory, it equips it in the selected hand.

Spammer (`bot.spammer(action, message, delay)` and `bot.filespammer(action, file, order, delay`)

Automatically spams set messages or file content

Spammer Arguments:

action – "on" to activate, "off" to deactivate
message – The message that gets spammed
delay – The delay messages will be spammed in ms. (Do not go under 300 or the bot will most likely get kicked)

Filespammer Arguments:

action – "on" to activate, "off" to deactivate
file – MUST BE IN THE SAME DIRECTORY AS THE BOT The file with the messages. It should be a txt and every message should have its own line.
order – "random" random order, "first" first to last, "last" last to first
delay – The delay messages will be spammed in ms. (Do not go under 300 or the bot will most likely get kicked)

Behavior:

Spams either the set message or the file in the set delay.

Auto Armor (`bot.autoarmor(action)`)

Automatically equips the best armor available in the bot’s inventory.

Arguments:

action – "on" to activate, "off" to deactivate

Behavior:

Compares currently equipped armor to what's available in the inventory.
Equips higher-tier armor when found (e.g., diamond > iron).
Tosses worse duplicates to free up space.

Auto Eat (`bot.autoeat(action)`)

Automatically eats when the bot’s hunger drops below 18.

Arguments:

action – "on" to activate, "off" to deactivate

Behavior:

Prioritizes high-quality food (cooked_meat types).
If no good food is found, falls back to any other edible items.

Usage Example

const mineflayer = require('mineflayer');
const toolbox = require('mineflayer-toolbox');

const bot = mineflayer.createBot({
  host: 'localhost',
  port: 25565,
  username: 'Bot'
});

bot.loadPlugin(toolbox);

bot.once('spawn', () => {
  bot.autototem('on', 'offhand');
  bot.autoarmor('on');
  bot.autoeat('on');
});