mineflayer 4.3.0 → 4.4.0

package/README.md

@@ -238,4 +238,4 @@ Run `npm run mocha_test -- -g <test_name>`, where `<test_name>` is a name of the
 
 ## License
 
-[MIT](LICENSE)
+[MIT](/LICENSE)

package/docs/README.md

@@ -238,4 +238,4 @@ Run `npm run mocha_test -- -g <test_name>`, where `<test_name>` is a name of the
 
 ## License
 
-[MIT](LICENSE)
+[MIT](/LICENSE)

package/docs/api.md

@@ -244,6 +244,7 @@
       - [bot.waitForChunksToLoad()](#botwaitforchunkstoload)
       - [bot.blockInSight(maxSteps, vectorLength)](#botblockinsightmaxsteps-vectorlength)
       - [bot.blockAtCursor(maxDistance=256)](#botblockatcursormaxdistance256)
+      - [bot.entityAtCursor(maxDistance = 3.5)](#botentityatcursormaxdistance35)
       - [bot.blockAtEntityCursor(entity=bot.entity, maxDistance=256)](#botblockatentitycursorentitybotentity-maxdistance256)
       - [bot.canSeeBlock(block)](#botcanseeblockblock)
       - [bot.findBlocks(options)](#botfindblocksoptions)
@@ -288,7 +289,7 @@
       - [bot.denyResourcePack()](#botdenyresourcepack)
       - [bot.placeBlock(referenceBlock, faceVector)](#botplaceblockreferenceblock-facevector)
       - [bot.placeEntity(referenceBlock, faceVector)](#botplaceentityreferenceblock-facevector)
-      - [bot.activateBlock(block)](#botactivateblockblock)
+      - [bot.activateBlock(block, direction?: Vec3, cursorPos?: Vec3)](#botactivateblockblock-direction-vec3-cursorpos-vec3)
       - [bot.activateEntity(entity)](#botactivateentityentity)
       - [bot.activateEntityAt(entity, position)](#botactivateentityatentity-position)
       - [bot.consume()](#botconsume)
@@ -304,8 +305,8 @@
       - [bot.setQuickBarSlot(slot)](#botsetquickbarslotslot)
       - [bot.craft(recipe, count, craftingTable)](#botcraftrecipe-count-craftingtable)
       - [bot.writeBook(slot, pages)](#botwritebookslot-pages)
-      - [bot.openContainer(containerBlock or containerEntity)](#botopencontainercontainerblock-or-containerentity)
-      - [bot.openChest(chestBlock or minecartchestEntity)](#botopenchestchestblock-or-minecartchestentity)
+      - [bot.openContainer(containerBlock or containerEntity, direction?, cursorPos?)](#botopencontainercontainerblock-or-containerentity-direction-cursorpos)
+      - [bot.openChest(chestBlock or minecartchestEntity, direction?, cursorPos?)](#botopenchestchestblock-or-minecartchestentity-direction-cursorpos)
       - [bot.openFurnace(furnaceBlock)](#botopenfurnacefurnaceblock)
       - [bot.openDispenser(dispenserBlock)](#botopendispenserdispenserblock)
       - [bot.openEnchantmentTable(enchantmentTableBlock)](#botopenenchantmenttableenchantmenttableblock)
@@ -321,7 +322,7 @@
       - [bot.putAway(slot)](#botputawayslot)
       - [bot.closeWindow(window)](#botclosewindowwindow)
       - [bot.transfer(options)](#bottransferoptions)
-      - [bot.openBlock(block)](#botopenblockblock)
+      - [bot.openBlock(block, direction?: Vec3, cursorPos?: Vec3)](#botopenblockblock-direction-vec3-cursorpos-vec3)
       - [bot.openEntity(entity)](#botopenentityentity)
       - [bot.moveSlotItem(sourceSlot, destSlot)](#botmoveslotitemsourceslot-destslot)
       - [bot.updateHeldItem()](#botupdatehelditem)
@@ -453,7 +454,7 @@ See [prismarine-recipe](https://github.com/PrismarineJS/prismarine-recipe)
 ### mineflayer.Container
 
 Extends windows.Window for chests, dispensers, etc...
-See `bot.openChest(chestBlock or minecartchestEntity)`.
+See `bot.openContainer(chestBlock or minecartchestEntity)`.
 
 ### mineflayer.Furnace
 
@@ -1321,19 +1322,21 @@ Fires when a note block goes off somewhere.
 * `isOpen`: number of players that have the chest open. 0 if it's closed
 * `block2`: a Block instance, the other half of the block whose lid opened. null if it's not a double chest
 
-#### "blockBreakProgressObserved" (block, destroyStage)
+#### "blockBreakProgressObserved" (block, destroyStage, entity)
 
 Fires when the client observes a block in the process of being broken.
 
  * `block`: a Block instance, the block being broken
  * `destroyStage`: integer corresponding to the destroy progress (0-9)
+ * `entity`: the entity which is breaking the block.
 
-#### "blockBreakProgressEnd" (block)
+#### "blockBreakProgressEnd" (block, entity)
 
 Fires when the client observes a block stops being broken.
 This occurs whether the process was completed or aborted.
 
  * `block`: a Block instance, the block no longer being broken
+ * `entity`: the entity which has stopped breaking the block
 
 #### "diggingCompleted" (block)
 
@@ -1477,6 +1480,11 @@ Returns the block at which bot is looking at or `null`
 Returns the block at which bot is looking at or `null`
  * `maxDistance` - The maximum distance the block can be from the eye, defaults to 256.
 
+#### bot.entityAtCursor(maxDistance=3.5)
+
+Returns the entity at which bot is looking at or `null`
+ * `maxDistance` - The maximum distance the entity can be from the eye, defaults to 3.5.
+
 #### bot.blockAtEntityCursor(entity=bot.entity, maxDistance=256)
 
 Returns the block at which specific entity is looking at or `null`
@@ -1820,13 +1828,15 @@ This function returns a `Promise`, with `Entity` as its argument upon completion
 
 The new block will be placed at `referenceBlock.position.plus(faceVector)`.
 
-#### bot.activateBlock(block)
+#### bot.activateBlock(block, direction?: Vec3, cursorPos?: Vec3)
 
 This function returns a `Promise`, with `void` as its argument upon completion.
 
 Punch a note block, open a door, etc.
 
  * `block` - the block to activate
+ * `direction` Optional defaults to `new Vec3(0, 1, 0)` (up). A vector off the direction the container block should be interacted with. Does nothing when a container entity is targeted.
+ * `cursorPos` Optional defaults to `new Vec3(0.5, 0.5, 0.5)` (block center). The curos position when opening the block instance. This is send with the activate block packet. Does nothing when a container entity is targeted.
 
 #### bot.activateEntity(entity)
 
@@ -1927,11 +1937,16 @@ This function returns a `Promise`, with `void` as its argument when the writing
  * `slot` is in inventory window coordinates (where 36 is the first quickbar slot, etc.).
  * `pages` is an array of strings represents the pages.
 
-#### bot.openContainer(containerBlock or containerEntity)
+#### bot.openContainer(containerBlock or containerEntity, direction?, cursorPos?)
+Opens a block container or entity.
+
+ * `containerBlock` or `containerEntity` The block instance to open or the entity to open.
+ * `direction` Optional defaults to `new Vec3(0, 1, 0)` (up). A vector off the direction the container block should be interacted with. Does nothing when a container entity is targeted.
+ * `cursorPos` Optional defaults to `new Vec3(0.5, 0.5, 0.5)` (block center). The curos position when opening the block instance. This is send with the activate block packet. Does nothing when a container entity is targeted.
 
 Returns a promise on a `Container` instance which represents the container you are opening.
 
-#### bot.openChest(chestBlock or minecartchestEntity)
+#### bot.openChest(chestBlock or minecartchestEntity, direction?, cursorPos?)
 
 Deprecated. Same as `openContainer`
 
@@ -1995,9 +2010,13 @@ These are lower level methods for the inventory, they can be useful sometimes bu
 #### bot.clickWindow(slot, mouseButton, mode)
 
 This function returns a `Promise`, with `void` as its argument upon completion.
+  
+The only valid mode option at the moment is 0. Shift clicking or mouse draging is not implemented.
 
 Click on the current window. See details at https://wiki.vg/Protocol#Click_Window
 
+Prefer using bot.simpleClick.*
+
 #### bot.putSelectedItemRange(start, end, window, slot)
 
 This function returns a `Promise`, with `void` as its argument upon completion.
@@ -2028,11 +2047,13 @@ Transfer some kind of item from one range to an other. `options` is an object co
  * `count` : the amount of items to transfer. Default: `1`
  * `nbt` : nbt data of the item to transfer. Default: `nullish` (ignores nbt)
 
-#### bot.openBlock(block)
+#### bot.openBlock(block, direction?: Vec3, cursorPos?: Vec3)
 
 Open a block, for example a chest, returns a promise on the opening `Window`.
 
- * `block` is the block the bot will open
+ * `block` is the block the bot will open.
+ * `direction` Optional defaults to `new Vec3(0, 1, 0)` (up). A vector off the direction the container block should be interacted with. Does nothing when a container entity is targeted.
+ * `cursorPos` Optional defaults to `new Vec3(0.5, 0.5, 0.5)` (block center). The curos position when opening the block instance. This is send with the activate block packet. Does nothing when a container entity is targeted.
 
 #### bot.openEntity(entity)
 

package/docs/es/api_es.md

@@ -423,7 +423,7 @@ Mira [prismarine-recipe](https://github.com/PrismarineJS/prismarine-recipe)
 ### mineflayer.Container
 
 Extiende windows.Window para cofres, dispensadores, etc...
-Mira `bot.openChest(chestBlock o minecartchestEntity)`.
+Mira `bot.openContainer(chestBlock o minecartchestEntity)`.
 
 ### mineflayer.Furnace
 

package/docs/history.md

@@ -1,3 +1,23 @@
+## 4.4.0
+
+* Fix chatterbox example not getting dropped item
+* Fix 404d link to license [#2601](https://github.com/PrismarineJS/mineflayer/pull/2601)
+* Add bot.clickWindow mode disclaimer [#2595](https://github.com/PrismarineJS/mineflayer/pull/2595)
+* Add spectator to GameMode types [#2627](https://github.com/PrismarineJS/mineflayer/pull/2627)
+* Update types for isABed [#2628](https://github.com/PrismarineJS/mineflayer/pull/2628)
+* Replace openChest with openContainer in docs and examples [#2656](https://github.com/PrismarineJS/mineflayer/pull/2656)
+* Add ender chests as a chest type [#2642](https://github.com/PrismarineJS/mineflayer/pull/2642)
+* Added method to wait until sleep function is in reality sleeping [#2617](https://github.com/PrismarineJS/mineflayer/pull/2617)
+* Added type on move event [#2712](https://github.com/PrismarineJS/mineflayer/pull/2712)
+* Added thunderState type [#2711](https://github.com/PrismarineJS/mineflayer/pull/2711)
+* Fix type error on chest open [#2684](https://github.com/PrismarineJS/mineflayer/pull/2684)
+* Add support for repeating and chain command blocks. [#2669](https://github.com/PrismarineJS/mineflayer/pull/2669)
+* Add player object to blockBreakProgressEnd & observed. [#2647](https://github.com/PrismarineJS/mineflayer/pull/2647)
+* Add entity to blockBreakProgress [#2648](https://github.com/PrismarineJS/mineflayer/pull/2648)
+* Add direction support to activateBlock, openBlock [#2039](https://github.com/PrismarineJS/mineflayer/pull/2039)
+* Add entityAtCursor function [#2077](https://github.com/PrismarineJS/mineflayer/pull/2077)
+* Fix regex dos [#2350](https://github.com/PrismarineJS/mineflayer/pull/2350)
+
 ## 4.3.0
 
 * Cache 'positionUpdateSentEveryTick' feature lookup (@IceTank)

package/docs/ru/api_ru.md

@@ -368,7 +368,7 @@
 ### mineflayer.Chest
 
 Предоставляет сеанс взаимодействия с сундуками ( Открытие и закрытие )
-Смотрите `bot.openChest(chestBlock or minecartchestEntity)`.
+Смотрите `bot.openContainer(chestBlock or minecartchestEntity)`.
 
 #### chest.window
 
@@ -1490,7 +1490,7 @@ bot.once('login', () => {
 
 #### bot.openChest(chestBlock or minecartchestEntity)
 
-Открывает сундук
+Устарело.Открывает сундук. Такой же как "openContainer"
 
 #### bot.openFurnace(furnaceBlock)
 

package/docs/zh/api.md

@@ -446,7 +446,7 @@ See [prismarine-recipe](https://github.com/PrismarineJS/prismarine-recipe)
 ### mineflayer.Container
 
 Extends windows.Window for chests, dispensers, etc...
-See `bot.openChest(chestBlock or minecartchestEntity)`.
+See `bot.openContainer(chestBlock or minecartchestEntity)`.
 
 ### mineflayer.Furnace
 

package/examples/chatterbox.js

@@ -168,9 +168,8 @@ bot.on('playerLeft', (player) => {
   bot.chat(`Bye ${player.username}`)
 })
 bot.on('playerCollect', (collector, collected) => {
-  if (collector.type === 'player' && collected.type === 'object') {
-    const rawItem = collected.metadata[10]
-    const item = mineflayer.Item.fromNotch(rawItem)
+  if (collector.type === 'player') {
+    const item = collected.getDroppedItem()
     bot.chat(`${collector.username !== bot.username ? ("I'm so jealous. " + collector.username) : 'I '} collected ${item.count} ${item.displayName}`)
   }
 })

package/examples/chest.js

@@ -103,7 +103,7 @@ async function watchChest (minecart, blocks = []) {
       return
     }
   }
-  const chest = await bot.openChest(chestToOpen)
+  const chest = await bot.openContainer(chestToOpen)
   sayItems(chest.containerItems())
   chest.on('updateSlot', (slot, oldItem, newItem) => {
     bot.chat(`chest update: ${itemToString(oldItem)} -> ${itemToString(newItem)} (slot: ${slot})`)

package/examples/discord.js

@@ -21,7 +21,7 @@ const {
 const intents = new Intents(['GUILDS', 'GUILD_MESSAGES'])
 // Create Discord client
 const client = new Client({
-  intents: intents
+  intents
 })
 
 let channel = process.argv[3]

package/index.d.ts

@@ -126,7 +126,7 @@ interface BotEvents {
   blockBreakProgressEnd: (block: Block) => Promise<void> | void
   diggingCompleted: (block: Block) => Promise<void> | void
   diggingAborted: (block: Block) => Promise<void> | void
-  move: () => Promise<void> | void
+  move: (position: Vec3) => Promise<void> | void
   forcedMove: () => Promise<void> | void
   mount: () => Promise<void> | void
   dismount: (vehicle: Entity) => Promise<void> | void
@@ -165,6 +165,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
   player: Player
   players: { [username: string]: Player }
   isRaining: boolean
+  thunderState: number
   chatPatterns: ChatPattern[]
   settings: GameSettings
   experience: Experience
@@ -249,7 +250,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   sleep: (bedBlock: Block) => Promise<void>
 
-  isABed: (bedBlock: Block) => void
+  isABed: (bedBlock: Block) => boolean
 
   wake: () => Promise<void>
 
@@ -298,7 +299,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   placeEntity: (referenceBlock: Block, faceVector: Vec3) => Promise<Entity>
 
-  activateBlock: (block: Block) => Promise<void>
+  activateBlock: (block: Block, direction?: Vec3, cursorPos?: Vec3) => Promise<void>
 
   activateEntity: (block: Entity) => Promise<void>
 
@@ -337,9 +338,9 @@ export interface Bot extends TypedEmitter<BotEvents> {
     pages: string[]
   ) => Promise<void>
 
-  openContainer: (chest: Block | Entity) => Promise<Chest | Furnace | Dispenser>
+  openContainer: (chest: Block | Entity, direction?: Vec3, cursorPos?: Vec3) => Promise<Chest | Furnace | Dispenser>
 
-  openChest: (chest: Block | Entity) => Promise<Chest>
+  openChest: (chest: Block | Entity, direction?: number, cursorPos?: Vec3) => Promise<Chest>
 
   openFurnace: (furnace: Block) => Promise<Furnace>
 
@@ -380,7 +381,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   transfer: (options: TransferOptions) => Promise<void>
 
-  openBlock: (block: Block, Class: new () => EventEmitter) => Promise<void>
+  openBlock: (block: Block, direction?: Vec3, cursorPos?: Vec3) => Promise<void>
 
   openEntity: (block: Entity, Class: new () => EventEmitter) => Promise<void>
 
@@ -444,7 +445,7 @@ export type LevelType =
   | 'customized'
   | 'buffet'
   | 'default_1_1'
-export type GameMode = 'survival' | 'creative' | 'adventure'
+export type GameMode = 'survival' | 'creative' | 'adventure' | 'spectator'
 export type Dimension = 'minecraft:nether' | 'minecraft:overworld' | 'minecraft:end'
 export type Difficulty = 'peaceful' | 'easy' | 'normal' | 'hard'
 

package/lib/plugins/bed.js

@@ -146,10 +146,25 @@ function inject (bot) {
         }
       }
 
-      await bot.activateBlock(bedBlock)
+      bot.activateBlock(bedBlock)
+
+      await waitUntilSleep()
     }
   }
 
+  async function waitUntilSleep () {
+    return new Promise((resolve, reject) => {
+      const timeoutForSleep = setTimeout(() => {
+        reject(new Error('bot is not sleeping'))
+      }, 3000)
+
+      bot.once('sleep', () => {
+        clearTimeout(timeoutForSleep)
+        resolve()
+      })
+    })
+  }
+
   bot._client.on('game_state_change', (packet) => {
     if (packet.reason === 0) {
       // occurs when you can't spawn in your bed and your spawn point gets reset

package/lib/plugins/block_actions.js

@@ -44,7 +44,7 @@ function inject (bot) {
       const perpendicularCardinals = Object.keys(FACING_MAP[facing])
       for (const cardinal of perpendicularCardinals) {
         const cardinalOffset = CARDINALS[cardinal]
-        if (bot.blockAt(chestBlock.position.plus(cardinalOffset)).type === chestBlock.type) {
+        if (bot.blockAt(chestBlock.position.plus(cardinalOffset))?.type === chestBlock.type) {
           return FACING_MAP[cardinal][facing]
         }
       }
@@ -100,13 +100,14 @@ function inject (bot) {
     const destroyStage = packet.destroyStage
     const pt = new Vec3(packet.location.x, packet.location.y, packet.location.z)
     const block = bot.blockAt(pt)
+    const entity = bot.entities[packet.entityId]
 
     if (destroyStage < 0 || destroyStage > 9) {
       // http://wiki.vg/Protocol#Block_Break_Progress
       // "0-9 to set it, any other value to remove it"
-      bot.emit('blockBreakProgressEnd', block)
+      bot.emit('blockBreakProgressEnd', block, entity)
     } else {
-      bot.emit('blockBreakProgressObserved', block, destroyStage)
+      bot.emit('blockBreakProgressObserved', block, destroyStage, entity)
     }
   })
 }

package/lib/plugins/chat.js

@@ -173,7 +173,7 @@ function inject (bot, options) {
 
   function addDefaultPatterns () {
     if (!defaultChatPatterns) return
-    const USERNAME_REGEX = '(?:\\(.+\\)|\\[.+\\]|.)*?(\\w+)'
+    const USERNAME_REGEX = '(?:\\(.{1,15}\\)|\\[.{1,15}\\]|.){0,5}?(\\w+)'
     bot.addChatPattern('whisper', new RegExp(`^${USERNAME_REGEX} whispers(?: to you)?:? (.*)$`), { deprecated: true })
     bot.addChatPattern('whisper', new RegExp(`^\\[${USERNAME_REGEX} -> \\w+\\s?\\] (.*)$`), { deprecated: true })
     bot.addChatPattern('chat', new RegExp(`^${USERNAME_REGEX}\\s?[>:\\-»\\]\\)~]+\\s(.*)$`), { deprecated: true })

package/lib/plugins/chest.js

@@ -1,8 +1,9 @@
+const { Vec3 } = require('vec3')
 
 module.exports = inject
 
 function inject (bot) {
-  const allowedWindowTypes = ['minecraft:generic', 'minecraft:chest', 'minecraft:dispenser', 'minecraft:shulker_box', 'minecraft:hopper', 'minecraft:container', 'minecraft:dropper', 'minecraft:trapped_chest']
+  const allowedWindowTypes = ['minecraft:generic', 'minecraft:chest', 'minecraft:dispenser', 'minecraft:ender_chest', 'minecraft:shulker_box', 'minecraft:hopper', 'minecraft:container', 'minecraft:dropper', 'minecraft:trapped_chest']
 
   function matchWindowType (window) {
     for (const type of allowedWindowTypes) {
@@ -11,10 +12,12 @@ function inject (bot) {
     return false
   }
 
-  async function openContainer (containerToOpen) {
+  async function openContainer (containerToOpen, direction, cursorPos) {
+    direction = direction ?? new Vec3(0, 1, 0)
+    cursorPos = cursorPos ?? new Vec3(0.5, 0.5, 0.5)
     let chest
     if (containerToOpen.constructor.name === 'Block' && allowedWindowTypes.map(name => name.replace('minecraft:', '')).includes(containerToOpen.name)) {
-      chest = await bot.openBlock(containerToOpen)
+      chest = await bot.openBlock(containerToOpen, direction, cursorPos)
     } else if (containerToOpen.constructor.name === 'Entity') {
       chest = await bot.openEntity(containerToOpen)
     } else {

package/lib/plugins/command_block.js

@@ -8,7 +8,7 @@ function inject (bot) {
     assert.strictEqual(bot.player.gamemode, 1, new Error('The bot has to be in creative mode to open the command block window'))
     assert.notStrictEqual(pos, null)
     assert.notStrictEqual(command, null)
-    assert.strictEqual(bot.blockAt(pos).name, 'command_block', new Error("The block isn't a command block"))
+    assert.strictEqual(bot.blockAt(pos).name.includes('command_block'), true, new Error("The block isn't a command block"))
 
     // Default values when a command block is placed in vanilla minecraft
     options.trackOutput = options.trackOutput ?? false

package/lib/plugins/creative.js

@@ -11,7 +11,7 @@ function inject (bot) {
   // these features only work when you are in creative mode.
   bot.creative = {
     setInventorySlot,
-    flyTo: flyTo,
+    flyTo,
     startFlying,
     stopFlying,
     clearSlot: slotNum => setInventorySlot(slotNum, null),

package/lib/plugins/entities.js

@@ -569,7 +569,7 @@ function inject (bot) {
   function moveVehicle (left, forward) {
     bot._client.write('steer_vehicle', {
       sideways: left,
-      forward: forward,
+      forward,
       jump: 0x01
     })
   }

package/lib/plugins/inventory.js

@@ -150,45 +150,48 @@ function inject (bot, { hideErrors }) {
     }
   }
 
-  async function activateBlock (block) {
+  async function activateBlock (block, direction, cursorPos) {
+    direction = direction ?? new Vec3(0, 1, 0)
+    const directionNum = vectorToDirection(direction) // The packet needs a number as the direction
+    cursorPos = cursorPos ?? new Vec3(0.5, 0.5, 0.5)
     // TODO: tell the server that we are not sneaking while doing this
     await bot.lookAt(block.position.offset(0.5, 0.5, 0.5), false)
     // place block message
     if (bot.supportFeature('blockPlaceHasHeldItem')) {
       bot._client.write('block_place', {
         location: block.position,
-        direction: 1,
+        direction: directionNum,
         heldItem: Item.toNotch(bot.heldItem),
-        cursorX: 8,
-        cursorY: 8,
-        cursorZ: 8
+        cursorX: cursorPos.scaled(16).x,
+        cursorY: cursorPos.scaled(16).y,
+        cursorZ: cursorPos.scaled(16).z
       })
     } else if (bot.supportFeature('blockPlaceHasHandAndIntCursor')) {
       bot._client.write('block_place', {
         location: block.position,
-        direction: 1,
+        direction: directionNum,
         hand: 0,
-        cursorX: 8,
-        cursorY: 8,
-        cursorZ: 8
+        cursorX: cursorPos.scaled(16).x,
+        cursorY: cursorPos.scaled(16).y,
+        cursorZ: cursorPos.scaled(16).z
       })
     } else if (bot.supportFeature('blockPlaceHasHandAndFloatCursor')) {
       bot._client.write('block_place', {
         location: block.position,
-        direction: 1,
+        direction: directionNum,
         hand: 0,
-        cursorX: 0.5,
-        cursorY: 0.5,
-        cursorZ: 0.5
+        cursorX: cursorPos.x,
+        cursorY: cursorPos.y,
+        cursorZ: cursorPos.z
       })
     } else if (bot.supportFeature('blockPlaceHasInsideBlock')) {
       bot._client.write('block_place', {
         location: block.position,
-        direction: 1,
+        direction: directionNum,
         hand: 0,
-        cursorX: 0.5,
-        cursorY: 0.5,
-        cursorZ: 0.5,
+        cursorX: cursorPos.x,
+        cursorY: cursorPos.y,
+        cursorZ: cursorPos.z,
         insideBlock: false
       })
     }
@@ -325,7 +328,7 @@ function inject (bot, { hideErrors }) {
     }
     window.deposit = async (itemType, metadata, count, nbt) => {
       const options = {
-        window: window,
+        window,
         itemType,
         metadata,
         count,
@@ -339,8 +342,8 @@ function inject (bot, { hideErrors }) {
     }
   }
 
-  async function openBlock (block) {
-    bot.activateBlock(block)
+  async function openBlock (block, direction, cursorPos) {
+    bot.activateBlock(block, direction, cursorPos)
     const [window] = await once(bot, 'windowOpen')
     extendWindow(window)
     return window
@@ -433,7 +436,7 @@ function inject (bot, { hideErrors }) {
     if (click === undefined || !windowClickQueue.some(clicks => clicks.id === actionId)) {
       // mimic vanilla client and send a rejection for faulty transaction packets
       bot._client.write('transaction', {
-        windowId: windowId,
+        windowId,
         action: actionId,
         accepted: true
         // bot.emit(`confirmTransaction${click.id}`, false)
@@ -513,7 +516,7 @@ function inject (bot, { hideErrors }) {
         slot,
         mouseButton,
         mode,
-        changedSlots: changedSlots,
+        changedSlots,
         cursorItem: Item.toNotch(window.selectedItem)
       })
     } else if (bot.supportFeature('actionIdUsed')) { // <= 1.16.5
@@ -531,7 +534,7 @@ function inject (bot, { hideErrors }) {
         slot,
         mouseButton,
         mode,
-        changedSlots: changedSlots,
+        changedSlots,
         cursorItem: Item.toNotch(window.selectedItem)
       })
     }
@@ -641,6 +644,28 @@ function inject (bot, { hideErrors }) {
     bot.emit(`setWindowItems:${window.id}`)
   })
 
+  /**
+   * Convert a vector direction to minecraft packet number direction
+   * @param {Vec3} v
+   * @returns {number}
+   */
+  function vectorToDirection (v) {
+    if (v.y < 0) {
+      return 0
+    } else if (v.y > 0) {
+      return 1
+    } else if (v.z < 0) {
+      return 2
+    } else if (v.z > 0) {
+      return 3
+    } else if (v.x < 0) {
+      return 4
+    } else if (v.x > 0) {
+      return 5
+    }
+    assert.ok(false, `invalid direction vector ${v}`)
+  }
+
   bot.activateBlock = activateBlock
   bot.activateEntity = activateEntity
   bot.activateEntityAt = activateEntityAt

package/lib/plugins/ray_trace.js

@@ -1,4 +1,5 @@
 const { Vec3 } = require('vec3')
+const { RaycastIterator } = require('prismarine-world').iterators
 
 module.exports = (bot) => {
   function getViewDirection (pitch, yaw) {
@@ -24,6 +25,41 @@ module.exports = (bot) => {
     return bot.world.raycast(eyePosition, viewDirection, maxDistance, matcher)
   }
 
+  bot.entityAtCursor = (maxDistance = 3.5) => {
+    const block = bot.blockAtCursor(maxDistance)
+    maxDistance = block?.intersect.distanceTo(bot.entity.position) ?? maxDistance
+
+    const entities = Object.values(bot.entities)
+      .filter(entity => entity.type !== 'object' && entity.username !== bot.username && entity.position.distanceTo(bot.entity.position) <= maxDistance)
+
+    const dir = new Vec3(-Math.sin(bot.entity.yaw) * Math.cos(bot.entity.pitch), Math.sin(bot.entity.pitch), -Math.cos(bot.entity.yaw) * Math.cos(bot.entity.pitch))
+    const iterator = new RaycastIterator(bot.entity.position.offset(0, bot.entity.height, 0), dir.normalize(), maxDistance)
+
+    let targetEntity = null
+    let targetDist = maxDistance
+
+    for (let i = 0; i < entities.length; i++) {
+      const entity = entities[i]
+      const w = entity.width / 2
+
+      const shapes = [[-w, 0, -w, w, entity.height + (entity.type === 'player' ? 0.18 : 0), w]]
+      const intersect = iterator.intersect(shapes, entity.position)
+      if (intersect) {
+        const entityDir = entity.position.minus(bot.entity.position) // Can be combined into 1 line
+        const sign = Math.sign(entityDir.dot(dir))
+        if (sign !== -1) {
+          const dist = bot.entity.position.distanceTo(intersect.pos)
+          if (dist < targetDist) {
+            targetEntity = entity
+            targetDist = dist
+          }
+        }
+      }
+    }
+
+    return targetEntity
+  }
+
   bot.blockAtEntityCursor = (entity = bot.entity, maxDistance = 256, matcher = null) => {
     if (!entity.position || !entity.height || !entity.pitch || !entity.yaw) return null
     const { position, height, pitch, yaw } = entity

package/lib/plugins/settings.js

@@ -58,7 +58,7 @@ function inject (bot, options) {
       viewDistance: viewDistanceBits,
       chatFlags: chatBits,
       chatColors: bot.settings.colorsEnabled,
-      skinParts: skinParts,
+      skinParts,
       mainHand: handBits,
       enableTextFiltering: bot.settings.enableTextFiltering,
       enableServerListing: bot.settings.enableServerListing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mineflayer",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "description": "create minecraft bots with a stable, high level API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -8,8 +8,8 @@
     "mocha_test": "mocha --reporter spec --exit",
     "test": "npm run mocha_test",
     "pretest": "npm run lint",
-    "lint": "standard && ts-standard *.d.ts && standard-markdown",
-    "fix": "standard --fix && ts-standard --fix *.d.ts && standard-markdown --fix",
+    "lint": "standard && standard-markdown",
+    "fix": "standard --fix && standard-markdown --fix",
     "prepublishOnly": "cp docs/README.md README.md"
   },
   "repository": {
@@ -40,14 +40,13 @@
     "vec3": "^0.1.7"
   },
   "devDependencies": {
-    "@types/node": "^17.0.0",
+    "@types/node": "^18.0.6",
     "doctoc": "^2.0.1",
     "minecraft-wrap": "^1.3.0",
     "mineflayer": "file:.",
-    "mocha": "^9.1.2",
-    "standard": "^16.0.4",
+    "mocha": "^10.0.0",
+    "standard": "^17.0.0",
     "standard-markdown": "^7.1.0",
-    "ts-standard": "^11.0.0",
     "typescript": "^4.4.3"
   }
 }