mineflayer 4.5.1 → 4.7.0

package/.github/workflows/ci.yml

@@ -31,6 +31,8 @@ jobs:
            mcVersion: '1.18.2'
          - javaVersion: 17
            mcVersion: '1.19'
+         - javaVersion: 17
+           mcVersion: '1.19.2'
       fail-fast: false
 
     steps:

package/README.md

@@ -189,8 +189,9 @@ 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
+ * [GUI](https://github.com/firejoust/mineflayer-GUI) - Interact with nested GUI windows using async/await
+ * [Projectile](https://github.com/firejoust/mineflayer-projectile) - Get the required launch angle for projectiles
+* [Movement](https://github.com/firejoust/mineflayer-movement) - Smooth and realistic player movement, best suited for PvP
 
 
  But also check out :

package/docs/README.md

@@ -189,8 +189,9 @@ 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
+ * [GUI](https://github.com/firejoust/mineflayer-GUI) - Interact with nested GUI windows using async/await
+ * [Projectile](https://github.com/firejoust/mineflayer-projectile) - Get the required launch angle for projectiles
+* [Movement](https://github.com/firejoust/mineflayer-movement) - Smooth and realistic player movement, best suited for PvP
 
 
  But also check out :

package/docs/api.md

@@ -75,6 +75,14 @@
       - [BossBar.isDragonBar](#bossbarisdragonbar)
       - [BossBar.createFog](#bossbarcreatefog)
       - [BossBar.color](#bossbarcolor)
+    - [mineflayer.Particle](#mineflayerparticle)
+      - [Particle.id](#particleid)
+      - [Particle.name](#particlename)
+      - [Particle.position](#particleposition)
+      - [Particle.offset](#particleoffset)
+      - [Particle.longDistanceRender](#particlelongdistancerender)
+      - [Particle.count](#particlecount)
+      - [Particle.movementSpeed](#particlemovementspeed)
   - [Bot](#bot)
     - [mineflayer.createBot(options)](#mineflayercreatebotoptions)
     - [Properties](#properties)
@@ -239,6 +247,7 @@
       - ["heldItemChanged" (heldItem)](#helditemchanged-helditem)
       - ["physicsTick" ()](#physicstick-)
       - ["chat:name" (matches)](#chatname-matches)
+      - ["particle"](#particle)
     - [Functions](#functions)
       - [bot.blockAt(point, extraInfos=true)](#botblockatpoint-extrainfostrue)
       - [bot.waitForChunksToLoad()](#botwaitforchunkstoload)
@@ -725,6 +734,36 @@ Determines whether or not boss bar creates fog
 
 Determines what color the boss bar color is, one of `pink`, `blue`, `red`, `green`, `yellow`, `purple`, `white`
 
+### mineflayer.Particle
+
+#### Particle.id
+
+Particle ID, as defined in the [protocol](https://wiki.vg/Protocol#Particle)
+
+#### Particle.name
+
+Particle Name, as defined in the [protocol](https://wiki.vg/Protocol#Particle)
+
+#### Particle.position
+
+Vec3 instance of where the particle was created
+
+#### Particle.offset
+
+Vec3 instance of the particle's offset
+
+#### Particle.longDistanceRender
+
+Determines whether or not to force the rendering of a particle despite client particle settings and increases maximum view distance from 256 to 65536
+
+#### Particle.count
+
+Amount of particles created
+
+#### Particle.movementSpeed
+
+Particle speed in a random direction
+
 ## Bot
 
 ### mineflayer.createBot(options)
@@ -1117,7 +1156,8 @@ Emitted for every server message which appears on the Action Bar.
 
 Emitted for every server message, including chats.
 
- * `jsonMsg` - unmodified JSON message from the server
+ * `jsonMsg` - [ChatMessage](https://github.com/PrismarineJS/prismarine-chat) object containing the formatted chat message. Might additionally have the following properties:
+   * unsigned - Unsigned ChatMessage object. Only present in 1.19.2+, and only when the server allows insecure chat and the server modified the chat message without the user's signature
 
  * `position` - (>= 1.8.1): position of Chat message can be
    * chat
@@ -1130,7 +1170,7 @@ Emitted for every server message, including chats.
 
 #### "messagestr" (message, messagePosition, jsonMsg, sender, verified)
 
-Alias for the "message" event but it calls .toString() on the message object to get a string for the message before emitting.
+Alias for the "message" event but it calls .toString() on the prismarine-message object to get a string for the message before emitting.
 
  * `sender` - UUID of sender if known (1.16+), else null
 
@@ -1465,6 +1505,10 @@ Fires every tick if bot.physicsEnabled is set to true.
 
 Fires when the all of a chat pattern's regexs have matches
 
+#### "particle"
+
+Fires when a particle is created
+
 ### Functions
 
 #### bot.blockAt(point, extraInfos=true)

package/docs/es/README_ES.md

@@ -17,7 +17,7 @@ Crea bots para Minecraft con una API de JavaScript potente, estable y de alto ni
 
 ## Características
 
- * Soporta Minecraft 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17 y 1.18.
+ * Soporta Minecraft 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18 y 1.19.
  * Rastreo e información de entidades.
  * Información sobre bloques. Puedes solicitar información de todo lo que te rodea. Encuentra bloques en milisegundos
  * Físicas y movimientos básicos - maneja todos los cuadros de colisión

package/docs/fr/FAQ_FR.md

@@ -0,0 +1,182 @@
+## FAQ
+
+Ce document de foire aux questions a pour but d'aider les gens pour les choses les plus courantes.
+
+### Je reçois une erreur lorsque j'essaie de me connecter avec un compte Microsoft.
+
+Assurez-vous que l'email que vous avez entré dans l'option username de createBot peut être utilisé pour vous connecter à `minecraft.net` en utilisant le bouton 'Login with Microsoft'.
+Assurez-vous que vous avez l'option `auth : 'microsoft'` dans vos options createBot.
+
+Lorsque vous obtenez une erreur qui dit quelque chose au sujet des informations d'identification invalides ou "Ce compte possède Minecraft ?", essayez de supprimer le champ du mot de passe dans les options `createBot` et réessayez.
+
+### Comment masquer les erreurs ?
+
+Utiliser `hideErrors : true` dans les options de createBot
+Vous pouvez également choisir d'ajouter ces listeners :
+
+```js
+client.on('error', () => {})
+client.on('end', () => {})
+```
+
+### Je ne reçois pas d'événement de chat sur un serveur personnalisé, comment puis-je résoudre ce problème ?
+
+Les serveurs Spigot, en particulier certains plugins, utilisent des formats de chat personnalisés, vous devez les analyser avec une expression rationnelle / un analyseur syntaxique personnalisé.
+Lisez et adaptez [chat_parsing.js](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js) pour qu'il fonctionne pour vos besoins particuliers.
+plugin de chat. A lire également <http://mineflayer.prismarine.js.org/#/tutorial?id=custom-chat>
+
+### Comment puis-je collecter les informations d'un plugin personnalisé dans le chat ?
+
+La plupart des serveurs Minecraft personnalisés ont le support des plugins, et beaucoup de ces plugins disent quelque chose dans le chat quand quelque chose se passe. Si c'est juste un message, il est préférable d'utiliser la solution discutée dans la solution ci-dessus, mais quand ces messages sont divisés en plusieurs petits messages, une autre option est d'utiliser l'événement `"messagestr"` car il permet d'analyser facilement les messages de plusieurs lignes.
+
+**Exemple:**
+
+Le message du chat dans le chat ressemble à ceci :
+
+```
+(!) U9G has won the /jackpot and received
+$26,418,402,450! They purchased 2,350,000 (76.32%) ticket(s) out of the
+3,079,185 ticket(s) sold!
+```
+
+```js
+const regex = {
+  first: /\(!\) (.+) has won the \/jackpot and received +/,
+  second: /\$(.+)! They purchased (.+) \((.+)%\) ticket\(s\) out of the /,
+  third: /(.+) ticket\(s\) sold!/
+}
+
+let jackpot = {}
+bot.on('messagestr', msg => {
+  if (regex.first.test(msg)) {
+    const username = msg.match(regex.first)[1]
+    jackpot.username = username
+  } else if (regex.second.test(msg)) {
+    const [, moneyWon, boughtTickets, winPercent] = msg.match(regex.second)
+    jackpot.moneyWon = parseInt(moneyWon.replace(/,/g, ''))
+    jackpot.boughtTickets = parseInt(boughtTickets.replace(/,/g, ''))
+    jackpot.winPercent = parseFloat(winPercent)
+  } else if (regex.third.test(msg)) {
+    const totalTickets = msg.match(regex.third)[1]
+    jackpot.totalTickets = parseInt(totalTickets.replace(/,/g, ''))
+    onDone(jackpot)
+    jackpot = {}
+  }
+})
+```
+
+### Comment puis-je envoyer une commande ?
+
+En utilisant `bot.chat()`.
+
+**Example:**
+
+```js
+bot.chat('/give @p diamond')
+```
+
+### Est-il possible de se connecter à plusieurs comptes en utilisant bot = mineflayer.createbot tout en les contrôlant tous séparément ?
+
+Créer différentes instances de bot en appelant createBot puis faire différentes choses pour chacune, voir multiple.js
+
+### Comment faire pour que le robot lâche tout son inventaire ?
+
+bot.inventory.items() renvoie un tableau des objets du bot. Vous pouvez utiliser une fonction récursive pour les parcourir en boucle et déposer chaque objet en utilisant bot.toss(). Cliquez [ici](https://gist.github.com/dada513/3d88f772be4224b40f9e5d1787bd63e9) pour voir un exemple.
+
+### Comment vérifier les paquets qui sont envoyés/reçus ?
+
+Activation du mode de débogage <https://github.com/PrismarineJS/mineflayer#debug>
+
+### Je veux éviter la déconnexion même en cas de lag du serveur, comment puis-je y parvenir ?
+
+Un moyen est d'augmenter l'option [checkTimeoutInterval](https://github.com/PrismarineJS/node-minecraft-protocol/blob/master/docs/API.md#mccreateclientoptions) (à définir dans createBot) à une valeur plus élevée (par exemple `300*1000` qui est 5min au lieu des 30s par défaut). Si vous êtes toujours déconnecté, vous pouvez vous reconnecter automatiquement en utilisant quelque chose comme cet exemple <https://github.com/PrismarineJS/mineflayer/blob/master/examples/reconnector.js>
+
+### Comment obtenir l'histoire / le texte d'un objet ?
+
+Vous pouvez utiliser la propriété `item.nbt`. Il est également recommandé d'utiliser la bibliothèque `prismarine-nbt`. La méthode `nbt.simplify()` peut être utile.
+
+**Exemple:**
+
+```js
+function getLore (item) {
+  let message = ''
+  if (item.nbt == null) return message
+
+  const nbt = require('prismarine-nbt')
+  const ChatMessage = require('prismarine-chat')(bot.version)
+
+  const data = nbt.simplify(item.nbt)
+  const display = data.display
+  if (display == null) return message
+
+  const lore = display.Lore
+  if (lore == null) return message
+  for (const line of lore) {
+    message += new ChatMessage(line).toString()
+    message += '\n'
+  }
+
+  return message
+}
+```
+
+### Comment puis-je envoyer un message de la console au serveur ?
+
+You can use a library like `repl` to read the console input and use `bot.chat()` to send it. You can find an example [here.](https://github.com/PrismarineJS/mineflayer/blob/master/examples/repl.js)
+
+### Lors de la création d'un plugin, comment puis-je spécifier un autre plugin comme dépendance ?
+
+Dans la fonction `inject()` de votre plugin, vous pouvez appeler sans risque `bot.loadPlugin(anotherPlugin)` pour vous assurer que ce plugin est chargé. Si le plugin a déjà été chargé auparavant, rien ne se passe.
+
+Notez que l'ordre dans lequel les plugins sont chargés est dynamique, donc vous ne devriez jamais appeler un autre plugin dans votre fonction `inject()`.
+
+### Comment puis-je utiliser un proxy socks5 ?
+
+In the options object for `mineflayer.createBot(options)`, remove your `host` option from the options object, have the following variables declared `PROXY_IP, PROXY_PORT, PROXY_USERNAME, PROXY_PASSWORD, MC_SERVER_ADDRESS, MC_SERVER_PORT` and add this to your options object:
+
+```js
+connect: (client) => {
+    socks.createConnection({
+      proxy: {
+        host: PROXY_IP,
+        port: PROXY_PORT,
+        type: 5,
+        userId: PROXY_USERNAME,
+        password: PROXY_PASSWORD
+      },
+      command: 'connect',
+      destination: {
+        host: MC_SERVER_ADDRESS,
+        port: MC_SERVER_PORT
+      }
+    }, (err, info) => {
+      if (err) {
+        console.log(err)
+        return
+      }
+      client.setSocket(info.socket)
+      client.emit('connect')
+    })
+  }
+  ```
+
+`socks` est déclaré avec `const socks = require('socks').SocksClient` et utilise le paquet [this](https://www.npmjs.com/package/socks).
+Certains serveurs peuvent rejeter la connexion. Si cela se produit, essayez d'ajouter `fakeHost : MC_SERVER_ADDRESS` aux options de votre createBot.
+  
+# Erreurs courantes
+
+### `UnhandledPromiseRejectionWarning: Error: Failed to read asymmetric key`
+
+Voici ce qui se passe lorsque vous avez donné à Mineflayer la mauvaise version du serveur, ou que Mineflayer détecte la mauvaise version du serveur.
+
+### `TypeError: Cannot read property '?' of undefined`
+
+Vous essayez peut-être d'utiliser quelque chose sur l'objet bot qui n'existe pas encore, essayez d'appeler l'instruction après l'événement `spawn`.
+
+### `SyntaxError: Unexpected token '?'`
+
+Mettez à jour la version de votre node.
+
+### The bot can't break/place blocks or open chests
+
+Vérifiez que la protection contre le spawn n'empêche pas le bot d'agir.

package/docs/history.md

@@ -1,3 +1,18 @@
+## 4.7.0
+
+* 1.19.2 support (@frej4189)
+
+## 4.6.0
+
+* Fix unhandled promise rejection in onceWithCleanup (@IceTank) [#2833](https://github.com/PrismarineJS/mineflayer/pull/2833)
+* Extend every window that is opened with mineflayer specific window functions (@IceTank) [#2768][https://github.com/PrismarineJS/mineflayer/pull/2768]
+* Fix example command line usage messages (@maximmasiutin) [#2853](https://github.com/PrismarineJS/mineflayer/pull/2853)
+* Update README_ES.md (@PanIntegralus) [#2803](https://github.com/PrismarineJS/mineflayer/pull/2803)
+* Fix block face position target when digging (@WhoTho) [#2801](https://github.com/PrismarineJS/mineflayer/pull/2801)
+* Add a native mineflayer event for particles (@NyxaYu) [#2813](https://github.com/PrismarineJS/mineflayer/pull/2813)
+* Fix viewDistance type (@Nciklol) [#2824](Fix viewDistance type (#2824) ) 
+* Add French FAQ (@AugustinMauroy) [#2817](https://github.com/PrismarineJS/mineflayer/pull/2817)
+
 ## 4.5.1
 
 * Fixed syntax error in TypeScript definitions (@JungleDome) [commit](https://github.com/PrismarineJS/mineflayer/commit/2c6a4036d84bedb5f349ea5a82d743e344c34224)

package/examples/anvil.js

@@ -18,7 +18,7 @@
 const mineflayer = require('mineflayer')
 
 if (process.argv.length < 4 || process.argv.length > 6) {
-  console.log('Usage : node use_anvil.js <host> <port> [<name>] [<password>]')
+  console.log('Usage : node anvil.js <host> <port> [<name>] [<password>]')
   process.exit(1)
 }
 

package/examples/collectblock.js

@@ -6,12 +6,7 @@ const pathfinder = require('mineflayer-pathfinder').pathfinder
 const collectBlock = require('mineflayer-collectblock').plugin
 
 if (process.argv.length < 4 || process.argv.length > 6) {
-  console.log('Usage : node collector.js <host> <port> [<name>] [<password>]')
-  process.exit(1)
-}
-
-if (process.argv.length < 4 || process.argv.length > 6) {
-  console.log('Usage : node collectBlock.js <host> <port> [<name>] [<password>]')
+  console.log('Usage : node collectblock.js <host> <port> [<name>] [<password>]')
   process.exit(1)
 }
 

package/examples/discord.js

@@ -1,57 +1,64 @@
 /*
  * 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
- * This example uses discord.js v13
+ * This example uses discord.js v14
  * You need to do this before running this example:
- * - You need to get a discord token
+ * - You need to get a discord bot token
  * - You need to get the id of the channel you want to use
- */
+ *
+ * Original credit to U9G, updated by Jovan04 12/19/2022
+*/
 
 if (process.argv.length < 6 || process.argv.length > 8) {
-  console.log('Usage : node discord.js <discord bot token> <channel id> <host> <port> [<name>] [<password>]')
+  console.log('Usage : node discord.js <discord bot token> <channel id> <host> <port> [<name>] [<auth>]')
   process.exit(1)
 }
 
-// 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
-})
+// load discord.js
+const { Client, GatewayIntentBits } = require('discord.js')
+const { MessageContent, GuildMessages, Guilds } = GatewayIntentBits
 
 let channel = process.argv[3]
+const token = process.argv[2]
+
+// create new discord client that can see what servers the bot is in, as well as the messages in those servers
+const client = new Client({ intents: [Guilds, GuildMessages, MessageContent] })
+client.login(token)
 
-// Load mineflayer
+// load mineflayer
 const mineflayer = require('mineflayer')
-const bot = mineflayer.createBot({
+
+// bot options
+const options = {
   host: process.argv[4],
   port: parseInt(process.argv[5]),
   username: process.argv[6] || 'discord',
-  password: process.argv[7]
+  auth: process.argv[7] || 'offline'
+}
+
+// join server
+const bot = mineflayer.createBot(options)
+bot.on('spawn', () => {
+  console.log(`Mineflayer bot logged in as ${bot.username}`)
 })
 
-client.on('ready', () => {
-  console.log(`The discord bot logged in! Username: ${client.user.username}!`)
-  // Find the Discord channel messages will be sent to
+// when discord client is ready, send login message
+client.once('ready', (c) => {
+  console.log(`Discord bot logged in as ${c.user.tag}`)
   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>]`)
+    console.log(`I could not find the channel (${process.argv[3]})!`)
+    console.log('Usage : node discord.js <discord bot token> <channel id> <host> <port> [<name>] [<auth>]')
     process.exit(1)
   }
 })
 
-// Redirect Discord messages to in-game chat
-client.on('messageCreate', message => {
+client.on('messageCreate', (message) => {
   // Only handle messages in specified channel
   if (message.channel.id !== channel.id) return
   // Ignore messages from the bot itself
   if (message.author.id === client.user.id) return
-
+  // console.log(message)
   bot.chat(`${message.author.username}: ${message.content}`)
 })
 
@@ -62,6 +69,3 @@ bot.on('chat', (username, message) => {
 
   channel.send(`${username}: ${message}`)
 })
-
-// Login Discord bot
-client.login(process.argv[2])

package/examples/looker.js

@@ -5,7 +5,7 @@
 const mineflayer = require('mineflayer')
 
 if (process.argv.length < 4 || process.argv.length > 6) {
-  console.log('Usage : node echo.js <host> <port> [<name>] [<password>]')
+  console.log('Usage : node looker.js <host> <port> [<name>] [<password>]')
   process.exit(1)
 }
 

package/examples/skin_blinker.js

@@ -7,7 +7,7 @@
 const mineflayer = require('mineflayer')
 
 if (process.argv.length < 4 || process.argv.length > 6) {
-  console.log('Usage : node jumper.js <host> <port> [<name>] [<password>]')
+  console.log('Usage : node skin_blinker.js <host> <port> [<name>] [<password>]')
   process.exit(1)
 }
 

package/examples/telegram.js

@@ -0,0 +1,43 @@
+/*
+* This example is a very simple way of connecting to a telegram group
+* For this example you'll need Telegraf installed. This can be done with `npm install telegraf`
+* You need to do this before running this example:
+* - You need to get a telegram bot token from @botfather
+* - You need to get the id of the group you want to use
+*/
+
+if (process.argv.length < 6 || process.argv.length > 8) {
+  console.log('Usage : node telegram.js <telegram bot token> <group id> <host> <port> [<name>] [<password>]')
+  process.exit(1)
+}
+
+// Load Telegraf
+const { Telegraf } = require('telegraf')
+const telegram = new Telegraf(process.argv[2])
+
+// Load mineflayer
+const mineflayer = require('mineflayer')
+const bot = mineflayer.createBot({
+  host: process.argv[4],
+  port: parseInt(process.argv[5]),
+  username: process.argv[6] || 'telegram',
+  password: process.argv[7]
+})
+
+telegram.on('text', async (ctx) => {
+  // check if message was reveived from chosen group
+  if (ctx.update.message.chat.id.toString() === process.argv[3]) {
+    // send message to mc server
+    bot.chat(`${ctx.update.message.from.first_name} ${ctx.update.message.from.last_name}: ${ctx.update.message.text}`)
+  }
+})
+
+// Redirect in-game messages to telegram group
+bot.on('chat', (username, message) => {
+  // Ignore messages from the bot itself
+  if (username === bot.username) return
+  telegram.telegram.sendMessage(process.argv[3], username + ': ' + message)
+})
+
+// Login telegram bot
+telegram.launch()

package/index.d.ts

@@ -8,6 +8,7 @@ import { Recipe } from 'prismarine-recipe'
 import { Block } from 'prismarine-block'
 import { Entity } from 'prismarine-entity'
 import { ChatMessage } from 'prismarine-chat'
+import { Registry } from 'prismarine-registry'
 
 export function createBot (options: { client: Client } & Partial<BotOptions>): Bot
 export function createBot (options: BotOptions): Bot
@@ -30,7 +31,7 @@ export interface BotOptions extends ClientOptions {
 }
 
 export type ChatLevel = 'enabled' | 'commandsOnly' | 'disabled'
-export type ViewDistance = 'far' | 'normal' | 'short' | 'tiny'
+export type ViewDistance = 'far' | 'normal' | 'short' | 'tiny' | number
 export type MainHands = 'left' | 'right'
 
 export interface PluginOptions {
@@ -151,6 +152,7 @@ interface BotEvents {
   bossBarDeleted: (bossBar: BossBar) => Promise<void> | void
   bossBarUpdated: (bossBar: BossBar) => Promise<void> | void
   resourcePack: (url: string, hash: string) => Promise<void> | void
+  particle: (particle: Particle) => Promise<void> | void
 }
 
 export interface Bot extends TypedEmitter<BotEvents> {
@@ -191,6 +193,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
   currentWindow: Window | null
   simpleClick: simpleClick
   tablist: Tablist
+  registry: Registry
 
   connect: (options: BotOptions) => void
 
@@ -826,6 +829,26 @@ export class BossBar {
   );
 }
 
+export class Particle {
+    id: number
+    name: string
+    position: Vec3
+    offset: Vec3
+    count: number
+    movementSpeed: number
+    longDistanceRender: boolean
+    static fromNetwork(packet: Object): Particle
+
+    constructor (
+        id: number,
+        position: Vec3,
+        offset: Vec3,
+        count?: number,
+        movementSpeed?: number,
+        longDistanceRender?: boolean
+    );
+}
+
 export let supportedVersions: string[]
 export let testedVersions: string[]
 

package/lib/loader.js

@@ -41,7 +41,8 @@ const plugins = {
   villager: require('./plugins/villager'),
   anvil: require('./plugins/anvil'),
   place_entity: require('./plugins/place_entity'),
-  generic_place: require('./plugins/generic_place')
+  generic_place: require('./plugins/generic_place'),
+  particle: require('./plugins/particle')
 }
 
 const supportedVersions = require('./version').supportedVersions
@@ -53,6 +54,7 @@ module.exports = {
   Painting: require('./painting'),
   ScoreBoard: require('./scoreboard'),
   BossBar: require('./bossbar'),
+  Particle: require('./particle'),
   supportedVersions,
   testedVersions,
   supportFeature: (feature, version) => require('prismarine-registry')(version).supportFeature(feature)

package/lib/particle.js

@@ -0,0 +1,30 @@
+const { Vec3 } = require('vec3')
+
+module.exports = loader
+
+function loader (registry) {
+  class Particle {
+    constructor (id, position, offset, count = 1, movementSpeed = 0, longDistanceRender = false) {
+      Object.assign(this, registry.particles[id])
+      this.id = id
+      this.position = position
+      this.offset = offset
+      this.count = count
+      this.movementSpeed = movementSpeed
+      this.longDistanceRender = longDistanceRender
+    }
+
+    static fromNetwork (packet) {
+      return new Particle(
+        packet.particleId,
+        new Vec3(packet.x, packet.y, packet.z),
+        new Vec3(packet.offsetX, packet.offsetY, packet.offsetZ),
+        packet.particles,
+        packet.particleData,
+        packet.longDistance
+      )
+    }
+  }
+
+  return Particle
+}

package/lib/plugins/blocks.js

@@ -20,7 +20,7 @@ const dimensionNames = {
   1: 'minecraft:end'
 }
 
-function inject (bot, { version, storageBuilder }) {
+function inject (bot, { version, storageBuilder, hideErrors }) {
   const Block = require('prismarine-block')(bot.registry)
   const Chunk = require('prismarine-chunk')(bot.registry)
   const World = require('prismarine-world')(bot.registry)
@@ -289,6 +289,10 @@ function inject (bot, { version, storageBuilder }) {
 
     if (typeof packet.blockEntities !== 'undefined') {
       const column = bot.world.getColumn(packet.x, packet.z)
+      if (!column) {
+        if (!hideErrors) console.warn('Ignoring block entities as chunk failed to load at', packet.x, packet.z)
+        return
+      }
       for (const blockEntity of packet.blockEntities) {
         if (blockEntity.x !== undefined) { // 1.17+
           column.setBlockEntity(blockEntity, blockEntity.nbtData)

package/lib/plugins/chat.js

@@ -108,43 +108,49 @@ function inject (bot, options) {
 
   addDefaultPatterns()
 
-  // Pre 1.19
-  bot._client.on('chat', (packet) => {
-    const msg = ChatMessage.fromNotch(packet.message)
-    const chatPositions = {
-      0: 'chat',
-      1: 'system',
-      2: 'game_info'
-    }
-    bot.emit('message', msg, chatPositions[packet.position], packet.sender, /* verified */ null)
-    bot.emit('messagestr', msg.toString(), chatPositions[packet.position], msg, packet.sender, /* verified */ null)
-    // Position 2 is the action bar
-    if (packet.position === 2) bot.emit('actionBar', msg, null)
-  })
+  bot._client.on('playerChat', (data) => {
+    const message = data.formattedMessage
+    const verified = data.verified
+    let msg
+    if (bot.supportFeature('clientsideChatFormatting')) {
+      let sender
+
+      try {
+        sender = JSON.parse(data.senderName)
+      } catch {
+        sender = {
+          insertion: data.senderName,
+          clickEvent: { action: 'suggest_command', value: `/tell ${data.senderName} ` },
+          hoverEvent: { action: 'show_entity', contents: { id: bot.findPlayer(data.senderName).id, name: data.senderName } },
+          text: data.senderName
+        }
+      }
 
-  // 1.19+
-  bot._client.on('player_chat', (packet) => {
-    const message = packet.unsignedChatContent || packet.signedChatContent
-    let verified = false
-    const sender = bot.uuidToUsername[packet.senderUuid]
-    if (sender) {
-      const { profileKeys } = bot.players[sender]
-      if (profileKeys) verified = bot._client.verifyMessage(profileKeys.publicKey, packet)
-    }
-    const parameters = {
-      sender: JSON.parse(packet.senderName),
-      content: JSON.parse(message)
+      const parameters = {
+        sender,
+        content: message ? JSON.parse(message) : { text: data.plainMessage }
+      }
+      msg = ChatMessage.fromNetwork(data.type, parameters)
+
+      if (data.unsignedContent) {
+        msg.unsigned = ChatMessage.fromNetwork(data.type, { sender, content: JSON.parse(data.unsignedContent) })
+      }
+    } else {
+      msg = ChatMessage.fromNotch(data.formattedMessage)
     }
-    const msg = ChatMessage.fromNetwork(packet.type, parameters)
-    Object.assign(msg, parameters)
-    bot.emit('message', msg, 'chat', packet.senderUuid, verified)
-    bot.emit('messagestr', msg.toString(), 'chat', msg, packet.senderUuid, verified)
+    bot.emit('message', msg, 'chat', data.sender, verified)
+    bot.emit('messagestr', msg.toString(), 'chat', msg, data.sender, verified)
   })
 
-  bot._client.on('system_chat', (packet) => {
-    const msg = ChatMessage.fromNotch(packet.content)
-    bot.emit('message', msg, 'system', null)
-    bot.emit('messagestr', msg.toString(), 'system', msg, null)
+  bot._client.on('systemChat', (data) => {
+    const msg = ChatMessage.fromNotch(data.formattedMessage)
+    const chatPositions = {
+      1: 'system',
+      2: 'game_info'
+    }
+    bot.emit('message', msg, chatPositions[data.positionid], null)
+    bot.emit('messagestr', msg.toString(), chatPositions[data.positionid], msg, null)
+    if (data.positionid === 2) bot.emit('actionBar', msg, null)
   })
 
   function chatWithHeader (header, message) {
@@ -163,7 +169,9 @@ function inject (bot, options) {
           timestamp,
           salt: 0n,
           argumentSignatures: [],
-          signedPreview: false
+          signedPreview: false,
+          // 1.19.2 Chat Command packet also includes an array of last seen messages
+          previousMessages: []
         })
         return
       }
@@ -176,17 +184,7 @@ function inject (bot, options) {
       let smallMsg
       for (i = 0; i < subMessage.length; i += lengthLimit) {
         smallMsg = header + subMessage.substring(i, i + lengthLimit)
-        if (bot.supportFeature('signedChat')) {
-          const timestamp = BigInt(Date.now())
-          bot._client.write('chat_message', {
-            message: smallMsg,
-            timestamp,
-            salt: 0,
-            signature: bot._client.profileKeys ? bot._client.signMessage(smallMsg, timestamp) : Buffer.alloc(0)
-          })
-        } else {
-          bot._client.write('chat', { message: smallMsg })
-        }
+        bot._client.chat(smallMsg)
       }
     })
   }

package/lib/plugins/digging.js

@@ -36,15 +36,17 @@ function inject (bot) {
         } else if (digFace.z) {
           diggingFace = digFace.z > 0 ? BlockFaces.SOUTH : BlockFaces.NORTH
         }
-        await bot.lookAt(block.position.offset(0.5, 0.5, 0.5).offset(digFace.x * 0.5, digFace.y * 0.5, digFace.z * 0.5), forceLook)
+        await bot.lookAt(
+          block.position.offset(0.5, 0.5, 0.5).offset(digFace.x * 0.5, digFace.y * 0.5, digFace.z * 0.5),
+          forceLook
+        )
       } else if (digFace === 'raycast') {
         // Check faces that could be seen from the current position. If the delta is smaller then 0.5 that means the
         // bot cam most likely not see the face as the block is 1 block thick
         // this could be false for blocks that have a smaller bounding box then 1x1x1
-        const dx = bot.entity.position.x - block.position.x + 0.5
-        const dy = bot.entity.position.y - block.position.y - 0.5 + bot.entity.height // -0.5 because the bot position
-        // is calculated from the block position that is inside its feet so 0.5 - 1 = -0.5
-        const dz = bot.entity.position.z - block.position.z + 0.5
+        const dx = bot.entity.position.x - (block.position.x + 0.5)
+        const dy = bot.entity.position.y + bot.entity.height - (block.position.y + 0.5)
+        const dz = bot.entity.position.z - (block.position.z + 0.5)
         // Check y first then x and z
         const visibleFaces = {
           y: Math.sign(Math.abs(dy) > 0.5 ? dy : 0),
@@ -55,12 +57,20 @@ function inject (bot) {
         for (const i in visibleFaces) {
           if (!visibleFaces[i]) continue // skip as this face is not visible
           // target position on the target block face. -> 0.5 + (current face) * 0.5
-          const targetPos = block.position.offset(0.5 + (i === 'x' ? visibleFaces[i] * 0.5 : 0), 0.5 + (i === 'y' ? visibleFaces[i] * 0.5 : 0), 0.5 + (i === 'z' ? visibleFaces[i] * 0.5 : 0))
+          const targetPos = block.position.offset(
+            0.5 + (i === 'x' ? visibleFaces[i] * 0.5 : 0),
+            0.5 + (i === 'y' ? visibleFaces[i] * 0.5 : 0),
+            0.5 + (i === 'z' ? visibleFaces[i] * 0.5 : 0)
+          )
           const startPos = bot.entity.position.offset(0, bot.entity.height, 0)
           const rayBlock = bot.world.raycast(startPos, targetPos.clone().subtract(startPos).normalize(), 5)
           if (rayBlock) {
             const rayPos = rayBlock.position
-            if (rayPos.x === block.position.x && rayPos.y === block.position.y && rayPos.z === block.position.z) {
+            if (
+              rayPos.x === block.position.x &&
+                            rayPos.y === block.position.y &&
+                            rayPos.z === block.position.z
+            ) {
               // console.info(rayBlock)
               validFaces.push({
                 face: rayBlock.face,
@@ -75,7 +85,9 @@ function inject (bot) {
           let distSqrt = 999
           for (const i in validFaces) {
             const tPos = validFaces[i].targetPos
-            const cDist = new Vec3(tPos.x, tPos.y, tPos.z).distanceSquared(bot.entity.position.offset(0, bot.entity.height, 0))
+            const cDist = new Vec3(tPos.x, tPos.y, tPos.z).distanceSquared(
+              bot.entity.position.offset(0, bot.entity.height, 0)
+            )
             if (distSqrt > cDist) {
               closest = validFaces[i]
               distSqrt = cDist
@@ -172,7 +184,11 @@ function inject (bot) {
   })
 
   function canDigBlock (block) {
-    return block && block.diggable && block.position.offset(0.5, 0.5, 0.5).distanceTo(bot.entity.position.offset(0, 1.65, 0)) <= 5.1
+    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 digTime (block) {
@@ -195,7 +211,14 @@ function inject (bot) {
     }
 
     const creative = bot.game.gameMode === 'creative'
-    return block.digTime(type, creative, bot.entity.isInWater, !bot.entity.onGround, enchantments, bot.entity.effects)
+    return block.digTime(
+      type,
+      creative,
+      bot.entity.isInWater,
+      !bot.entity.onGround,
+      enchantments,
+      bot.entity.effects
+    )
   }
 
   bot.dig = dig

package/lib/plugins/inventory.js

@@ -588,6 +588,7 @@ function inject (bot, { hideErrors }) {
     if (!windowItems || window.id !== windowItems.windowId) {
       // don't emit windowOpen until we have the slot data
       bot.once(`setWindowItems:${window.id}`, () => {
+        extendWindow(window)
         bot.emit('windowOpen', window)
       })
     } else {
@@ -596,6 +597,7 @@ function inject (bot, { hideErrors }) {
         window.updateSlot(i, item)
       }
       updateHeldItem()
+      extendWindow(window)
       bot.emit('windowOpen', window)
     }
   }

package/lib/plugins/particle.js

@@ -0,0 +1,9 @@
+module.exports = inject
+
+function inject (bot, { version }) {
+  const Particle = require('../particle')(bot.registry)
+
+  bot._client.on('world_particles', (packet) => {
+    bot.emit('particle', Particle.fromNetwork(packet))
+  })
+}

package/lib/promise_utils.js

@@ -67,7 +67,7 @@ function onceWithCleanup (emitter, event, { timeout = 0, checkCondition = undefi
     })
   }
 
-  task.promise.finally(() => emitter.removeListener(event, onEvent))
+  task.promise.catch(() => {}).finally(() => emitter.removeListener(event, onEvent))
 
   return task.promise
 }

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', '1.18', '1.19'],
-  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']
+  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']
 } // when updating testedVersions, make sure to update CI.yml

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mineflayer",
-  "version": "4.5.1",
+  "version": "4.7.0",
   "description": "create minecraft bots with a stable, high level API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -22,7 +22,7 @@
   "license": "MIT",
   "dependencies": {
     "minecraft-data": "^3.15.2",
-    "minecraft-protocol": "^1.36.0",
+    "minecraft-protocol": "^1.38.1",
     "prismarine-biome": "^1.1.1",
     "prismarine-block": "^1.13.1",
     "prismarine-chat": "^1.7.1",