Merge branch 'master' into master

docs/api.md

@@ -1774,6 +1774,8 @@ the event will be called `"chat:name"`, with name being the name passed
 
 returns a number which can be used with bot.removeChatPattern() to only delete this pattern
 
+- :eyes: cf. [examples/chat_parsing](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js#L17-L36)
+
 #### bot.addChatPatternSet(name, patterns, chatPatternOptions)
 
 make an event that is called every time all patterns havee been matched to messages,
@@ -1786,6 +1788,8 @@ the event will be called `"chat:name"`, with name being the name passed
 
 returns a number which can be used with bot.removeChatPattern() to only delete this patternset
 
+- :eyes: cf. [examples/chat_parsing](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js#L17-L36)
+
 #### bot.removeChatPattern(name)
 
 removes a chat pattern(s)

lib/bossbar.js

@@ -1,101 +1,98 @@
-let ChatMessage
 const colors = ['pink', 'blue', 'red', 'green', 'yellow', 'purple', 'white']
 const divisions = [0, 6, 10, 12, 20]
 
-module.exports = loader
-
 function loader (registry) {
-  ChatMessage = require('prismarine-chat')(registry)
-  return BossBar
-}
-
-class BossBar {
-  constructor (uuid, title, health, dividers, color, flags) {
-    this._entityUUID = uuid
-    this._title = new ChatMessage(JSON.parse(title))
-    this._health = health
-    this._dividers = divisions[dividers]
-    this._color = colors[color]
-    this._shouldDarkenSky = flags & 0x1
-    this._isDragonBar = flags & 0x2
-    this._createFog = flags & 0x4
-  }
-
-  set entityUUID (uuid) {
-    this._entityUUID = uuid
-  }
-
-  set title (title) {
-    this._title = new ChatMessage(JSON.parse(title))
-  }
-
-  set health (health) {
-    this._health = health
-  }
-
-  set dividers (dividers) {
-    this._dividers = divisions[dividers]
-  }
-
-  set color (color) {
-    this._color = colors[color]
-  }
-
-  set flags (flags) {
-    this._shouldDarkenSky = flags & 0x1
-    this._isDragonBar = flags & 0x2
-    this._createFog = flags & 0x4
-  }
-
-  get flags () {
-    return (this._shouldDarkenSky) | (this._isDragonBar << 1) | (this._createFog << 2)
-  }
-
-  set shouldDarkenSky (darkenSky) {
-    this._shouldDarkenSky = darkenSky
-  }
-
-  set isDragonBar (dragonBar) {
-    this._isDragonBar = dragonBar
-  }
-
-  get createFog () {
-    return this._createFog
-  }
-
-  set createFog (createFog) {
-    this._createFog = createFog
-  }
-
-  get entityUUID () {
-    return this._entityUUID
-  }
-
-  get title () {
-    return this._title
-  }
-
-  get health () {
-    return this._health
-  }
-
-  get dividers () {
-    return this._dividers
-  }
-
-  get color () {
-    return this._color
-  }
-
-  get shouldDarkenSky () {
-    return this._shouldDarkenSky
-  }
-
-  get isDragonBar () {
-    return this._isDragonBar
-  }
-
-  get shouldCreateFog () {
-    return this._createFog
+  const ChatMessage = require('prismarine-chat')(registry)
+  return class BossBar {
+    constructor (uuid, title, health, dividers, color, flags) {
+      this._entityUUID = uuid
+      this._title = ChatMessage.fromNotch(title)
+      this._health = health
+      this._dividers = divisions[dividers]
+      this._color = colors[color]
+      this._shouldDarkenSky = flags & 0x1
+      this._isDragonBar = flags & 0x2
+      this._createFog = flags & 0x4
+    }
+
+    set entityUUID (uuid) {
+      this._entityUUID = uuid
+    }
+
+    set title (title) {
+      this._title = ChatMessage.fromNotch(title)
+    }
+
+    set health (health) {
+      this._health = health
+    }
+
+    set dividers (dividers) {
+      this._dividers = divisions[dividers]
+    }
+
+    set color (color) {
+      this._color = colors[color]
+    }
+
+    set flags (flags) {
+      this._shouldDarkenSky = flags & 0x1
+      this._isDragonBar = flags & 0x2
+      this._createFog = flags & 0x4
+    }
+
+    get flags () {
+      return (this._shouldDarkenSky) | (this._isDragonBar << 1) | (this._createFog << 2)
+    }
+
+    set shouldDarkenSky (darkenSky) {
+      this._shouldDarkenSky = darkenSky
+    }
+
+    set isDragonBar (dragonBar) {
+      this._isDragonBar = dragonBar
+    }
+
+    get createFog () {
+      return this._createFog
+    }
+
+    set createFog (createFog) {
+      this._createFog = createFog
+    }
+
+    get entityUUID () {
+      return this._entityUUID
+    }
+
+    get title () {
+      return this._title
+    }
+
+    get health () {
+      return this._health
+    }
+
+    get dividers () {
+      return this._dividers
+    }
+
+    get color () {
+      return this._color
+    }
+
+    get shouldDarkenSky () {
+      return this._shouldDarkenSky
+    }
+
+    get isDragonBar () {
+      return this._isDragonBar
+    }
+
+    get shouldCreateFog () {
+      return this._createFog
+    }
   }
 }
+
+module.exports = loader

lib/plugins/anvil.js

@@ -1,6 +1,6 @@
 const assert = require('assert')
 const { sleep } = require('../promise_utils')
-const { once } = require('events')
+const { once } = require('../promise_utils')
 
 module.exports = inject
 
@@ -12,7 +12,7 @@ function inject (bot) {
   async function openAnvil (anvilBlock) {
     const anvil = await bot.openBlock(anvilBlock)
     if (!matchWindowType(anvil)) {
-      throw new Error('This is not a anvil-like window')
+      throw new Error('Not a anvil-like window: ' + JSON.stringify(anvil))
     }
 
     function err (name) {

lib/plugins/book.js

@@ -1,5 +1,5 @@
 const assert = require('assert')
-const { once } = require('events')
+const { once } = require('../promise_utils')
 
 module.exports = inject
 

lib/plugins/chat.js

@@ -144,7 +144,7 @@ function inject (bot, options) {
   function chatWithHeader (header, message) {
     if (typeof message === 'number') message = message.toString()
     if (typeof message !== 'string') {
-      throw new Error('Incorrect type! Should be a string or number.')
+      throw new Error('Chat message type must be a string or number: ' + typeof message)
     }
 
     if (!header && message.startsWith('/')) {

lib/plugins/chest.js

@@ -23,7 +23,7 @@ function inject (bot) {
       throw new Error('containerToOpen is neither a block nor an entity')
     }
 
-    if (!matchWindowType(chest)) { throw new Error('Non-container window used as a container') }
+    if (!matchWindowType(chest)) { throw new Error('Non-container window used as a container: ' + JSON.stringify(chest)) }
     return chest
   }
 

lib/plugins/craft.js

@@ -1,5 +1,5 @@
 const assert = require('assert')
-const { once } = require('events')
+const { once } = require('../promise_utils')
 
 module.exports = inject
 
@@ -12,7 +12,7 @@ function inject (bot) {
     assert.ok(recipe)
     count = parseInt(count ?? 1, 10)
     if (recipe.requiresTable && !craftingTable) {
-      throw new Error('recipe requires craftingTable')
+      throw new Error('Recipe requires craftingTable, but one was not supplied: ' + JSON.stringify(recipe))
     }
 
     try {
@@ -41,7 +41,7 @@ function inject (bot) {
         windowCraftingTable = window
       }
       if (!windowCraftingTable.type.startsWith('minecraft:crafting')) {
-        throw new Error('crafting: non craftingTable used as craftingTable')
+        throw new Error('crafting: non craftingTable used as craftingTable: ' + windowCraftingTable.type)
       }
       await startClicking(windowCraftingTable, 3, 3)
     } else {

lib/plugins/creative.js

@@ -1,7 +1,7 @@
 const assert = require('assert')
 const { Vec3 } = require('vec3')
 const { sleep, onceWithCleanup } = require('../promise_utils')
-const { once } = require('events')
+const { once } = require('../promise_utils')
 
 module.exports = inject
 
@@ -70,7 +70,7 @@ function inject (bot) {
 
     // last step
     bot.entity.position = destination
-    await once(bot, 'move')
+    await once(bot, 'move', /* no timeout */ 0)
   }
 
   function startFlying () {

lib/plugins/enchantment_table.js

@@ -1,5 +1,5 @@
 const assert = require('assert')
-const { once } = require('events')
+const { once } = require('../promise_utils')
 
 module.exports = inject
 
@@ -9,7 +9,7 @@ function inject (bot) {
     let ready = false
     const enchantmentTable = await bot.openBlock(enchantmentTableBlock)
     if (!enchantmentTable.type.startsWith('minecraft:enchant')) {
-      throw new Error('This is not an enchantment table')
+      throw new Error('Expected minecraft:enchant when opening table but got ' + enchantmentTable.type)
     }
 
     resetEnchantmentOptions()

lib/plugins/entities.js

@@ -597,7 +597,7 @@ function inject (bot) {
         }
 
         if (item.displayName) {
-          obj.displayName = new ChatMessage(JSON.parse(item.displayName))
+          obj.displayName = ChatMessage.fromNotch(item.displayName)
         } else if (packet.action & 32) obj.displayName = new ChatMessage({ text: '', extra: [{ text: player.username || obj.username }] })
 
         if (newPlayer) {
@@ -660,7 +660,7 @@ function inject (bot) {
           }
 
           if (item.displayName) {
-            player.displayName = new ChatMessage(JSON.parse(item.displayName))
+            player.displayName = ChatMessage.fromNotch(item.displayName)
           }
 
           const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === item.name)
@@ -681,7 +681,7 @@ function inject (bot) {
           } else if (packet.action === 3 && !item.displayName) {
             player.displayName = new ChatMessage({ text: '', extra: [{ text: player.username }] })
           } else if (packet.action === 3 && item.displayName) {
-            player.displayName = new ChatMessage(JSON.parse(item.displayName))
+            player.displayName = ChatMessage.fromNotch(item.displayName)
           } else if (packet.action === 4) {
             if (player.entity === bot.entity) continue
 

lib/plugins/inventory.js

@@ -1,7 +1,6 @@
 const assert = require('assert')
 const { Vec3 } = require('vec3')
-const { once } = require('events')
-const { sleep, createDoneTask, createTask, withTimeout } = require('../promise_utils')
+const { once, sleep, createDoneTask, createTask, withTimeout } = require('../promise_utils')
 
 module.exports = inject
 

lib/plugins/scoreboard.js

@@ -16,6 +16,14 @@ function inject (bot) {
     if (packet.action === 1) {
       bot.emit('scoreboardDeleted', scoreboards[packet.name])
       delete scoreboards[packet.name]
+
+      for (const position in ScoreBoard.positions) {
+        const scoreboard = ScoreBoard.positions[position]
+        if (scoreboard.name === packet.name) {
+          delete ScoreBoard.positions[position]
+          break
+        }
+      }
     }
 
     if (packet.action === 2) {

lib/plugins/tablist.js

@@ -13,14 +13,19 @@ function inject (bot) {
   }
 
   bot._client.on('playerlist_header', (packet) => {
-    if (packet.header) {
-      const header = escapeValueNewlines(packet.header)
-      bot.tablist.header = new ChatMessage(JSON.parse(header))
-    }
+    if (bot.supportFeature('chatPacketsUseNbtComponents')) { // 1.20.3+
+      bot.tablist.header = ChatMessage.fromNotch(packet.header)
+      bot.tablist.footer = ChatMessage.fromNotch(packet.footer)
+    } else {
+      if (packet.header) {
+        const header = escapeValueNewlines(packet.header)
+        bot.tablist.header = ChatMessage.fromNotch(header)
+      }
 
-    if (packet.footer) {
-      const footer = escapeValueNewlines(packet.footer)
-      bot.tablist.footer = new ChatMessage(JSON.parse(footer))
+      if (packet.footer) {
+        const footer = escapeValueNewlines(packet.footer)
+        bot.tablist.footer = ChatMessage.fromNotch(footer)
+      }
     }
   })
 }