mineflayer 3.11.1 → 3.13.1

package/.github/FUNDING.yml

@@ -1,3 +1 @@
 # These are supported funding model platforms
-
-issuehunt: PrismarineJS/mineflayer

package/.github/workflows/ci.yml

@@ -25,8 +25,6 @@ jobs:
         javaVersion: [1.8]
         mcVersion: ['1.8.8', '1.9.4', '1.10.2', '1.11.2', '1.12.2', '1.13.2', '1.14.4', '1.15.2', '1.16.5']
         include:
-         - javaVersion: 16
-           mcVersion: '1.17'
          - javaVersion: 16
            mcVersion: '1.17.1'
       fail-fast: false

package/README.md

@@ -188,6 +188,8 @@ The most updated and useful are :
  * [Auto Crystal](https://github.com/link-discord/mineflayer-autocrystal) - Automatic placing & breaking of end crystals.
  * [Tool](https://github.com/TheDudeFromCI/mineflayer-tool) - A utility for automatic tool/weapon selection with a high level API.
  * [Hawkeye](https://github.com/sefirosweb/minecraftHawkEye) - A utility for using auto-aim with bows.
+ * [GUI](https://github.com/firejoust/mineflayer-GUI) - Eased navigation & management of nested chest-GUI windows
+ * [Projectile](https://github.com/firejoust/mineflayer-projectile) - Configurable tool for projectile based combat
 
 
  But also check out :
@@ -202,6 +204,7 @@ The most updated and useful are :
  * [Bloodhound](https://github.com/Nixes/mineflayer-bloodhound) - determine who and what is responsible for damage to another entity
  * [tps](https://github.com/SiebeDW/mineflayer-tps) - get the current tps (processed tps)
  * [panorama](https://github.com/IceTank/mineflayer-panorama) - take Panorama Images of your world
+ * [player-death-event](https://github.com/tuanzisama/mineflayer-death-event) - emit player death event in Mineflayer.
 
 ## Projects Using Mineflayer
 

package/docs/README.md

@@ -188,6 +188,8 @@ The most updated and useful are :
  * [Auto Crystal](https://github.com/link-discord/mineflayer-autocrystal) - Automatic placing & breaking of end crystals.
  * [Tool](https://github.com/TheDudeFromCI/mineflayer-tool) - A utility for automatic tool/weapon selection with a high level API.
  * [Hawkeye](https://github.com/sefirosweb/minecraftHawkEye) - A utility for using auto-aim with bows.
+ * [GUI](https://github.com/firejoust/mineflayer-GUI) - Eased navigation & management of nested chest-GUI windows
+ * [Projectile](https://github.com/firejoust/mineflayer-projectile) - Configurable tool for projectile based combat
 
 
  But also check out :
@@ -202,6 +204,7 @@ The most updated and useful are :
  * [Bloodhound](https://github.com/Nixes/mineflayer-bloodhound) - determine who and what is responsible for damage to another entity
  * [tps](https://github.com/SiebeDW/mineflayer-tps) - get the current tps (processed tps)
  * [panorama](https://github.com/IceTank/mineflayer-panorama) - take Panorama Images of your world
+ * [player-death-event](https://github.com/tuanzisama/mineflayer-death-event) - emit player death event in Mineflayer.
 
 ## Projects Using Mineflayer
 

package/docs/api.md

@@ -158,7 +158,7 @@
       - ["weatherUpdate"](#weatherupdate)
       - ["time"](#time)
       - ["kicked" (reason, loggedIn)](#kicked-reason-loggedin)
-      - ["end"](#end)
+      - ["end" (reason)](#end-reason)
       - ["error" (err)](#error-err)
       - ["spawnReset"](#spawnreset)
       - ["death"](#death)
@@ -238,6 +238,7 @@
       - [bot.waitForChunksToLoad(cb)](#botwaitforchunkstoloadcb)
       - [bot.blockInSight(maxSteps, vectorLength)](#botblockinsightmaxsteps-vectorlength)
       - [bot.blockAtCursor(maxDistance=256)](#botblockatcursormaxdistance256)
+      - [bot.blockAtEntityCursor(entity=bot.entity, maxDistance=256)](#botblockatentitycursorentitybotentity-maxdistance256)
       - [bot.canSeeBlock(block)](#botcanseeblockblock)
       - [bot.findBlocks(options)](#botfindblocksoptions)
       - [bot.findBlock(options)](#botfindblockoptions)
@@ -246,7 +247,7 @@
       - [bot.recipesAll(itemType, metadata, craftingTable)](#botrecipesallitemtype-metadata-craftingtable)
       - [bot.nearestEntity(match = (entity) => { return true })](#botnearestentitymatch--entity---return-true-)
     - [Methods](#methods)
-      - [bot.end()](#botend)
+      - [bot.end(reason)](#botendreason)
       - [bot.quit(reason)](#botquitreason)
       - [bot.tabComplete(str, cb, [assumeCommand], [sendBlockInSight])](#bottabcompletestr-cb-assumecommand-sendblockinsight)
       - [bot.chat(message)](#botchatmessage)
@@ -289,7 +290,7 @@
       - [bot.activateItem(offHand=false)](#botactivateitemoffhandfalse)
       - [bot.deactivateItem()](#botdeactivateitem)
       - [bot.useOn(targetEntity)](#botuseontargetentity)
-      - [bot.attack(entity)](#botattackentity)
+      - [bot.attack(entity, swing = true)](#botattackentity-swing--true)
       - [bot.swingArm([hand], showHand)](#botswingarmhand-showhand)
       - [bot.mount(entity)](#botmountentity)
       - [bot.dismount()](#botdismount)
@@ -756,6 +757,7 @@ Create and return an instance of the class bot.
  * [difficulty](#bot.settings.difficulty)
  * [skinParts](#bot.settings.skinParts)
  * chatLengthLimit : the maximum amount of characters that can be sent in a single message. If this is not set, it will be 100 in < 1.11 and 256 in >= 1.11.
+ * defaultChatPatterns: defaults to true, set to false to not add the patterns such as chat and whisper
 
 ### Properties
 
@@ -1154,9 +1156,10 @@ is a chat message explaining why you were kicked. `loggedIn`
 is `true` if the client was kicked after successfully logging in,
 or `false` if the kick occurred in the login phase.
 
-#### "end"
+#### "end" (reason)
 
 Emitted when you are no longer connected to the server.
+`reason` is a string explaining why the client was disconnected. (defaults to 'socketClosed')
 
 #### "error" (err)
 
@@ -1448,6 +1451,12 @@ 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.blockAtEntityCursor(entity=bot.entity, maxDistance=256)
+
+Returns the block at which specific entity is looking at or `null`
+ * `entity` - Entity data as `Object`
+ * `maxDistance` - The maximum distance the block can be from the eye, defaults to 256.
+
 #### bot.canSeeBlock(block)
 
 Returns true or false depending on whether the bot can see the specified `block`.
@@ -1503,9 +1512,10 @@ const cow = bot.nearestEntity(entity => entity.name.toLowerCase() === 'cow') //
 
 ### Methods
 
-#### bot.end()
+#### bot.end(reason)
 
 End the connection with the server.
+* `reason` - Optional string that states the reason of the end.
 
 #### bot.quit(reason)
 
@@ -1853,10 +1863,13 @@ Deactivates the currently held item. This is how you release an arrow, stop eati
 Use the currently held item on an `Entity` instance. This is how you apply a saddle and
 use shears.
 
-#### bot.attack(entity)
+#### bot.attack(entity, swing = true)
 
 Attack a player or a mob.
 
+ * `entity` is a type of entity. To get a specific entity use [bot.nearestEntity()](#botnearestentitymatch--entity---return-true-) or [bot.entities](#botentities).
+ * `swing` Default `true`. If false the bot does not swing is arm when attacking.
+
 #### bot.swingArm([hand], showHand)
 
 Play an arm swing animation.

package/docs/history.md

@@ -1,3 +1,32 @@
+## 3.13.1
+
+* Fix bug with force lastSentPitch in bot.look (@KadaverBrutalo10)
+* Fix typo harming type safety (@Eagle-Anne)
+
+## 3.13.0
+
+* compute scoreboard displayName dynamically (@U9G)
+* SkinsRestorer fix (@U5B)
+* Fix bot not swinging arm on block place (@IceTank)
+
+## 3.12.0
+
+* Bypass anticheats that detect sensitivity (@mat-1)
+* Fix removing many players at once from tab list (@mat-1)
+* Added blockAtEntityCursor function (@DatArnoGuy)
+* add option to disable default chat patterns (@U5B)
+* Fixed wrong arm swinging (@IceTank)
+* Add pitch speed to look (@IceTank)
+* Console spam fix (@IceTank)
+* Update openVillager function to return a promise (@amoraschi)
+* Send arm_animation before use_entity (@aesthetic0001)
+* Add reason for the end of a mineflayer bot (@U5B)
+* added rejection of invalid transaction packets (anticheat fix) (@U5B)
+
+## 3.11.2
+* Remove unnecessary and buggy inventory check in place block (@Karang)
+* Make all events allow async cb typings (@u9g)
+
 ## 3.11.1
 * Get rid of nowaiting (@nickelpro)
 * update readme (@inthmafr)

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/index.d.ts

@@ -26,6 +26,7 @@ export interface BotOptions extends ClientOptions {
   physicsEnabled?: boolean
   client?: Client
   brand?: string
+  defaultChatPatterns?: boolean
 }
 
 export type ChatLevel = 'enabled' | 'commandsOnly' | 'disabled'
@@ -45,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> {
@@ -194,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
 
@@ -354,7 +355,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   openVillager: (
     villager: Entity
-  ) => Villager
+  ) => Promise<Villager>
 
   trade: (
     villagerInstance: Villager,
@@ -832,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/loader.js

@@ -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/blocks.js

@@ -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/entities.js

@@ -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/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
+    })
+  })
 }

package/lib/plugins/generic_place.js

@@ -1,5 +1,4 @@
 const assert = require('assert')
-const { once } = require('events')
 module.exports = inject
 
 function inject (bot, { version }) {
@@ -8,7 +7,7 @@ function inject (bot, { version }) {
    *
    * @param {import('prismarine-block').Block} referenceBlock
    * @param {import('vec3').Vec3} faceVector
-   * @param {{half?: 'top'|'bottom', delta?: import('vec3').Vec3, forceLook?: boolean | 'ignore', offhand?: boolean}} options
+   * @param {{half?: 'top'|'bottom', delta?: import('vec3').Vec3, forceLook?: boolean | 'ignore', offhand?: boolean, swingArm?: 'right' | 'left', showHand?: boolean}} options
    */
   async function _genericPlace (referenceBlock, faceVector, options) {
     let handToPlaceWith = 0
@@ -40,6 +39,10 @@ function inject (bot, { version }) {
     // TODO: tell the server that we are sneaking while doing this
     const pos = referenceBlock.position
 
+    if (options.swingArm) {
+      bot.swingArm(options.swingArm, options.showHand)
+    }
+
     if (bot.supportFeature('blockPlaceHasHeldItem')) {
       const packet = {
         location: pos,
@@ -80,14 +83,6 @@ function inject (bot, { version }) {
       })
     }
 
-    if (bot.game.gameMode !== 'creative') {
-      if (handToPlaceWith === 0) {
-        await once(bot.inventory, `updateSlot:${bot.heldItem.slot}`)
-      } else {
-        await once(bot.inventory, 'updateSlot:45')
-      }
-    }
-
     return pos
   }
   bot._genericPlace = _genericPlace

package/lib/plugins/inventory.js

@@ -427,13 +427,24 @@ function inject (bot, { version, hideErrors }) {
   function confirmTransaction (windowId, actionId, accepted) {
     // drop the queue entries for all the clicks that the server did not send
     // transaction packets for.
-    let click = windowClickQueue.shift()
-    if (click === undefined) {
+    // Also reject transactions that aren't sent from mineflayer
+    let click = windowClickQueue[0]
+    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,
+        action: actionId,
+        accepted: true
+        // bot.emit(`confirmTransaction${click.id}`, false)
+      })
       if (!hideErrors) {
         console.log(`WARNING : unknown transaction confirmation for window ${windowId}, action ${actionId} and accepted ${accepted}`)
       }
       return
     }
+    // shift it later if packets are sent out of order
+    click = windowClickQueue.shift()
+
     assert.ok(click.id <= actionId)
     while (actionId > click.id) {
       onAccepted()
@@ -534,7 +545,7 @@ function inject (bot, { version, hideErrors }) {
       }
       const [success] = await response
       if (!success) {
-        throw new Error(`Server rejected transaction for clicking on slot ${slot}, on window ${JSON.stringify(window.slots, null, 2)}.`)
+        throw new Error(`Server rejected transaction for clicking on slot ${slot}, on window with id ${window?.id}.`)
       }
     } else {
       await waitForWindowUpdate(window, slot)
@@ -564,9 +575,6 @@ function inject (bot, { version, hideErrors }) {
 
   bot._client.on('transaction', (packet) => {
     // confirm transaction
-    if (packet.action < 0) {
-      return
-    }
     confirmTransaction(packet.windowId, packet.action, packet.accepted)
   })
 

package/lib/plugins/physics.js

@@ -33,6 +33,7 @@ function inject (bot, { physicsEnabled }) {
     sneak: false
   }
   let lastSentYaw = null
+  let lastSentPitch = null
   let doPhysicsTimer = null
   let lastPhysicsFrameTime = null
   let shouldUsePhysics = false
@@ -122,13 +123,16 @@ function inject (bot, { physicsEnabled }) {
 
     // Increment the yaw in baby steps so that notchian clients (not the server) can keep up.
     const dYaw = deltaYaw(bot.entity.yaw, lastSentYaw)
+    const dPitch = bot.entity.pitch - (lastSentPitch || 0)
 
     // Vanilla doesn't clamp yaw, so we don't want to do it either
     const maxDeltaYaw = dt * physics.yawSpeed
+    const maxDeltaPitch = dt * physics.pitchSpeed
     lastSentYaw += math.clamp(-maxDeltaYaw, dYaw, maxDeltaYaw)
+    lastSentPitch += math.clamp(-maxDeltaPitch, dPitch, maxDeltaPitch)
 
-    const yaw = conv.toNotchianYaw(lastSentYaw)
-    const pitch = conv.toNotchianPitch(bot.entity.pitch)
+    const yaw = Math.fround(conv.toNotchianYaw(lastSentYaw))
+    const pitch = Math.fround(conv.toNotchianPitch(lastSentPitch))
     const position = bot.entity.position
     const onGround = bot.entity.onGround
 
@@ -225,10 +229,18 @@ function inject (bot, { physicsEnabled }) {
     }
     lookingTask = createTask()
 
-    bot.entity.yaw = yaw
-    bot.entity.pitch = pitch
+    // this is done to bypass certain anticheat checks that detect the player's sensitivity
+    // by calculating the gcd of how much they move the mouse each tick
+    const sensitivity = conv.fromNotchianPitch(0.15) // this is equal to 100% sensitivity in vanilla
+    const yawChange = Math.round((yaw - bot.entity.yaw) / sensitivity) * sensitivity
+    const pitchChange = Math.round((pitch - bot.entity.pitch) / sensitivity) * sensitivity
+
+    bot.entity.yaw += yawChange
+    bot.entity.pitch += pitchChange
+
     if (force) {
       lastSentYaw = yaw
+      lastSentPitch = pitch
       return
     }
 

package/lib/plugins/place_block.js

@@ -21,7 +21,7 @@ function inject (bot) {
   }
 
   async function placeBlock (referenceBlock, faceVector) {
-    await placeBlockWithOptions(referenceBlock, faceVector, {})
+    await placeBlockWithOptions(referenceBlock, faceVector, { swingArm: 'right' })
   }
 
   bot.placeBlock = callbackify(placeBlock)

package/lib/plugins/place_entity.js

@@ -5,6 +5,12 @@ module.exports = inject
 function inject (bot, { version }) {
   const Item = require('prismarine-item')(version)
 
+  /**
+   *
+   * @param {import('prismarine-block').Block} referenceBlock
+   * @param {import('vec3').Vec3} faceVector
+   * @param {{forceLook?: boolean | 'ignore', offhand?: boolean, swingArm?: 'right' | 'left', showHand?: boolean}} options
+   */
   async function placeEntityWithOptions (referenceBlock, faceVector, options) {
     if (!bot.heldItem) throw new Error('must be holding an item to place an entity')
 
@@ -20,14 +26,14 @@ function inject (bot, { version }) {
       name = bot.heldItem.spawnEggMobName
     }
 
-    const pos = await bot._genericPlace(referenceBlock, faceVector, options)
-
     if (type === 'spawn_egg') {
-      bot.swingArm(undefined, false)
-    } else {
-      bot.swingArm()
+      options.showHand = false
     }
 
+    if (!options.swingArm) options.swingArm = options.offhand ? 'left' : 'right'
+
+    const pos = await bot._genericPlace(referenceBlock, faceVector, options)
+
     if (type === 'boat') {
       if (bot.supportFeature('useItemWithOwnPacket')) {
         bot._client.write('use_item', {

package/lib/plugins/ray_trace.js

@@ -23,4 +23,14 @@ module.exports = (bot) => {
 
     return bot.world.raycast(eyePosition, viewDirection, maxDistance, matcher)
   }
+
+  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
+
+    const eyePosition = position.offset(0, height, 0)
+    const viewDirection = getViewDirection(pitch, yaw)
+
+    return bot.world.raycast(eyePosition, viewDirection, maxDistance, matcher)
+  }
 }

package/lib/plugins/scoreboard.js

@@ -1,9 +1,7 @@
-const ScoreBoard = require('../scoreboard')
-
 module.exports = inject
 
 function inject (bot) {
-  const ChatMessage = require('prismarine-chat')(bot.version)
+  const ScoreBoard = require('../scoreboard')(bot)
   const scoreboards = {}
 
   bot._client.on('scoreboard_objective', (packet) => {
@@ -29,12 +27,7 @@ function inject (bot) {
   bot._client.on('scoreboard_score', (packet) => {
     const scoreboard = scoreboards[packet.scoreName]
     if (scoreboard !== undefined && packet.action === 0) {
-      const { itemName, value } = packet
-      let displayName = new ChatMessage(itemName)
-      if (itemName in bot.teamMap) {
-        displayName = bot.teamMap[itemName].displayName(itemName)
-      }
-      const updated = scoreboard.add(itemName, value, displayName)
+      const updated = scoreboard.add(packet.itemName, packet.value)
       bot.emit('scoreUpdated', scoreboard, updated)
     }
 

package/lib/plugins/villager.js

@@ -118,7 +118,6 @@ function inject (bot, { version }) {
       if (!ready) {
         ready = true
         villager.emit('ready')
-        console.log('emit ready')
       }
     }
   }

package/lib/scoreboard.js

@@ -4,49 +4,62 @@ const sortItems = (a, b) => {
   return 1
 }
 
-class ScoreBoard {
-  constructor (packet) {
-    this.name = packet.name
-    this.setTitle(packet.displayText)
-    this.itemsMap = {}
-  }
+module.exports = (bot) => {
+  const ChatMessage = require('prismarine-chat')(bot.version)
 
-  setTitle (title) {
-    try {
-      this.title = JSON.parse(title).text // version>1.13
-    } catch {
-      this.title = title
+  class ScoreBoard {
+    constructor (packet) {
+      this.name = packet.name
+      this.setTitle(packet.displayText)
+      this.itemsMap = {}
     }
-  }
 
-  add (name, value, displayName) {
-    this.itemsMap[name] = { name, value, displayName }
-    return this.itemsMap[name]
-  }
+    setTitle (title) {
+      try {
+        this.title = JSON.parse(title).text // version>1.13
+      } catch {
+        this.title = title
+      }
+    }
 
-  remove (name) {
-    const removed = this.itemsMap[name]
-    delete this.itemsMap[name]
-    return removed
-  }
+    add (name, value) {
+      this.itemsMap[name] = { name, value }
+      this.itemsMap[name] = {
+        name,
+        value,
+        get displayName () {
+          if (name in bot.teamMap) {
+            return bot.teamMap[name].displayName(name)
+          }
+          return new ChatMessage(name)
+        }
+      }
+      return this.itemsMap[name]
+    }
 
-  get items () {
-    return Object.values(this.itemsMap).sort(sortItems)
+    remove (name) {
+      const removed = this.itemsMap[name]
+      delete this.itemsMap[name]
+      return removed
+    }
+
+    get items () {
+      return Object.values(this.itemsMap).sort(sortItems)
+    }
   }
-}
 
-ScoreBoard.positions = {
-  get list () {
-    return this[0]
-  },
+  ScoreBoard.positions = {
+    get list () {
+      return this[0]
+    },
 
-  get sidebar () {
-    return this[1]
-  },
+    get sidebar () {
+      return this[1]
+    },
 
-  get belowName () {
-    return this[2]
+    get belowName () {
+      return this[2]
+    }
   }
+  return ScoreBoard
 }
-
-module.exports = ScoreBoard

package/lib/version.js

@@ -1,4 +1,4 @@
 module.exports = {
   supportedVersions: ['1.8', '1.9', '1.10', '1.11', '1.12', '1.13', '1.14', '1.15', '1.16', '1.17'],
-  testedVersions: ['1.8.8', '1.9.4', '1.10.2', '1.11.2', '1.12.2', '1.13.2', '1.14.4', '1.15.2', '1.16.5', '1.17', '1.17.1']
+  testedVersions: ['1.8.8', '1.9.4', '1.10.2', '1.11.2', '1.12.2', '1.13.2', '1.14.4', '1.15.2', '1.16.5', '1.17.1']
 } // when updating testedVersions, make sure to update CI.yml

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mineflayer",
-  "version": "3.11.1",
+  "version": "3.13.1",
   "description": "create minecraft bots with a stable, high level API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -21,31 +21,32 @@
   },
   "license": "MIT",
   "dependencies": {
-    "minecraft-data": "^2.79.0",
-    "minecraft-protocol": "^1.17.0",
-    "prismarine-biome": "^1.1.0",
-    "prismarine-block": "^1.6.0",
-    "prismarine-chat": "^1.1.0",
-    "prismarine-chunk": "^1.24.0",
-    "prismarine-entity": "^1.0.0",
-    "prismarine-item": "^1.6.0",
-    "prismarine-physics": "^1.0.4",
+    "minecraft-data": "^2.95.0",
+    "minecraft-protocol": "^1.26.5",
+    "prismarine-biome": "^1.1.1",
+    "prismarine-block": "^1.10.3",
+    "prismarine-chat": "^1.3.3",
+    "prismarine-chunk": "^1.26.0",
+    "prismarine-entity": "^1.2.0",
+    "prismarine-item": "^1.11.0",
+    "prismarine-nbt": "^2.0.0",
+    "prismarine-physics": "^1.3.1",
     "prismarine-recipe": "^1.1.0",
-    "prismarine-windows": "^2.3.0",
+    "prismarine-windows": "^2.4.2",
     "prismarine-world": "^3.6.0",
-    "protodef": "^1.8.0",
-    "typed-emitter": "^1.2.0",
-    "vec3": "^0.1.6"
+    "protodef": "^1.14.0",
+    "typed-emitter": "^1.3.1",
+    "vec3": "^0.1.7"
   },
   "devDependencies": {
-    "@types/node": "^16.0.1",
-    "doctoc": "^2.0.0",
-    "minecraft-wrap": "^1.2.1",
+    "@types/node": "^17.0.0",
+    "doctoc": "^2.0.1",
+    "minecraft-wrap": "^1.3.0",
     "mineflayer": "file:.",
-    "mocha": "^9.0.0",
-    "standard": "^16.0.1",
-    "standard-markdown": "^7.0.0",
-    "ts-standard": "^10.0.0",
-    "typescript": "^4.3.2"
+    "mocha": "^9.1.2",
+    "standard": "^16.0.4",
+    "standard-markdown": "^7.1.0",
+    "ts-standard": "^11.0.0",
+    "typescript": "^4.4.3"
   }
 }