mineflayer 4.23.0 → 4.24.0

package/docs/CONTRIBUTING.md

@@ -22,6 +22,22 @@ Mineflayer has two kind of tests :
  
 The objective of these tests is to know automatically what works and what doesn't in mineflayer, so it's easier to make mineflayer work.
 
+
+## Running tests
+You can run tests for Different Minecraft versions using the `-g` flag with npm run mocha_test. For example:
+
+```bash
+# Run all tests in all supported versions
+npm run test
+
+# Run a specific test in Minecraft 1.20.4
+npm run mocha_test -- -g "mineflayer_external 1.20.4v.*exampleBee"
+
+# Run all tests in just version 1.20.4
+npm run mocha_test -- -g "mineflayer_external 1.20.4v"
+```
+
+
 ### Creating an external test
 
 In order to add an external test now you only need to create a file in [test/externalTests](test/externalTests)

package/docs/FAQ.md

@@ -2,6 +2,10 @@
 
 This Frequently Asked Question document is meant to help people for the most common things.
 
+### I get an error (ie. protocol/data) when bot is trying to connect to minecraft server
+
+Make sure the Minecraft server version is supported (cf. root readme), else you should retry using one of the [mineflayer tested versions](../lib/version.js).
+
 ### I get an error when trying to login with a microsoft account.
 
 Make sure the email you entered into the username option in createBot can be used to login to `minecraft.net` using the 'Login with Microsoft' button.

package/docs/api.md

@@ -169,7 +169,7 @@
       - ["respawn"](#respawn)
       - ["game"](#game)
       - ["resourcePack" (url, hash)](#resourcepack-url-hash)
-      - ["title"](#title)
+      - ["title" (title, type)](#title-title-type)
       - ["rain"](#rain)
       - ["weatherUpdate"](#weatherupdate)
       - ["time"](#time)
@@ -1237,11 +1237,12 @@ Emitted when the server changes any of the game properties.
 
 Emitted when the server sends a resource pack.
 
-#### "title"
+#### "title" (title, type)
 
 Emitted when the server sends a title
 
- * `text` - title's text
+ * `title` - title's text
+ * `type` - title's type "subtitle" or "title"
 
 #### "rain"
 
@@ -1771,7 +1772,7 @@ Checks if the given plugin is loaded (or scheduled to be loaded) on this bot.
 
 This function returns a `Promise`, with `void` as its argument upon completion.
 
-Sleep in a bed. `bedBlock` should be a `Block` instance which is a bed. 
+Sleep in a bed. `bedBlock` should be a `Block` instance which is a bed.
 
 #### bot.isABed(bedBlock)
 
@@ -1781,7 +1782,7 @@ Return true if `bedBlock` is a bed
 
 This function returns a `Promise`, with `void` as its argument upon completion.
 
-Get out of bed. 
+Get out of bed.
 
 #### bot.setControlState(control, state)
 
@@ -2120,7 +2121,7 @@ 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 dragging is not implemented.
 
 Click on the current window. See details at https://wiki.vg/Protocol#Click_Container

package/docs/br/api_br.md

@@ -141,7 +141,7 @@
       - ["respawn"](#respawn)
       - ["game"](#game)
       - ["resourcePack" (url, hash)](#resourcepack-url-hash)
-      - ["title"](#title)
+      - ["title" (title, type)](#title-title-type)
       - ["rain"](#rain)
       - ["weatherUpdate"](#weatherupdate)
       - ["time"](#time)
@@ -1060,11 +1060,12 @@ Este evento é emitido quando o arquivo index é carregado. Você pode carregar
 
 É emitido quando o servidor envia um pacote de recursos.
 
-#### "title"
+#### "title" (title, type)
 
 É emitido quando o servidor exibe um título.
 
- * `text` - texto do título
+ * `title` - texto do título
+ * `type` - tipo do título "subtitle" ou "title"
 
 #### "rain"
 
@@ -2035,4 +2036,4 @@ Observação: enquanto você voa, `bot.entity.velocity` não é preciso.
 
 #### bot.creative.stopFlying()
 
-Restaura `bot.physics.gravity` ao seu valor original.
+Restaura `bot.physics.gravity` ao seu valor original.

package/docs/es/api_es.md

@@ -141,7 +141,7 @@
       - ["respawn"](#respawn)
       - ["game"](#game)
       - ["resourcePack" (url, hash)](#resourcepack-url-hash)
-      - ["title"](#title)
+      - ["title" (title, type)](#title-title-type)
       - ["rain"](#rain)
       - ["weatherUpdate"](#weatherupdate)
       - ["time"](#time)
@@ -1071,11 +1071,12 @@ Se emite cuando el servidor cambia cualquiera de sus propiedades
 
 Se emite cuando el servidor manda un paquete de recursos
 
-#### "title"
+#### "title" (title, type)
 
 Se emite cuando el servidor manda/muestra un título
 
- * `text` - texto del título
+ * `title` - texto del título
+ * `type` - tipo del título "subtitle" o "title"
 
 #### "rain"
 

package/docs/history.md

@@ -1,3 +1,17 @@
+## 4.24.0
+* [Support 1.21.3. (#3489)](https://github.com/PrismarineJS/mineflayer/commit/58ae9e5b5abf75139f4ba93fe4f34ef7ed3936e8) (thanks @rom1504)
+* [Fix out of bounds access leading to crash at spawn (#3535)](https://github.com/PrismarineJS/mineflayer/commit/3187368397e880ba8b32bb03affa18203cbcbb42) (thanks @wAIfu-DEV)
+* [fix: use dimension data on 1.16.2 (#3397)](https://github.com/PrismarineJS/mineflayer/commit/f6187f66c16dd122165287be7864c78b2fe7c32c) (thanks @zardoy)
+* [update contribution docs to show test running commands (#3511)](https://github.com/PrismarineJS/mineflayer/commit/71a3a262681a173db86b8911aec82402a6993d21) (thanks @Madlykeanu)
+* [Update inventory.js (#3507)](https://github.com/PrismarineJS/mineflayer/commit/a0e92cad5887181bf7e235f69378c8ede14a350c) (thanks @Pix3lPirat3)
+* [Update FAQ.md - add mineflayer tested versions : lib/version.js (#3517)](https://github.com/PrismarineJS/mineflayer/commit/f2dd3a37505b374bf63119633659e35ec2ce3542) (thanks @boly38)
+* [Bump protodef from 1.17.0 to 1.18.0 (#3523)](https://github.com/PrismarineJS/mineflayer/commit/06faa36c2da3da399bd5370869700aea6c65c9b0) (thanks @dependabot[bot])
+* [Bump mocha from 10.8.2 to 11.0.1 (#3516)](https://github.com/PrismarineJS/mineflayer/commit/166971d317db3ec68cf3eebeda37f509152628fd) (thanks @dependabot[bot])
+* [Fix chatterbox example (#3506)](https://github.com/PrismarineJS/mineflayer/commit/386200759556aa261fa212f26c43992a66cfa8ac) (thanks @ShiftSad)
+* [Proper title event (#3498)](https://github.com/PrismarineJS/mineflayer/commit/3829a25150eec782bc045a222476865af7b0ac72) (thanks @SMEDjs)
+* [Set `sequence` field correctly in activateItem (#3445)](https://github.com/PrismarineJS/mineflayer/commit/fdba03737ecdeaaf419e3175b9be33291db4e085) (thanks @GenerelSchwerz)
+* [increase timeout in external test common](https://github.com/PrismarineJS/mineflayer/commit/3d6e2344751c38428701dc52e9f29dda73f7f782) (thanks @rom1504)
+
 ## 4.23.0
 * [1.21 (#3480)](https://github.com/PrismarineJS/mineflayer/commit/4aa10fb45431940504c7809f078f1f410e7fa7a3) (thanks @Madlykeanu)
 * [Adding mindcraft to mineflayer readme](https://github.com/PrismarineJS/mineflayer/commit/dd00db42ba20682418d8fbd5629e1033dfb0ff20) (thanks @rom1504)

package/docs/ru/api_ru.md

@@ -169,7 +169,7 @@
       - ["respawn"](#respawn)
       - ["game"](#game)
       - ["resourcePack" (url, hash)](#resourcepack-url-hash)
-      - ["title"](#title)
+      - ["title" (title, type)](#title-title-type)
       - ["rain"](#rain)
       - ["weatherUpdate"](#weatherupdate)
       - ["time"](#time)
@@ -1264,11 +1264,12 @@ UUID существа, который определяется боссом.
 
 Срабатывает, когда сервер отправляет ресурспак.
 
-#### "title"
+#### "title" (title, type)
 
 Срабатывает, когда сервер отправляет текст по центру экрана.
 
- * `text` - Текст на экране.
+ * `title` - Текст на экране.
+ * `type` - Тип текста "subtitle" или "title"
 
 #### "rain"
 
@@ -1634,7 +1635,7 @@ UUID существа, который определяется боссом.
 
 #### bot.recipesFor(itemType, metadata, minResultCount, craftingTable)
 
-Возвращает список рецептов(`Recipe`), которые вы можете использовать для крафта 
+Возвращает список рецептов(`Recipe`), которые вы можете использовать для крафта
 предмета(`itemType`) с мета-данными(`metadata`).
 
  * `itemType` - Числовой ID предмета, который вы хотите создать.
@@ -2116,7 +2117,7 @@ bot.once('login', () => {
 #### bot.clickWindow(slot, mouseButton, mode)
 
 Эта функция возвращает `Promise` с `void` в качестве аргумента при завершении.
-  
+
 Единственное действительное значение для `mode` - 0. Нажатие с шифтом или перемещение через мышь не реализовано.
 
 Нажимает на текущее окно. Подробнее - https://wiki.vg/Protocol#Click_Container

package/docs/zh/api.md

@@ -153,7 +153,7 @@
       - ["respawn"](#respawn)
       - ["game"](#game)
       - ["resourcePack" (url, hash)](#resourcepack-url-hash)
-      - ["title"](#title)
+      - ["title" (title, type)](#title-title-type)
       - ["rain"](#rain)
       - ["weatherUpdate"](#weatherupdate)
       - ["time"](#time)
@@ -1127,11 +1127,12 @@ Emitted for every server message, including chats.
 
 当服务器发送资源包时触发
 
-#### "title"
+#### "title" (title, type)
 
 当服务器发送标题时触发
 
- * `text` - 标题文本
+ * `title` - 标题文本
+ * `type` - 标题类型 "subtitle" 或 "title"
 
 #### "rain"
 
@@ -1150,11 +1151,11 @@ If you join a server where it is already raining, this event will fire.
 
 当bot从服务器被踢出时触发
 
- `reason`是一条解释你被踢的原因的聊天信息. 
+ `reason`是一条解释你被踢的原因的聊天信息.
 
 `loggedIn`
  如果客户端在成功登录后被踢出则为`true`
-如果kick发生在登录阶段则为 `false` 
+如果kick发生在登录阶段则为 `false`
 
 #### "end" (reason)
 

package/examples/python/chatterbox.py

@@ -30,8 +30,7 @@ username = sys.argv[3] if len(sys.argv) > 3 else "boat"
 bot = mineflayer.createBot({
     "host": host,
     "port": port,
-    "username": username,
-    "port": port
+    "username": username
 })
 
 Item = require("prismarine-item")(bot.registry)
@@ -300,4 +299,4 @@ def entityEffect(this, entity, effect):
 
 @On(bot, "entityEffectEnd")
 def entityEffectEnd(this, entity, effect):
-    print("entityEffectEnd", entity, effect)
+    print("entityEffectEnd", entity, effect)

package/examples/titles.js

@@ -0,0 +1,22 @@
+/*
+ * An example of how to handle title events from the server.
+ */
+const mineflayer = require('mineflayer')
+
+if (process.argv.length < 4 || process.argv.length > 6) {
+  console.log('Usage : node titles.js <host> <port> [<name>] [<password>]')
+  process.exit(1)
+}
+
+const bot = mineflayer.createBot({
+  host: process.argv[2],
+  port: parseInt(process.argv[3]),
+  username: process.argv[4] ? process.argv[4] : 'titles',
+  password: process.argv[5]
+})
+
+// This event is triggered when the server sends a title to the client.
+bot.on('title', (text, type) => {
+  // type is either "title" or "subtitle"
+  console.log(`Received ${type}: ${text}`)
+})

package/index.d.ts

@@ -71,7 +71,7 @@ export interface BotEvents {
   spawn: () => Promise<void> | void
   respawn: () => Promise<void> | void
   game: () => Promise<void> | void
-  title: (text: string) => Promise<void> | void
+  title: (text: string, type: "subtitle" | "title") => Promise<void> | void
   rain: () => Promise<void> | void
   time: () => Promise<void> | void
   kicked: (reason: string, loggedIn: boolean) => Promise<void> | void

package/lib/plugins/blocks.js

@@ -261,7 +261,7 @@ function inject (bot, { version, storageBuilder, hideErrors }) {
       bot.world.setColumn(packet.chunkX, packet.chunkZ, column)
     }
 
-    if (bot.supportFeature('dimensionDataIsAvailable')) {
+    if (bot.supportFeature('newLightingDataFormat')) {
       column.loadParsedLight(packet.skyLight, packet.blockLight, packet.skyLightMask, packet.blockLightMask, packet.emptySkyLightMask, packet.emptyBlockLightMask)
     } else {
       column.loadLight(packet.data, packet.skyLightMask, packet.blockLightMask, packet.emptySkyLightMask, packet.emptyBlockLightMask)
@@ -395,10 +395,13 @@ function inject (bot, { version, storageBuilder, hideErrors }) {
   bot._client.on('explosion', (packet) => {
     // explosion
     const p = new Vec3(packet.x, packet.y, packet.z)
-    packet.affectedBlockOffsets.forEach((offset) => {
-      const pt = p.offset(offset.x, offset.y, offset.z)
-      updateBlockState(pt, 0)
-    })
+    if (packet.affectedBlockOffsets) {
+      // TODO: server no longer sends in 1.21.3. Is client supposed to compute this or is it sent via normal block updates?
+      packet.affectedBlockOffsets.forEach((offset) => {
+        const pt = p.offset(offset.x, offset.y, offset.z)
+        updateBlockState(pt, 0)
+      })
+    }
   })
 
   bot._client.on('spawn_entity_painting', (packet) => {

package/lib/plugins/breath.js

@@ -11,7 +11,7 @@ function inject (bot) {
     if (bot.entity.id !== packet.entityId) return
     for (const metadata of packet.metadata) {
       if (metadata.key === 1) {
-        bot.oxygenLevel = Math.round(packet.metadata[1].value / 15)
+        bot.oxygenLevel = Math.round(metadata.value / 15)
         bot.emit('breath')
       }
     }

package/lib/plugins/creative.js

@@ -21,7 +21,7 @@ function inject (bot) {
   const creativeSlotsUpdates = []
 
   // WARN: This method should not be called twice on the same slot before first promise succeeds
-  async function setInventorySlot (slot, item) {
+  async function setInventorySlot (slot, item, waitTimeout = 400) {
     assert(slot >= 0 && slot <= 44)
 
     if (Item.equal(bot.inventory.slots[slot], item, true)) return
@@ -29,12 +29,32 @@ function inject (bot) {
       throw new Error(`Setting slot ${slot} cancelled due to calling bot.creative.setInventorySlot(${slot}, ...) again`)
     }
     creativeSlotsUpdates[slot] = true
-
     bot._client.write('set_creative_slot', {
       slot,
       item: Item.toNotch(item)
     })
 
+    if (bot.supportFeature('noAckOnCreateSetSlotPacket')) {
+      // No ack
+      bot._setSlot(slot, item)
+      if (waitTimeout === 0) return // no wait
+      // allow some time to see if server rejects
+      return new Promise((resolve, reject) => {
+        function updateSlot (oldItem, newItem) {
+          if (newItem.itemId !== item.itemId) {
+            creativeSlotsUpdates[slot] = false
+            reject(Error('Server rejected'))
+          }
+        }
+        bot.inventory.once(`updateSlot:${slot}`, updateSlot)
+        setTimeout(() => {
+          bot.inventory.off(`updateSlot:${slot}`, updateSlot)
+          creativeSlotsUpdates[slot] = false
+          resolve()
+        }, waitTimeout)
+      })
+    }
+
     await onceWithCleanup(bot.inventory, `updateSlot:${slot}`, {
       timeout: 5000,
       checkCondition: (oldItem, newItem) => item === null ? newItem === null : newItem?.name === item.name && newItem?.count === item.count && newItem?.metadata === item.metadata

package/lib/plugins/entities.js

@@ -341,6 +341,16 @@ function inject (bot) {
     bot.emit('entityMoved', entity)
   })
 
+  // 1.21.3 - merges the packets above
+  bot._client.on('sync_entity_position', (packet) => {
+    const entity = fetchEntity(packet.entityId)
+    entity.position.set(packet.x, packet.y, packet.z)
+    entity.velocity.update(packet.dx, packet.dy, packet.dz)
+    entity.yaw = packet.yaw
+    entity.pitch = packet.pitch
+    bot.emit('entityMoved', entity)
+  })
+
   bot._client.on('entity_head_rotation', (packet) => {
     // entity head look
     const entity = fetchEntity(packet.entityId)
@@ -361,6 +371,11 @@ function inject (bot) {
     if (eventName) bot.emit(eventName, entity)
   })
 
+  bot._client.on('damage_event', (packet) => { // 1.20+
+    const entity = bot.entities[packet.entityId]
+    bot.emit('entityHurt', entity)
+  })
+
   bot._client.on('attach_entity', (packet) => {
     // attach entity
     const entity = fetchEntity(packet.entityId)
@@ -585,6 +600,62 @@ function inject (bot) {
   bot._client.on('player_info', (packet) => {
     // player list item(s)
 
+    if (typeof packet.action !== 'number') {
+      // the features checks below this will be un-needed with https://github.com/PrismarineJS/minecraft-data/pull/948
+      for (const update of packet.data) {
+        let player = bot.uuidToUsername[update.uuid] ? bot.players[bot.uuidToUsername[update.uuid]] : null
+        let newPlayer = false
+
+        const obj = {
+          uuid: update.uuid
+        }
+
+        if (!player) newPlayer = true
+
+        player ||= obj
+
+        if (packet.action.add_player) {
+          obj.username = update.player.name
+          obj.displayName = player.displayName || new ChatMessage({ text: '', extra: [{ text: update.player.name }] })
+          obj.skinData = extractSkinInformation(update.player.properties)
+        }
+
+        if (packet.action.update_game_mode) {
+          obj.gamemode = update.gamemode
+        }
+
+        if (packet.action.update_latency) {
+          obj.ping = update.latency
+        }
+
+        if (update.displayName) {
+          obj.displayName = ChatMessage.fromNotch(update.displayName)
+        }
+
+        if (newPlayer) {
+          if (!obj.username) continue // Should be unreachable
+          player = bot.players[obj.username] = obj
+          bot.uuidToUsername[obj.uuid] = obj.username
+        } else {
+          Object.assign(player, obj)
+        }
+
+        const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === player.username)
+        player.entity = playerEntity
+
+        if (playerEntity === bot.entity) {
+          bot.player = player
+        }
+
+        if (newPlayer) {
+          bot.emit('playerJoined', player)
+        } else {
+          bot.emit('playerUpdated', player)
+        }
+      }
+      return
+    }
+
     if (bot.supportFeature('playerInfoActionIsBitfield')) {
       for (const item of packet.data) {
         let player = bot.uuidToUsername[item.uuid] ? bot.players[bot.uuidToUsername[item.uuid]] : null
@@ -795,20 +866,42 @@ function inject (bot) {
   }
 
   function moveVehicle (left, forward) {
-    bot._client.write('steer_vehicle', {
-      sideways: left,
-      forward,
-      jump: 0x01
-    })
+    if (bot.supportFeature('newPlayerInputPacket')) {
+      // docs:
+      // * left can take -1 or 1 : -1 means right, 1 means left
+      // * forward can take -1 or 1 : -1 means backward, 1 means forward
+      bot._client.write('player_input', {
+        inputs: {
+          forward: forward > 0,
+          backward: forward < 0,
+          left: left > 0,
+          right: left < 0
+        }
+      })
+    } else {
+      bot._client.write('steer_vehicle', {
+        sideways: left,
+        forward,
+        jump: 0x01
+      })
+    }
   }
 
   function dismount () {
     if (bot.vehicle) {
-      bot._client.write('steer_vehicle', {
-        sideways: 0.0,
-        forward: 0.0,
-        jump: 0x02
-      })
+      if (bot.supportFeature('newPlayerInputPacket')) {
+        bot._client.write('player_input', {
+          inputs: {
+            jump: true
+          }
+        })
+      } else {
+        bot._client.write('steer_vehicle', {
+          sideways: 0.0,
+          forward: 0.0,
+          jump: 0x02
+        })
+      }
     } else {
       bot.emit('error', new Error('dismount: not mounted'))
     }

package/lib/plugins/game.js

@@ -10,7 +10,12 @@ const dimensionNames = {
   1: 'the_end'
 }
 
-const parseGameMode = gameModeBits => gameModes[(gameModeBits & 0b11)] // lower two bits
+const parseGameMode = gameModeBits => {
+  if (gameModeBits < 0 || gameModeBits > 0b11) {
+    return 'survival'
+  }
+  return gameModes[(gameModeBits & 0b11)] // lower two bits
+}
 
 function inject (bot, options) {
   function getBrandCustomChannelName () {
@@ -25,7 +30,12 @@ function inject (bot, options) {
   function handleRespawnPacketData (packet) {
     bot.game.levelType = packet.levelType ?? (packet.isFlat ? 'flat' : 'default')
     bot.game.hardcore = packet.isHardcore ?? Boolean(packet.gameMode & 0b100)
-    bot.game.gameMode = packet.gamemode || parseGameMode(packet.gameMode)
+    // Either a respawn packet or a login packet. Depending on the packet it can be "gamemode" or "gameMode"
+    if (bot.supportFeature('spawnRespawnWorldDataField')) { // 1.20.5
+      bot.game.gameMode = packet.gamemode
+    } else {
+      bot.game.gameMode = parseGameMode(packet.gamemode ?? packet.gameMode)
+    }
     if (bot.supportFeature('segmentedRegistryCodecData')) { // 1.20.5
       if (typeof packet.dimension === 'number') {
         bot.game.dimension = bot.registry.dimensionsArray[packet.dimension]?.name?.replace('minecraft:', '')
@@ -60,7 +70,7 @@ function inject (bot, options) {
         bot.game.minY = dimData.minY
         bot.game.height = dimData.height
       }
-    } else if (bot.supportFeature('dimensionDataIsAvailable')) { // 1.18
+    } else if (bot.supportFeature('dimensionDataIsAvailable')) { // 1.16.2+
       const dimensionData = nbt.simplify(packet.dimension)
       bot.game.minY = dimensionData.min_y
       bot.game.height = dimensionData.height

package/lib/plugins/generic_place.js

@@ -79,7 +79,9 @@ function inject (bot) {
         cursorX: dx,
         cursorY: dy,
         cursorZ: dz,
-        insideBlock: false
+        insideBlock: false,
+        sequence: 0, // 1.19.0
+        worldBorderHit: false // 1.21.3
       })
     }
 

package/lib/plugins/inventory.js

@@ -26,6 +26,7 @@ function inject (bot, { hideErrors }) {
   const windows = require('prismarine-windows')(bot.version)
 
   let eatingTask = createDoneTask()
+  let sequence = 0
 
   let nextActionNumber = 0 // < 1.17
   let stateId = -1
@@ -43,6 +44,7 @@ function inject (bot, { hideErrors }) {
   bot.inventory = windows.createWindow(0, 'minecraft:inventory', 'Inventory')
   bot.currentWindow = null
   bot.usingHeldItem = false
+
   Object.defineProperty(bot, 'heldItem', {
     get: function () {
       return bot.inventory.slots[bot.QUICK_BAR_START + bot.quickBarSlot]
@@ -111,6 +113,8 @@ function inject (bot, { hideErrors }) {
 
   function activateItem (offHand = false) {
     bot.usingHeldItem = true
+    sequence++
+
     if (bot.supportFeature('useItemWithBlockPlace')) {
       bot._client.write('block_place', {
         location: new Vec3(-1, 255, -1),
@@ -123,17 +127,26 @@ function inject (bot, { hideErrors }) {
     } else if (bot.supportFeature('useItemWithOwnPacket')) {
       bot._client.write('use_item', {
         hand: offHand ? 1 : 0,
+        sequence,
         rotation: { x: 0, y: 0 }
       })
     }
   }
 
   function deactivateItem () {
-    bot._client.write('block_dig', {
+    const body = {
       status: 5,
       location: new Vec3(0, 0, 0),
       face: 5
-    })
+    }
+
+    if (bot.supportFeature('useItemWithOwnPacket')) {
+      body.face = 0
+      body.sequence = 0
+    }
+
+    bot._client.write('block_dig', body)
+
     bot.usingHeldItem = false
   }
 
@@ -177,6 +190,7 @@ function inject (bot, { hideErrors }) {
     // 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
+    // TODO: logic below can likely be simplified
     if (bot.supportFeature('blockPlaceHasHeldItem')) {
       bot._client.write('block_place', {
         location: block.position,
@@ -212,7 +226,9 @@ function inject (bot, { hideErrors }) {
         cursorX: cursorPos.x,
         cursorY: cursorPos.y,
         cursorZ: cursorPos.z,
-        insideBlock: false
+        insideBlock: false,
+        sequence: 0, // 1.19.0+
+        worldBorderHit: false // 1.21.3+
       })
     }
 
@@ -250,7 +266,7 @@ function inject (bot, { hideErrors }) {
     const itemType = options.itemType
     const metadata = options.metadata
     const nbt = options.nbt
-    let count = options.count === null ? 1 : options.count
+    let count = (options.count === undefined || options.count === null) ? 1 : options.count
     let firstSourceSlot = null
 
     // ranges
@@ -699,15 +715,18 @@ function inject (bot, { hideErrors }) {
     bot.currentWindow = null
     bot.emit('windowClose', oldWindow)
   })
-  bot._client.on('set_slot', (packet) => {
+  bot._setSlot = (slotId, newItem, window = bot.inventory) => {
     // set slot
+    const oldItem = window.slots[slotId]
+    window.updateSlot(slotId, newItem)
+    updateHeldItem()
+    bot.emit(`setSlot:${window.id}`, oldItem, newItem)
+  }
+  bot._client.on('set_slot', (packet) => {
     const window = packet.windowId === 0 ? bot.inventory : bot.currentWindow
     if (!window || window.id !== packet.windowId) return
     const newItem = Item.fromNotch(packet.item)
-    const oldItem = window.slots[packet.slot]
-    window.updateSlot(packet.slot, newItem)
-    updateHeldItem()
-    bot.emit(`setSlot:${window.id}`, oldItem, newItem)
+    bot._setSlot(packet.slot, newItem, window)
   })
   bot._client.on('window_items', (packet) => {
     const window = packet.windowId === 0 ? bot.inventory : bot.currentWindow

package/lib/plugins/physics.js

@@ -48,7 +48,8 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
     yaw: 0,
     pitch: 0,
     onGround: false,
-    time: 0
+    time: 0,
+    flags: { onGround: false, hasHorizontalCollision: false }
   }
 
   // This function should be executed each tick (every 0.05 seconds)
@@ -103,6 +104,7 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
     lastSent.y = position.y
     lastSent.z = position.z
     lastSent.onGround = onGround
+    lastSent.flags = { onGround, hasHorizontalCollision: undefined } // 1.21.3+
     bot._client.write('position', lastSent)
     bot.emit('move', oldPos)
   }
@@ -113,6 +115,7 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
     lastSent.yaw = yaw
     lastSent.pitch = pitch
     lastSent.onGround = onGround
+    lastSent.flags = { onGround, hasHorizontalCollision: undefined } // 1.21.3+
     bot._client.write('look', lastSent)
     bot.emit('move', oldPos)
   }
@@ -126,6 +129,7 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
     lastSent.yaw = yaw
     lastSent.pitch = pitch
     lastSent.onGround = onGround
+    lastSent.flags = { onGround, hasHorizontalCollision: undefined } // 1.21.3+
     bot._client.write('position_look', lastSent)
     bot.emit('move', oldPos)
   }
@@ -167,9 +171,9 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
 
     // Only send a position update if necessary, select the appropriate packet
     const positionUpdated = lastSent.x !== position.x || lastSent.y !== position.y || lastSent.z !== position.z ||
-    // Send a position update every second, even if no other update was made
-    // This function rounds to the nearest 50ms (or PHYSICS_INTERVAL_MS) and checks if a second has passed.
-    (Math.round((now - lastSent.time) / PHYSICS_INTERVAL_MS) * PHYSICS_INTERVAL_MS) >= 1000
+      // Send a position update every second, even if no other update was made
+      // This function rounds to the nearest 50ms (or PHYSICS_INTERVAL_MS) and checks if a second has passed.
+      (Math.round((now - lastSent.time) / PHYSICS_INTERVAL_MS) * PHYSICS_INTERVAL_MS) >= 1000
     const lookUpdated = lastSent.yaw !== yaw || lastSent.pitch !== pitch
 
     if (positionUpdated && lookUpdated) {
@@ -184,7 +188,10 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
       // For versions < 1.12, one player packet should be sent every tick
       // for the server to update health correctly
       // For versions >= 1.12, onGround !== lastSent.onGround should be used, but it doesn't ever trigger outside of login
-      bot._client.write('flying', { onGround: bot.entity.onGround })
+      bot._client.write('flying', {
+        onGround: bot.entity.onGround,
+        flags: { onGround: bot.entity.onGround, hasHorizontalCollision: undefined } // 1.21.3+
+      })
     }
 
     lastSent.onGround = bot.entity.onGround // onGround is always set
@@ -288,9 +295,14 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
   bot._client.on('explosion', explosion => {
     // TODO: emit an explosion event with more info
     if (bot.physicsEnabled && bot.game.gameMode !== 'creative') {
-      bot.entity.velocity.x += explosion.playerMotionX
-      bot.entity.velocity.y += explosion.playerMotionY
-      bot.entity.velocity.z += explosion.playerMotionZ
+      if (explosion.playerKnockback) { // 1.21.3+
+        bot.entity.velocity.add(explosion.playerMotionX, explosion.playerMotionY, explosion.playerMotionZ)
+      }
+      if ('playerMotionX' in explosion) {
+        bot.entity.velocity.x += explosion.playerMotionX
+        bot.entity.velocity.y += explosion.playerMotionY
+        bot.entity.velocity.z += explosion.playerMotionZ
+      }
     }
   })
 
@@ -330,30 +342,59 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
     await bot.look(yaw, pitch, force)
   }
 
+  // 1.21.3+
+  bot._client.on('player_rotation', (packet) => {
+    bot.entity.yaw = conv.fromNotchianYaw(packet.yaw)
+    bot.entity.pitch = conv.fromNotchianPitch(packet.pitch)
+  })
+
   // player position and look (clientbound)
   bot._client.on('position', (packet) => {
     // Is this necessary? Feels like it might wrongly overwrite hitbox size sometimes
     // e.g. when crouching/crawling/swimming. Can someone confirm?
     bot.entity.height = 1.8
 
-    // Velocity is only set to 0 if the flag is not set, otherwise keep current velocity
+    // Velocity is reset if the x, y, z flags are not set
     const vel = bot.entity.velocity
-    vel.set(
-      packet.flags & 1 ? vel.x : 0,
-      packet.flags & 2 ? vel.y : 0,
-      packet.flags & 4 ? vel.z : 0
-    )
-
-    // If flag is set, then the corresponding value is relative, else it is absolute
+    // If the x, y, z flags are not set, the position is absolute
     const pos = bot.entity.position
-    pos.set(
-      packet.flags & 1 ? (pos.x + packet.x) : packet.x,
-      packet.flags & 2 ? (pos.y + packet.y) : packet.y,
-      packet.flags & 4 ? (pos.z + packet.z) : packet.z
-    )
-
-    const newYaw = (packet.flags & 8 ? conv.toNotchianYaw(bot.entity.yaw) : 0) + packet.yaw
-    const newPitch = (packet.flags & 16 ? conv.toNotchianPitch(bot.entity.pitch) : 0) + packet.pitch
+
+    // TODO: this current mineflayer logic maybe incorrect. New (maybe even older) versions of minecraft have flag values for
+    // dx/dy/dz but mineflayer is assuming that 0b111 applies for both velocity and position.
+
+    let newYaw, newPitch
+
+    if (bot.registry.version['>=']('1.21.3')) {
+      // flags is now an object with keys
+      // "flags": ["x", "y", "z", "yaw", "pitch", "dx", "dy", "dz", "yawDelta"]
+      const flags = packet.flags
+      vel.set(
+        flags.x ? vel.x : 0,
+        flags.y ? vel.y : 0,
+        flags.z ? vel.z : 0
+      )
+      pos.set(
+        flags.x ? (pos.x + packet.x) : packet.x,
+        flags.y ? (pos.y + packet.y) : packet.y,
+        flags.z ? (pos.z + packet.z) : packet.z
+      )
+      newYaw = (flags.yaw ? conv.toNotchianYaw(bot.entity.yaw) : 0) + packet.yaw
+      newPitch = (flags.pitch ? conv.toNotchianPitch(bot.entity.pitch) : 0) + packet.pitch
+    } else {
+      vel.set(
+        packet.flags & 1 ? vel.x : 0,
+        packet.flags & 2 ? vel.y : 0,
+        packet.flags & 4 ? vel.z : 0
+      )
+      pos.set(
+        packet.flags & 1 ? (pos.x + packet.x) : packet.x,
+        packet.flags & 2 ? (pos.y + packet.y) : packet.y,
+        packet.flags & 4 ? (pos.z + packet.z) : packet.z
+      )
+      newYaw = (packet.flags & 8 ? conv.toNotchianYaw(bot.entity.yaw) : 0) + packet.yaw
+      newPitch = (packet.flags & 16 ? conv.toNotchianPitch(bot.entity.pitch) : 0) + packet.pitch
+    }
+
     bot.entity.yaw = conv.fromNotchianYaw(newYaw)
     bot.entity.pitch = conv.fromNotchianPitch(newPitch)
     bot.entity.onGround = false

package/lib/plugins/settings.js

@@ -87,7 +87,8 @@ function inject (bot, options) {
       : options.skinParts,
     mainHand: options.mainHand || 'right',
     enableTextFiltering: options.enableTextFiltering || false,
-    enableServerListing: options.enableServerListing || true
+    enableServerListing: options.enableServerListing || true,
+    particleStatus: 'all'
   }
 
   bot._client.on('login', () => {

package/lib/plugins/title.js

@@ -1,9 +1,14 @@
 module.exports = inject
-
 function inject (bot) {
   bot._client.on('title', (packet) => {
     if (packet.action === 0 || packet.action === 1) {
-      bot.emit('title', packet.text)
+      bot.emit('title', packet.text, 'title')
     }
   })
+  bot._client.on('set_title_text', packet => {
+    bot.emit('title', packet.text, 'title')
+  })
+  bot._client.on('set_title_subtitle', packet => {
+    bot.emit('title', packet.text, 'subtitle')
+  })
 }

package/lib/version.js

@@ -1,4 +1,4 @@
-const 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', '1.18.2', '1.19', '1.19.2', '1.19.3', '1.19.4', '1.20.1', '1.20.2', '1.20.4', '1.20.6', '1.21.1']
+const 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', '1.18.2', '1.19', '1.19.2', '1.19.3', '1.19.4', '1.20.1', '1.20.2', '1.20.4', '1.20.6', '1.21.1', '1.21.3']
 module.exports = {
 
   testedVersions,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "mineflayer",
-  "version": "4.23.0",
+  "version": "4.24.0",
   "description": "create minecraft bots with a stable, high level API",
   "main": "index.js",
   "types": "index.d.ts",
   "scripts": {
-    "mocha_test": "mocha --reporter spec --exit --bail",
+    "mocha_test": "mocha --reporter spec --exit",
     "test": "npm run mocha_test",
     "pretest": "npm run lint",
     "lint": "standard && standard-markdown",
@@ -22,7 +22,7 @@
   "license": "MIT",
   "dependencies": {
     "minecraft-data": "^3.76.0",
-    "minecraft-protocol": "^1.50.0",
+    "minecraft-protocol": "^1.51.0",
     "prismarine-biome": "^1.1.1",
     "prismarine-block": "^1.17.0",
     "prismarine-chat": "^1.7.1",
@@ -35,7 +35,7 @@
     "prismarine-registry": "^1.10.0",
     "prismarine-windows": "^2.9.0",
     "prismarine-world": "^3.6.0",
-    "protodef": "1.17.0",
+    "protodef": "^1.18.0",
     "typed-emitter": "^1.0.0",
     "vec3": "^0.1.7"
   },
@@ -44,7 +44,7 @@
     "doctoc": "^2.0.1",
     "minecraft-wrap": "^1.3.0",
     "mineflayer": "file:",
-    "mocha": "^10.0.0",
+    "mocha": "^11.0.1",
     "protodef-yaml": "^1.5.3",
     "standard": "^17.0.0",
     "standard-markdown": "^7.1.0",