mineflayer 3.11.0 → 3.13.0

package/docs/zh/README_ZH_CN.md

@@ -10,7 +10,7 @@
 [![Try it on gitpod](https://img.shields.io/badge/try-on%20gitpod-brightgreen.svg)](https://gitpod.io/#https://github.com/PrismarineJS/mineflayer)
 [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/PrismarineJS/mineflayer/blob/master/docs/mineflayer.ipynb)
 
-| 🇺🇸 [英语](../README.md) | 🇷🇺 [俄语](../ru/README_RU.md) | 🇪🇸 [西班牙语](../es/README_ES.md) | 🇫🇷 [法语](../fr/README_FR.md) | 🇹🇷 [土耳其语](../tr/README_TR.md) | 🇨🇳 [中文](README_ZH_CN.md) |
+| <sub>EN</sub> [英语](../README.md) | <sub>RU</sub> [俄语](../ru/README_RU.md) | <sub>ES</sub> [西班牙语](../es/README_ES.md) | <sub>FR</sub> [法语](../fr/README_FR.md) | <sub>TR</sub> [土耳其语](../tr/README_TR.md) | <sub>ZH</sub> [中文](README_ZH_CN.md) |
 |-------------------------|----------------------------|----------------------------|----------------------------|----------------------------|----------------------------|
 
 使用强大、稳定、高级的JavaScript [API](../api.md) 来开发Minecraft机器人，同时支持 Python。

package/examples/chatterbox.js

@@ -13,7 +13,7 @@
  * a few informations while you are in game.
  */
 const mineflayer = require('mineflayer')
-const Vec3 = require('vec3').Vec3
+const { Vec3 } = require('vec3')
 
 if (process.argv.length < 4 || process.argv.length > 6) {
   console.log('Usage : node chatterbot.js <host> <port> [<name>] [<password>]')

package/examples/discord.js

@@ -1,7 +1,7 @@
 /*
  * This example is a very simple way how to connect a discord bot with a mineflayer bot.
  * For this example you will need discord.js installed. You can install with: npm install discord.js
- * Note that discord.js v12 or newer is required.
+ * This example uses discord.js v13
  * You need to do this before running this example:
  * - You need to get a discord token
  * - You need to get the id of the channel you want to use
@@ -12,9 +12,18 @@ if (process.argv.length < 6 || process.argv.length > 8) {
   process.exit(1)
 }
 
-// Load discord
-const Discord = require('discord.js')
-const client = new Discord.Client()
+// Load discord.js
+const {
+  Client,
+  Intents
+} = require('discord.js')
+// Create Discord intentions, required in v13
+const intents = new Intents(['GUILDS', 'GUILD_MESSAGES'])
+// Create Discord client
+const client = new Client({
+  intents: intents
+})
+
 let channel = process.argv[3]
 
 // Load mineflayer
@@ -28,6 +37,7 @@ const bot = mineflayer.createBot({
 
 client.on('ready', () => {
   console.log(`The discord bot logged in! Username: ${client.user.username}!`)
+  // Find the Discord channel messages will be sent to
   channel = client.channels.cache.get(channel)
   if (!channel) {
     console.log(`I could not find the channel (${process.argv[3]})!\nUsage : node discord.js <discord bot token> <channel id> <host> <port> [<name>] [<password>]`)
@@ -36,7 +46,7 @@ client.on('ready', () => {
 })
 
 // Redirect Discord messages to in-game chat
-client.on('message', message => {
+client.on('messageCreate', message => {
   // Only handle messages in specified channel
   if (message.channel.id !== channel.id) return
   // Ignore messages from the bot itself

package/examples/python/basic.py

@@ -21,7 +21,7 @@ def handle(*args):
   movements = pathfinder.Movements(bot, mcData)
 
   @On(bot, 'chat')
-  def handleMsg(sender, message, *args):
+  def handleMsg(this, sender, message, *args):
     print("Got message", sender, message)
     if sender and (sender != BOT_USERNAME):
       bot.chat('Hi, you said ' + message)
@@ -39,4 +39,4 @@ def handle(*args):
 
 @On(bot, "end")
 def handle(*args):
-  print("Bot ended!", args)
+  print("Bot ended!", args)

package/examples/python/chatterbox.py

@@ -13,7 +13,7 @@
 # a few informations while you are in game.
 # ===========================================================================
 import sys, re
-from javascript import require, On, Once
+from javascript import require, On, Once, console
 
 mineflayer = require("mineflayer", "latest")
 Vec3 = require("vec3").Vec3

package/examples/screenshot-with-node-canvas-webgl/screenshot.js

@@ -11,8 +11,8 @@ global.Worker = require('worker_threads').Worker
 const THREE = require('three')
 const { createCanvas } = require('node-canvas-webgl/lib')
 const fs = require('fs').promises
-const Vec3 = require('vec3').Vec3
-const EventEmitter = require('events').EventEmitter
+const { Vec3 } = require('vec3')
+const { EventEmitter } = require('events')
 
 if (process.argv.length < 4 || process.argv.length > 6) {
   console.log('Usage : node screenshot.js <host> <port> [<name>] [<password>]')

package/index.d.ts

@@ -9,6 +9,7 @@ import { Block } from 'prismarine-block'
 import { Entity } from 'prismarine-entity'
 import { ChatMessage } from 'prismarine-chat'
 
+export function createBot (options: { client: Client } & Partial<BotOptions>): Bot
 export function createBot (options: BotOptions): Bot
 
 export interface BotOptions extends ClientOptions {
@@ -25,6 +26,7 @@ export interface BotOptions extends ClientOptions {
   physicsEnabled?: boolean
   client?: Client
   brand?: string
+  defaultChatPatterns?: boolean
 }
 
 export type ChatLevel = 'enabled' | 'commandsOnly' | 'disabled'
@@ -44,112 +46,111 @@ interface BotEvents {
     translate: string | null,
     jsonMsg: ChatMessage,
     matches: string[] | null
-  ) => void
+  ) => Promise<void> | void
   whisper: (
     username: string,
     message: string,
     translate: string | null,
     jsonMsg: ChatMessage,
     matches: string[] | null
-  ) => void
-  actionBar: (jsonMsg: ChatMessage) => void
-  error: (err: Error) => void
-  message: (jsonMsg: ChatMessage, position: string) => void
-  messagestr: (message: string, position: string, jsonMsg: ChatMessage) => void
-  unmatchedMessage: (stringMsg: string, jsonMsg: ChatMessage) => void
-  inject_allowed: () => void
-  login: () => void
-  spawn: () => void
-  respawn: () => void
-  game: () => void
-  title: (text: string) => void
-  rain: () => void
-  time: () => void
-  kicked: (reason: string, loggedIn: boolean) => void
-  end: () => void
-  spawnReset: () => void
-  death: () => void
-  health: () => void
-  breath: () => void
-  entitySwingArm: (entity: Entity) => void
-  entityHurt: (entity: Entity) => void
-  entityDead: (entity: Entity) => void
-  entityTaming: (entity: Entity) => void
-  entityTamed: (entity: Entity) => void
-  entityShakingOffWater: (entity: Entity) => void
-  entityEatingGrass: (entity: Entity) => void
-  entityWake: (entity: Entity) => void
-  entityEat: (entity: Entity) => void
-  entityCriticalEffect: (entity: Entity) => void
-  entityMagicCriticalEffect: (entity: Entity) => void
-  entityCrouch: (entity: Entity) => void
-  entityUncrouch: (entity: Entity) => void
-  entityEquip: (entity: Entity) => void
-  entitySleep: (entity: Entity) => void
-  entitySpawn: (entity: Entity) => void
-  itemDrop: (entity: Entity) => void
-  playerCollect: (collector: Entity, collected: Entity) => void
-  entityAttributes: (entity: Entity) => void
-  entityGone: (entity: Entity) => void
-  entityMoved: (entity: Entity) => void
-  entityDetach: (entity: Entity, vehicle: Entity) => void
-  entityAttach: (entity: Entity, vehicle: Entity) => void
-  entityUpdate: (entity: Entity) => void
-  entityEffect: (entity: Entity, effect: Effect) => void
-  entityEffectEnd: (entity: Entity, effect: Effect) => void
-  playerJoined: (player: Player) => void
-  playerUpdated: (player: Player) => void
-  playerLeft: (entity: Player) => void
-  blockUpdate: (oldBlock: Block | null, newBlock: Block) => void
-  'blockUpdate:(x, y, z)': (oldBlock: Block | null, newBlock: Block) => void
-  chunkColumnLoad: (entity: Vec3) => void
-  chunkColumnUnload: (entity: Vec3) => void
+  ) => Promise<void> | void
+  actionBar: (jsonMsg: ChatMessage) => Promise<void> | void
+  error: (err: Error) => Promise<void> | void
+  message: (jsonMsg: ChatMessage, position: string) => Promise<void> | void
+  messagestr: (message: string, position: string, jsonMsg: ChatMessage) => Promise<void> | void
+  unmatchedMessage: (stringMsg: string, jsonMsg: ChatMessage) => Promise<void> | void
+  inject_allowed: () => Promise<void> | void
+  login: () => Promise<void> | void
+  spawn: () => Promise<void> | void
+  respawn: () => Promise<void> | void
+  game: () => Promise<void> | void
+  title: (text: string) => Promise<void> | void
+  rain: () => Promise<void> | void
+  time: () => Promise<void> | void
+  kicked: (reason: string, loggedIn: boolean) => Promise<void> | void
+  end: (reason: string) => Promise<void> | void
+  spawnReset: () => Promise<void> | void
+  death: () => Promise<void> | void
+  health: () => Promise<void> | void
+  breath: () => Promise<void> | void
+  entitySwingArm: (entity: Entity) => Promise<void> | void
+  entityHurt: (entity: Entity) => Promise<void> | void
+  entityDead: (entity: Entity) => Promise<void> | void
+  entityTaming: (entity: Entity) => Promise<void> | void
+  entityTamed: (entity: Entity) => Promise<void> | void
+  entityShakingOffWater: (entity: Entity) => Promise<void> | void
+  entityEatingGrass: (entity: Entity) => Promise<void> | void
+  entityWake: (entity: Entity) => Promise<void> | void
+  entityEat: (entity: Entity) => Promise<void> | void
+  entityCriticalEffect: (entity: Entity) => Promise<void> | void
+  entityMagicCriticalEffect: (entity: Entity) => Promise<void> | void
+  entityCrouch: (entity: Entity) => Promise<void> | void
+  entityUncrouch: (entity: Entity) => Promise<void> | void
+  entityEquip: (entity: Entity) => Promise<void> | void
+  entitySleep: (entity: Entity) => Promise<void> | void
+  entitySpawn: (entity: Entity) => Promise<void> | void
+  itemDrop: (entity: Entity) => Promise<void> | void
+  playerCollect: (collector: Entity, collected: Entity) => Promise<void> | void
+  entityAttributes: (entity: Entity) => Promise<void> | void
+  entityGone: (entity: Entity) => Promise<void> | void
+  entityMoved: (entity: Entity) => Promise<void> | void
+  entityDetach: (entity: Entity, vehicle: Entity) => Promise<void> | void
+  entityAttach: (entity: Entity, vehicle: Entity) => Promise<void> | void
+  entityUpdate: (entity: Entity) => Promise<void> | void
+  entityEffect: (entity: Entity, effect: Effect) => Promise<void> | void
+  entityEffectEnd: (entity: Entity, effect: Effect) => Promise<void> | void
+  playerJoined: (player: Player) => Promise<void> | void
+  playerUpdated: (player: Player) => Promise<void> | void
+  playerLeft: (entity: Player) => Promise<void> | void
+  blockUpdate: (oldBlock: Block | null, newBlock: Block) => Promise<void> | void
+  'blockUpdate:(x, y, z)': (oldBlock: Block | null, newBlock: Block) => Promise<void> | void
+  chunkColumnLoad: (entity: Vec3) => Promise<void> | void
+  chunkColumnUnload: (entity: Vec3) => Promise<void> | void
   soundEffectHeard: (
     soundName: string,
     position: Vec3,
     volume: number,
     pitch: number
-  ) => void
+  ) => Promise<void> | void
   hardcodedSoundEffectHeard: (
     soundId: number,
     soundCategory: number,
     position: Vec3,
     volume: number,
     pitch: number
-  ) => void
-  noteHeard: (block: Block, instrument: Instrument, pitch: number) => void
-  pistonMove: (block: Block, isPulling: number, direction: number) => void
-  chestLidMove: (block: Block, isOpen: number) => void
-  blockBreakProgressObserved: (block: Block, destroyStage: number) => void
-  blockBreakProgressEnd: (block: Block) => void
-  diggingCompleted: (block: Block) => void
-  diggingAborted: (block: Block) => void
-  move: () => void
-  forcedMove: () => void
-  mount: () => void
-  dismount: (vehicle: Entity) => void
-  windowOpen: (vehicle: Window) => void
-  windowClose: (vehicle: Window) => void
-  sleep: () => void
-  wake: () => void
-  experience: () => void
-  physicsTick: () => void
-  physicTick: () => void
-  scoreboardCreated: (scoreboard: ScoreBoard) => void
-  scoreboardDeleted: (scoreboard: ScoreBoard) => void
-  scoreboardTitleChanged: (scoreboard: ScoreBoard) => void
-  scoreUpdated: (scoreboard: ScoreBoard, item: number) => void
-  scoreRemoved: (scoreboard: ScoreBoard, item: number) => void
-  scoreboardPosition: (position: DisplaySlot, scoreboard: ScoreBoard) => void
-  teamCreated: (team: Team) => void
-  teamRemoved: (team: Team) => void
-  teamUpdated: (team: Team) => void
-  teamMemberAdded: (team: Team) => void
-  teamMemberRemoved: (team: Team) => void
-  bossBarCreated: (bossBar: BossBar) => void
-  bossBarDeleted: (bossBar: BossBar) => void
-  bossBarUpdated: (bossBar: BossBar) => void
-  resourcePack: (url: string, hash: string) => void
+  ) => Promise<void> | void
+  noteHeard: (block: Block, instrument: Instrument, pitch: number) => Promise<void> | void
+  pistonMove: (block: Block, isPulling: number, direction: number) => Promise<void> | void
+  chestLidMove: (block: Block, isOpen: number) => Promise<void> | void
+  blockBreakProgressObserved: (block: Block, destroyStage: number) => Promise<void> | void
+  blockBreakProgressEnd: (block: Block) => Promise<void> | void
+  diggingCompleted: (block: Block) => Promise<void> | void
+  diggingAborted: (block: Block) => Promise<void> | void
+  move: () => Promise<void> | void
+  forcedMove: () => Promise<void> | void
+  mount: () => Promise<void> | void
+  dismount: (vehicle: Entity) => Promise<void> | void
+  windowOpen: (window: Window) => Promise<void> | void
+  windowClose: (window: Window) => Promise<void> | void
+  sleep: () => Promise<void> | void
+  wake: () => Promise<void> | void
+  experience: () => Promise<void> | void
+  physicsTick: () => Promise<void> | void
+  physicTick: () => Promise<void> | void
+  scoreboardCreated: (scoreboard: ScoreBoard) => Promise<void> | void
+  scoreboardDeleted: (scoreboard: ScoreBoard) => Promise<void> | void
+  scoreboardTitleChanged: (scoreboard: ScoreBoard) => Promise<void> | void
+  scoreUpdated: (scoreboard: ScoreBoard, item: number) => Promise<void> | void
+  scoreRemoved: (scoreboard: ScoreBoard, item: number) => Promise<void> | void
+  scoreboardPosition: (position: DisplaySlot, scoreboard: ScoreBoard) => Promise<void> | void
+  teamCreated: (team: Team) => Promise<void> | void
+  teamRemoved: (team: Team) => Promise<void> | void
+  teamUpdated: (team: Team) => Promise<void> | void
+  teamMemberAdded: (team: Team) => Promise<void> | void
+  teamMemberRemoved: (team: Team) => Promise<void> | void
+  bossBarDeleted: (bossBar: BossBar) => Promise<void> | void
+  bossBarUpdated: (bossBar: BossBar) => Promise<void> | void
+  resourcePack: (url: string, hash: string) => Promise<void> | void
 }
 
 export interface Bot extends TypedEmitter<BotEvents> {
@@ -193,13 +194,14 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   supportFeature: (feature: string) => boolean
 
-  end: () => void
+  end: (reason?: string) => void
 
   blockAt: (point: Vec3) => Block | null
 
   blockInSight: (maxSteps: number, vectorLength: number) => Block | null
 
   blockAtCursor: (maxDistance?: number, matcher?: Function) => Block | null
+  blockAtEntityCursor: (entity?: entity, maxDistance?: number, matcher?: Function) => Block | null
 
   canSeeBlock: (block: Block) => boolean
 
@@ -257,6 +259,8 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   clearControlStates: () => void
 
+  getExplosionDamages: (targetEntity: Entity, position: Vec3, radius: number, rawDamages?: boolean) => number | null
+
   lookAt: (point: Vec3, force?: boolean, callback?: () => void) => Promise<void>
 
   look: (
@@ -339,11 +343,11 @@ export interface Bot extends TypedEmitter<BotEvents> {
     callback?: (err?: Error) => void
   ) => Promise<void>
 
-  openChest: (chest: Block | Entity) => Promise<ContainerWindow>
+  openChest: (chest: Block | Entity) => Promise<Chest>
 
   openFurnace: (furnace: Block) => Promise<Furnace>
 
-  openDispenser: (dispenser: Block) => Promise<ContainerWindow>
+  openDispenser: (dispenser: Block) => Promise<Dispenser>
 
   openEnchantmentTable: (enchantmentTable: Block) => Promise<EnchantmentTable>
 
@@ -351,7 +355,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   openVillager: (
     villager: Entity
-  ) => Villager
+  ) => Promise<Villager>
 
   trade: (
     villagerInstance: Villager,
@@ -612,8 +616,6 @@ interface ConditionalStorageEvents extends StorageEvents {
   ready: () => void
 }
 
-type ContainerWindow = Anvil | Furnace | Chest | EnchantmentTable | Villager
-
 export class Chest extends (EventEmitter as new () => TypedEmitter<StorageEvents>) {
   window: object | /* prismarine-windows ChestWindow */ null
 
@@ -831,7 +833,7 @@ export class BossBar {
   );
 }
 
-export var supportedVersions: string[]
-export var testedVersions: string[]
+export let supportedVersions: string[]
+export let testedVersions: string[]
 
 export function supportFeature (feature: string, version: string): boolean

package/lib/conversions.js

@@ -1,4 +1,4 @@
-const Vec3 = require('vec3').Vec3
+const { Vec3 } = require('vec3')
 const math = require('./math')
 const euclideanMod = math.euclideanMod
 const PI = Math.PI

package/lib/loader.js

@@ -1,5 +1,5 @@
 const mc = require('minecraft-protocol')
-const EventEmitter = require('events').EventEmitter
+const { EventEmitter } = require('events')
 const pluginLoader = require('./plugin_loader')
 const supportFeature = require('./supportFeature')
 const plugins = {
@@ -70,7 +70,7 @@ function createBot (options = {}) {
   options.brand = options.brand ?? 'vanilla'
   const bot = new EventEmitter()
   bot._client = options.client
-  bot.end = () => bot._client.end()
+  bot.end = (reason) => bot._client.end(reason)
   if (options.logErrors) {
     bot.on('error', err => {
       if (!options.hideErrors) {
@@ -99,8 +99,8 @@ function createBot (options = {}) {
   bot._client.on('error', (err) => {
     bot.emit('error', err)
   })
-  bot._client.on('end', () => {
-    bot.emit('end')
+  bot._client.on('end', (reason) => {
+    bot.emit('end', reason)
   })
   if (!bot._client.wait_connect) next()
   else bot._client.once('connect_allowed', next)

package/lib/plugins/bed.js

@@ -1,4 +1,4 @@
-const Vec3 = require('vec3').Vec3
+const { Vec3 } = require('vec3')
 const { callbackify } = require('../promise_utils')
 
 module.exports = inject

package/lib/plugins/block_actions.js

@@ -1,4 +1,4 @@
-const Vec3 = require('vec3').Vec3
+const { Vec3 } = require('vec3')
 
 module.exports = inject
 

package/lib/plugins/blocks.js

@@ -1,4 +1,4 @@
-const Vec3 = require('vec3').Vec3
+const { Vec3 } = require('vec3')
 const assert = require('assert')
 const Painting = require('../painting')
 const { onceWithCleanup, callbackify } = require('../promise_utils')
@@ -476,6 +476,7 @@ function inject (bot, { version, storageBuilder }) {
   // if we get a respawn packet and the dimension is changed,
   // unload all chunks from memory.
   let dimension
+  let worldName
   function dimensionToFolderName (dimension) {
     if (bot.supportFeature('dimensionIsAnInt')) {
       return dimensionNames[dimension]
@@ -511,13 +512,26 @@ function inject (bot, { version, storageBuilder }) {
   }
 
   bot._client.on('login', (packet) => {
-    dimension = packet.dimension
+    if (bot.supportFeature('dimensionIsAnInt')) {
+      dimension = packet.dimension
+    } else {
+      dimension = packet.dimension
+      worldName = packet.worldName
+    }
     switchWorld()
   })
 
   bot._client.on('respawn', (packet) => {
-    if (dimension === packet.dimension) return
-    dimension = packet.dimension
+    if (bot.supportFeature('dimensionIsAnInt')) { // <=1.15.2
+      if (dimension === packet.dimension) return
+      dimension = packet.dimension
+    } else { // >= 1.15.2
+      if (dimension === packet.dimension) return
+      if (worldName === packet.worldName && packet.copyMetadata === true) return // don't unload chunks if in same world and metaData is true
+      // Metadata is true when switching dimensions however, then the world name is different
+      dimension = packet.dimension
+      worldName = packet.worldName
+    }
     switchWorld()
   })
 

package/lib/plugins/chat.js

@@ -4,6 +4,7 @@ module.exports = inject
 
 function inject (bot, options) {
   const CHAT_LENGTH_LIMIT = options.chatLengthLimit ?? (bot.supportFeature('lessCharsInChat') ? 100 : 256)
+  const defaultChatPatterns = options.defaultChatPatterns ?? true
 
   const ChatMessage = require('prismarine-chat')(bot.version)
   // chat.pattern.type will emit an event for bot.on() of the same type, eg chatType = whisper will trigger bot.on('whisper')
@@ -171,6 +172,7 @@ function inject (bot, options) {
   bot.tabComplete = callbackify(tabComplete)
 
   function addDefaultPatterns () {
+    if (!defaultChatPatterns) return
     const USERNAME_REGEX = '(?:\\(.+\\)|\\[.+\\]|.)*?(\\w+)'
     bot.addChatPattern('whisper', new RegExp(`^${USERNAME_REGEX} whispers(?: to you)?:? (.*)$`), { deprecated: true })
     bot.addChatPattern('whisper', new RegExp(`^\\[${USERNAME_REGEX} -> \\w+\\s?\\] (.*)$`), { deprecated: true })

package/lib/plugins/command_block.js

@@ -1,5 +1,5 @@
 const assert = require('assert')
-const ProtoDef = require('protodef').ProtoDef
+const { ProtoDef } = require('protodef')
 
 module.exports = inject
 

package/lib/plugins/creative.js

@@ -1,5 +1,5 @@
 const assert = require('assert')
-const Vec3 = require('vec3').Vec3
+const { Vec3 } = require('vec3')
 const { callbackify, sleep } = require('../promise_utils')
 const { once } = require('events')
 

package/lib/plugins/digging.js

@@ -1,4 +1,3 @@
-const nbt = require('prismarine-nbt')
 const { performance } = require('perf_hooks')
 const { createDoneTask, createTask } = require('../promise_utils')
 const BlockFaces = require('prismarine-world').iterators.BlockFace
@@ -176,20 +175,6 @@ function inject (bot) {
     return block && block.diggable && block.position.offset(0.5, 0.5, 0.5).distanceTo(bot.entity.position.offset(0, 1.65, 0)) <= 5.1
   }
 
-  function getItemEnchantments (item) {
-    if (item.nbt) {
-      const simplifiedNbt = nbt.simplify(item.nbt)
-
-      if (simplifiedNbt.Enchantments) {
-        return simplifiedNbt.Enchantments
-      }
-      if (simplifiedNbt.ench) {
-        return simplifiedNbt.ench
-      }
-    }
-    return []
-  }
-
   function digTime (block) {
     let type = null
     let enchantments = []
@@ -198,14 +183,14 @@ function inject (bot) {
     const currentlyHeldItem = bot.heldItem
     if (currentlyHeldItem) {
       type = currentlyHeldItem.type
-      enchantments = getItemEnchantments(currentlyHeldItem)
+      enchantments = currentlyHeldItem.enchants
     }
 
     // Append helmet enchantments (because Aqua Affinity actually affects dig speed)
     const headEquipmentSlot = bot.getEquipmentDestSlot('head')
     const headEquippedItem = bot.inventory.slots[headEquipmentSlot]
     if (headEquippedItem) {
-      const helmetEnchantments = getItemEnchantments(headEquippedItem)
+      const helmetEnchantments = headEquippedItem.enchants
       enchantments = enchantments.concat(helmetEnchantments)
     }
 

package/lib/plugins/entities.js

@@ -1,4 +1,4 @@
-const Vec3 = require('vec3').Vec3
+const { Vec3 } = require('vec3')
 const Entity = require('prismarine-entity')
 const conv = require('../conversions')
 const NAMED_ENTITY_HEIGHT = 1.62
@@ -89,7 +89,11 @@ function inject (bot, { version }) {
     return best
   }
 
-  bot._client.once('login', (packet) => {
+  // Reset list of players and entities on login
+  bot._client.on('login', (packet) => {
+    bot.players = {}
+    bot.uuidToUsername = {}
+    bot.entities = {}
     // login
     bot.entity = fetchEntity(packet.entityId)
     bot.username = bot._client.username
@@ -483,15 +487,15 @@ function inject (bot, { version }) {
         } else if (packet.action === 3 && item.displayName) {
           player.displayName = new ChatMessage(JSON.parse(item.displayName))
         } else if (packet.action === 4) {
-          if (player.entity === bot.entity) return
+          if (player.entity === bot.entity) continue
 
           player.entity = null
           delete bot.players[player.username]
           delete bot.uuidToUsername[item.UUID]
           bot.emit('playerLeft', player)
-          return
+          continue
         } else {
-          return
+          continue
         }
 
         bot.emit('playerUpdated', player)
@@ -531,8 +535,8 @@ function inject (bot, { version }) {
   bot.useOn = useOn
   bot.moveVehicle = moveVehicle
 
-  function swingArm (arm = 'left', showHand = true) {
-    const hand = arm === 'left' ? 0 : 1
+  function swingArm (arm = 'right', showHand = true) {
+    const hand = arm === 'right' ? 0 : 1
     const packet = {}
     if (showHand) packet.hand = hand
     bot._client.write('arm_animation', packet)
@@ -544,11 +548,11 @@ function inject (bot, { version }) {
   }
 
   function attack (target, swing = true) {
-    useEntity(target, 1)
-
+    // arm animation comes before the use_entity packet
     if (swing) {
       swingArm()
     }
+    useEntity(target, 1)
   }
 
   function mount (target) {

package/lib/plugins/explosion.js

@@ -77,7 +77,7 @@ function inject (bot) {
     // The following modifiers are constant for the input targetEntity and doesnt depend
     // on the source position, so if the goal is to compare between positions they can be
     // ignored to save computations
-    if (!rawDamages) {
+    if (!rawDamages && targetEntity.attributes['generic.armor']) {
       const armor = getAttributeValue(targetEntity.attributes['generic.armor'])
       const armorToughness = getAttributeValue(targetEntity.attributes[armorThoughnessKey])
       damages = getDamageAfterAbsorb(damages, armor, armorToughness)
@@ -85,6 +85,8 @@ function inject (bot) {
       // TODO: protection enchantment and resistance effects
 
       if (targetEntity.type === 'player') damages *= difficultyValues[bot.game.difficulty] * 0.5
+    } else if (!rawDamages && !targetEntity.attributes['generic.armor']) {
+      return null
     }
     return Math.floor(damages)
   }

package/lib/plugins/game.js

@@ -90,4 +90,11 @@ function inject (bot, options) {
   bot._client.on(brandChannel, (serverBrand) => {
     bot.game.serverBrand = serverBrand
   })
+
+  // mimic the vanilla 1.17 client to prevent anticheat kicks
+  bot._client.on('ping', (data) => {
+    bot._client.write('pong', {
+      id: data.id
+    })
+  })
 }