mindcraft/utils/skills.js

import { getItemId } from "./mcdata.js";
import { getCraftingTable, getInventoryCounts, getInventoryStacks, getNearbyMobs, getNearbyBlocks } from "./world.js";
import pf from 'mineflayer-pathfinder';


/**
 * Attempt to craft the given item.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {string} item_name, the item name to craft.
 * @returns {Promise<boolean>} true if the item was crafted, false otherwise.
 * @example
 * await skills.craftItem(bot, "wooden_pickaxe");
 **/
export async function craftItem(bot, itemName) {
    const table = getCraftingTable(bot);
    let recipes = bot.recipesFor(getItemId(itemName), null, 1, table);
    await bot.craft(recipes[0], 1, null);
    return true;
}


/**
 * Attack mob of the given type.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {string} mobType, the type of mob to attack.
 * @returns {Promise<boolean>} true if the mob was attacked, false if the mob type was not found.
 * @example
 * await skills.attackMob(bot, "zombie");
 **/
export async function attackMob(bot, mobType) {
    const mobs = getNearbyMobs(bot);
    for (let i = 0; i < mobs.length; i++) {
        if (mobs[i].mobType == mobType) {
            bot.attack(mobs[i]);
            return true;
        }
    }
    return false;
}


/**
 * Collect one of the given block type.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {string} blockType, the type of block to collect.
 * @returns {Promise<boolean>} true if the block was collected, false if the block type was not found.
 * @example
 * await skills.collectBlock(bot, "oak_log");
 **/
export async function collectBlock(bot, blockType) {
    const blocks = getNearbyBlocks(bot);
    for (let i = 0; i < blocks.length; i++) {
        if (blocks[i].name == blockType) {
            await bot.collectBlock.collect(blocks[i]);
            return true;
        }
    }
    return false;
}


/**
 * Break the block at the given position. Will use the bot's equipped item.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {number} x, the x coordinate of the block to break.
 * @param {number} y, the y coordinate of the block to break.
 * @param {number} z, the z coordinate of the block to break.
 * @returns {Promise<boolean>} true if the block was broken, false otherwise.
 * @example
 * let position = getPosition(bot);
 * await skills.breakBlockAt(bot, position.x, position.y - 1, position.x);
 **/
export async function breakBlockAt(bot, x, y, z) {
    let current = bot.blockAt({ x: x, y: y, z: z });
    if (current.name != 'air')
        await bot.dig(current, true);
    return true;
}


/**
 * Place the given block type at the given position.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {string} blockType, the type of block to place.
 * @param {number} x, the x coordinate to place the block at.
 * @param {number} y, the y coordinate to place the block at.
 * @param {number} z, the z coordinate to place the block at.
 * @returns {Promise<boolean>} true if the block was placed, false otherwise.
 * @example
 * let position = getPosition(bot);
 * await skills.placeBlock(bot, "oak_log", position.x + 1, position.y, position.x);
 **/
export async function placeBlock(bot, blockType, x, y, z) {

    let referenceBlock = null;
    let refVec = null;
    if (bot.blockAt({ x: x + 1, y: y, z: z }).name != "air") {
        referenceBlock = bot.blockAt({ x: x + 1, y: y, z: z });
        refVec = { x: x - 1, y: y, z: z };
    } else if (bot.blockAt({ x: x - 1, y: y, z: z }).name != "air") {
        referenceBlock = bot.blockAt({ x: x - 1, y: y, z: z });
        refVec = { x: x + 1, y: y, z: z };
    } else if (bot.blockAt({ x: x, y: y + 1, z: z }).name != "air") {
        referenceBlock = bot.blockAt({ x: x, y: y + 1, z: z });
        refVec = { x: x, y: y - 1, z: z };
    } else if (bot.blockAt({ x: x, y: y - 1, z: z }).name != "air") {
        referenceBlock = bot.blockAt({ x: x, y: y - 1, z: z });
        refVec = { x: x, y: y + 1, z: z };
    } else if (bot.blockAt({ x: x, y: y, z: z + 1 }).name != "air") {
        referenceBlock = bot.blockAt({ x: x, y: y, z: z + 1 });
        refVec = { x: x, y: y, z: z - 1 };
    } else if (bot.blockAt({ x: x, y: y, z: z - 1 }).name != "air") {
        referenceBlock = bot.blockAt({ x: x, y: y, z: z - 1 });
        refVec = { x: x, y: y, z: z + 1 };
    } else {
        return false;
    }

    let block = null;
    for (let stack of getInventoryStacks(bot)) {
        if (stack.name == blockType) {
            block = stack;
            break;
        }
    }
    if (block == null)
        return false;

    breakBlockAt(bot, x, y, z);
    await bot.equip(block, 'hand');
    await bot.placeBlock(referenceBlock, refVec);
    return true;
}


/**
 * Equip the given item or block.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {string} itemName, the item or block name to equip.
 * @returns {Promise<boolean>} true if the item was equipped, false otherwise.
 * @example
 * await skills.equipItem(bot, "wooden_pickaxe");
 **/
export async function equipItem(bot, itemName) {
    let item = null;
    for (let stack of getInventoryStacks(bot)) {
        if (stack.name == itemName) {
            item = stack;
            break;
        }
    }
    if (item == null)
        return false;
    await bot.equip(item, 'hand');
    return true;
}


/**
 * Navigate to the given position.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {number} x, the x coordinate to navigate to. If null, the bot's current x coordinate will be used.
 * @param {number} y, the y coordinate to navigate to. If null, the bot's current y coordinate will be used.
 * @param {number} z, the z coordinate to navigate to. If null, the bot's current z coordinate will be used.
 * @returns {Promise<boolean>} true if the position was reached, false otherwise.
 * @example
 * let position = getPosition(bot);
 * await skills.goToPosition(bot, position.x, position.y, position.x + 20);
 **/
export async function goToPosition(bot, x, y, z) {
    if (x == null) x = bot.entity.position.x;
    if (y == null) y = bot.entity.position.y;
    if (z == null) z = bot.entity.position.z;
    bot.pathfinder.setMovements(new pf.Movements(bot));
    let pos = { x: x, y: y, z: z };
    bot.pathfinder.setGoal(new pf.goals.GoalNear(pos.x, pos.y, pos.z, 1));
    return true;
}


/**
 * Give one of the specified item to the specified player
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {string} itemType, the name of the item to give.
 * @param {string} username, the username of the player to give the item to.
 * @returns {Promise<boolean>} true if the item was given, false otherwise.
 * @example
 * await skills.giveToPlayer(bot, "oak_log", "player1");
 **/
export async function giveToPlayer(bot, itemType, username) {
    let player = bot.players[username].entity
    if (!player)
        return false;
    if (getInventoryCounts(bot)[itemType] == 0)
        return false;
    goToPlayer(bot, username);
    let pos = player.position;
    await bot.lookAt(pos);
    await bot.toss(getItemId(itemType), null, 1);
    return true;
}


/**
 * Navigate to the given player.
 * @param {MinecraftBot} bot, reference to the minecraft bot.
 * @param {string} username, the username of the player to navigate to.
 * @returns {Promise<boolean>} true if the player was found, false otherwise.
 * @example
 * await skills.goToPlayer(bot, "player");
 **/
export async function goToPlayer(bot, username) {
    let player = bot.players[username].entity
    if (!player)
        return false;

    bot.pathfinder.setMovements(new pf.Movements(bot));
    let pos = player.position;
    bot.pathfinder.setGoal(new pf.goals.GoalNear(pos.x, pos.y, pos.z, 3));
    return true;
}