mineflayer 4.8.0 → 4.9.0

package/.github/workflows/ci.yml

@@ -35,6 +35,8 @@ jobs:
            mcVersion: '1.19.2'
          - javaVersion: 17
            mcVersion: '1.19.3'
+         - javaVersion: 17
+           mcVersion: '1.19.4'
       fail-fast: false
 
     steps:

package/README.md

@@ -1,7 +1,7 @@
 # Mineflayer
 
 [![NPM version](https://img.shields.io/npm/v/mineflayer.svg?color=success&label=npm%20package&logo=npm)](https://www.npmjs.com/package/mineflayer)
-[![Build Status](https://img.shields.io/github/workflow/status/PrismarineJS/mineflayer/CI.svg?label=CI&logo=github&logoColor=lightgrey)](https://github.com/PrismarineJS/mineflayer/actions?query=workflow%3A%22CI%22)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/PrismarineJS/mineflayer/ci.yml.svg?label=CI&logo=github&logoColor=lightgrey)](https://github.com/PrismarineJS/mineflayer/actions?query=workflow%3A%22CI%22)
 [![Try it on gitpod](https://img.shields.io/static/v1.svg?label=try&message=on%20gitpod&color=brightgreen&logo=gitpod)](https://gitpod.io/#https://github.com/PrismarineJS/mineflayer)
 [![Open In Colab](https://img.shields.io/static/v1.svg?label=open&message=on%20colab&color=blue&logo=google-colab)](https://colab.research.google.com/github/PrismarineJS/mineflayer/blob/master/docs/mineflayer.ipynb)
 [![GitHub Sponsors](https://img.shields.io/github/sponsors/PrismarineJS)](https://github.com/sponsors/PrismarineJS)
@@ -39,13 +39,15 @@ First install Node.js >= 14 from [nodejs.org](https://nodejs.org/) then:
 
 `npm install mineflayer`
 
+To update mineflayer (or any Node.js) package and its dependencies, use `npm update --depth 9999`
+
 ## Documentation
 
 | link | description |
 |---|---|
 |[tutorial](tutorial.md) | Begin with Node.js and mineflayer |
 | [FAQ.md](FAQ.md) | Got a question ? go there first |
-| [api.md](api.md) [unstable_api.md](unstable_api.md) | The full API reference |
+| **[api.md](api.md)** <br/>[unstable_api.md](unstable_api.md) | The full API reference |
 | [history.md](history.md) | The changelog for mineflayer |
 | [examples/](https://github.com/PrismarineJS/mineflayer/tree/master/examples) | Checkout all the mineflayer examples |
 
@@ -79,10 +81,10 @@ const mineflayer = require('mineflayer')
 const bot = mineflayer.createBot({
   host: 'localhost', // minecraft server ip
   username: 'email@example.com', // minecraft username
-  password: '12345678' // minecraft password, comment out if you want to log into online-mode=false servers
+  auth: 'microsoft' // for offline mode servers, you can set this to 'offline'
   // port: 25565,                // only set if you need a port that isn't 25565
   // version: false,             // only set if you need a specific version or snapshot (ie: "1.8.9" or "1.16.5"), otherwise it's set automatically
-  // auth: 'mojang'              // only set if you need microsoft auth, then set this to 'microsoft'
+  // password: '12345678'        // set if you want to use password-based auth (may be unreliable)
 })
 
 bot.on('chat', (username, message) => {
@@ -107,7 +109,7 @@ bot.once('spawn', () => {
 ```
 And you'll get a *live* view looking like this:
 
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarinejs.github.io/prismarine-viewer/)
 
 #### More Examples
 
@@ -123,7 +125,7 @@ And you'll get a *live* view looking like this:
 |[guard](https://github.com/PrismarineJS/mineflayer/blob/master/examples/guard.js) | Make a bot guard a defined area from nearby mobs |
 |[multiple-from-file](https://github.com/PrismarineJS/mineflayer/blob/master/examples/multiple_from_file.js) | Add a text file with accounts and have them all login |
 
-And many mores in the [examples](https://github.com/PrismarineJS/mineflayer/tree/master/examples) folder
+And many more in the [examples](https://github.com/PrismarineJS/mineflayer/tree/master/examples) folder.
 
 ### Modules
 
@@ -180,19 +182,18 @@ The most updated and useful are :
  * [pathfinder](https://github.com/Karang/mineflayer-pathfinder) - advanced A* pathfinding with a lot of configurable features
  * [prismarine-viewer](https://github.com/PrismarineJS/prismarine-viewer) - simple web chunk viewer
  * [web-inventory](https://github.com/ImHarvol/mineflayer-web-inventory) - web based inventory viewer
- * [statemachine](https://github.com/TheDudeFromCI/mineflayer-statemachine) - A state machine API for more complex bot behaviors
+ * [statemachine](https://github.com/PrismarineJS/mineflayer-statemachine) - A state machine API for more complex bot behaviors
  * [Armor Manager](https://github.com/G07cha/MineflayerArmorManager) - automatic armor management
- * [Collect Block](https://github.com/TheDudeFromCI/mineflayer-collectblock) - Quick and simple block collection API.
  * [Dashboard](https://github.com/wvffle/mineflayer-dashboard) - Frontend dashboard for mineflayer bot
- * [PVP](https://github.com/TheDudeFromCI/mineflayer-pvp) - Easy API for basic PVP and PVE.
+ * [PVP](https://github.com/PrismarineJS/mineflayer-pvp) - Easy API for basic PVP and PVE.
  * [Auto Eat](https://github.com/link-discord/mineflayer-auto-eat) - Automatic eating of food.
  * [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) - 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
-
+ * [Movement](https://github.com/firejoust/mineflayer-movement) - Smooth and realistic player movement, best suited for PvP
+ * [Collect Block](https://github.com/PrismarineJS/mineflayer-collectblock) - Quick and simple block collection API.
 
  But also check out :
 
@@ -206,6 +207,7 @@ The most updated and useful are :
 
 ## Projects Using Mineflayer
 
+ * [Voyager](https://github.com/MineDojo/Voyager) An Open-Ended Embodied Agent with Large Language Models
  * [rom1504/rbot](https://github.com/rom1504/rbot)
    - [YouTube - building a spiral staircase](https://www.youtube.com/watch?v=UM1ZV5200S0)
    - [YouTube - replicating a building](https://www.youtube.com/watch?v=0cQxg9uDnzA)
@@ -213,7 +215,7 @@ The most updated and useful are :
  * [vogonistic/voxel](https://github.com/vogonistic/mineflayer-voxel) - visualize what
    the bot is up to using voxel.js
  * [JonnyD/Skynet](https://github.com/JonnyD/Skynet) -  log player activity onto an online API
- * [MinecraftChat](https://github.com/rom1504/MinecraftChat) (last open source version, built by AlexKvazos) -  Minecraft web based chat client <https://minecraftchat.net/>
+ * [MinecraftChat](https://github.com/rom1504/MinecraftChat) (last open source version, built by AlexKvazos) -  Minecraft web based chat client
  * [Cheese Bot](https://github.com/Minecheesecraft/Cheese-Bot) - Plugin based bot with a clean GUI. Made with Node-Webkit.
  * [Chaoscraft](https://github.com/schematical/chaoscraft) - Minecraft bot using genetic algorithms, see [its youtube videos](https://www.youtube.com/playlist?list=PLLkpLgU9B5xJ7Qy4kOyBJl5J6zsDIMceH)
  * [hexatester/minetelegram](https://github.com/hexatester/minetelegram) -  Minecraft - Telegram bridge, build on top of mineflayer & telegraf.

package/docs/FAQ.md

@@ -22,7 +22,7 @@ client.on('end', () => {})
 
 Spigot servers, in particular some plugins, use custom chat formats, you need to parse it with a custom regex / parser.
 Read and adapt [chat_parsing.js](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js) to make it work for your particular
-chat plugin. Also read http://mineflayer.prismarine.js.org/#/tutorial?id=custom-chat
+chat plugin. Also read http://prismarinejs.github.io/mineflayer/#/tutorial?id=custom-chat
 
 ### How can I collect info from an custom plugin in chat ?
 

package/docs/README.md

@@ -1,7 +1,7 @@
 # Mineflayer
 
 [![NPM version](https://img.shields.io/npm/v/mineflayer.svg?color=success&label=npm%20package&logo=npm)](https://www.npmjs.com/package/mineflayer)
-[![Build Status](https://img.shields.io/github/workflow/status/PrismarineJS/mineflayer/CI.svg?label=CI&logo=github&logoColor=lightgrey)](https://github.com/PrismarineJS/mineflayer/actions?query=workflow%3A%22CI%22)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/PrismarineJS/mineflayer/ci.yml.svg?label=CI&logo=github&logoColor=lightgrey)](https://github.com/PrismarineJS/mineflayer/actions?query=workflow%3A%22CI%22)
 [![Try it on gitpod](https://img.shields.io/static/v1.svg?label=try&message=on%20gitpod&color=brightgreen&logo=gitpod)](https://gitpod.io/#https://github.com/PrismarineJS/mineflayer)
 [![Open In Colab](https://img.shields.io/static/v1.svg?label=open&message=on%20colab&color=blue&logo=google-colab)](https://colab.research.google.com/github/PrismarineJS/mineflayer/blob/master/docs/mineflayer.ipynb)
 [![GitHub Sponsors](https://img.shields.io/github/sponsors/PrismarineJS)](https://github.com/sponsors/PrismarineJS)
@@ -39,13 +39,15 @@ First install Node.js >= 14 from [nodejs.org](https://nodejs.org/) then:
 
 `npm install mineflayer`
 
+To update mineflayer (or any Node.js) package and its dependencies, use `npm update --depth 9999`
+
 ## Documentation
 
 | link | description |
 |---|---|
 |[tutorial](tutorial.md) | Begin with Node.js and mineflayer |
 | [FAQ.md](FAQ.md) | Got a question ? go there first |
-| [api.md](api.md) [unstable_api.md](unstable_api.md) | The full API reference |
+| **[api.md](api.md)** <br/>[unstable_api.md](unstable_api.md) | The full API reference |
 | [history.md](history.md) | The changelog for mineflayer |
 | [examples/](https://github.com/PrismarineJS/mineflayer/tree/master/examples) | Checkout all the mineflayer examples |
 
@@ -79,10 +81,10 @@ const mineflayer = require('mineflayer')
 const bot = mineflayer.createBot({
   host: 'localhost', // minecraft server ip
   username: 'email@example.com', // minecraft username
-  password: '12345678' // minecraft password, comment out if you want to log into online-mode=false servers
+  auth: 'microsoft' // for offline mode servers, you can set this to 'offline'
   // port: 25565,                // only set if you need a port that isn't 25565
   // version: false,             // only set if you need a specific version or snapshot (ie: "1.8.9" or "1.16.5"), otherwise it's set automatically
-  // auth: 'mojang'              // only set if you need microsoft auth, then set this to 'microsoft'
+  // password: '12345678'        // set if you want to use password-based auth (may be unreliable)
 })
 
 bot.on('chat', (username, message) => {
@@ -107,7 +109,7 @@ bot.once('spawn', () => {
 ```
 And you'll get a *live* view looking like this:
 
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarinejs.github.io/prismarine-viewer/)
 
 #### More Examples
 
@@ -123,7 +125,7 @@ And you'll get a *live* view looking like this:
 |[guard](https://github.com/PrismarineJS/mineflayer/blob/master/examples/guard.js) | Make a bot guard a defined area from nearby mobs |
 |[multiple-from-file](https://github.com/PrismarineJS/mineflayer/blob/master/examples/multiple_from_file.js) | Add a text file with accounts and have them all login |
 
-And many mores in the [examples](https://github.com/PrismarineJS/mineflayer/tree/master/examples) folder
+And many more in the [examples](https://github.com/PrismarineJS/mineflayer/tree/master/examples) folder.
 
 ### Modules
 
@@ -180,19 +182,18 @@ The most updated and useful are :
  * [pathfinder](https://github.com/Karang/mineflayer-pathfinder) - advanced A* pathfinding with a lot of configurable features
  * [prismarine-viewer](https://github.com/PrismarineJS/prismarine-viewer) - simple web chunk viewer
  * [web-inventory](https://github.com/ImHarvol/mineflayer-web-inventory) - web based inventory viewer
- * [statemachine](https://github.com/TheDudeFromCI/mineflayer-statemachine) - A state machine API for more complex bot behaviors
+ * [statemachine](https://github.com/PrismarineJS/mineflayer-statemachine) - A state machine API for more complex bot behaviors
  * [Armor Manager](https://github.com/G07cha/MineflayerArmorManager) - automatic armor management
- * [Collect Block](https://github.com/TheDudeFromCI/mineflayer-collectblock) - Quick and simple block collection API.
  * [Dashboard](https://github.com/wvffle/mineflayer-dashboard) - Frontend dashboard for mineflayer bot
- * [PVP](https://github.com/TheDudeFromCI/mineflayer-pvp) - Easy API for basic PVP and PVE.
+ * [PVP](https://github.com/PrismarineJS/mineflayer-pvp) - Easy API for basic PVP and PVE.
  * [Auto Eat](https://github.com/link-discord/mineflayer-auto-eat) - Automatic eating of food.
  * [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) - 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
-
+ * [Movement](https://github.com/firejoust/mineflayer-movement) - Smooth and realistic player movement, best suited for PvP
+ * [Collect Block](https://github.com/PrismarineJS/mineflayer-collectblock) - Quick and simple block collection API.
 
  But also check out :
 
@@ -206,6 +207,7 @@ The most updated and useful are :
 
 ## Projects Using Mineflayer
 
+ * [Voyager](https://github.com/MineDojo/Voyager) An Open-Ended Embodied Agent with Large Language Models
  * [rom1504/rbot](https://github.com/rom1504/rbot)
    - [YouTube - building a spiral staircase](https://www.youtube.com/watch?v=UM1ZV5200S0)
    - [YouTube - replicating a building](https://www.youtube.com/watch?v=0cQxg9uDnzA)
@@ -213,7 +215,7 @@ The most updated and useful are :
  * [vogonistic/voxel](https://github.com/vogonistic/mineflayer-voxel) - visualize what
    the bot is up to using voxel.js
  * [JonnyD/Skynet](https://github.com/JonnyD/Skynet) -  log player activity onto an online API
- * [MinecraftChat](https://github.com/rom1504/MinecraftChat) (last open source version, built by AlexKvazos) -  Minecraft web based chat client <https://minecraftchat.net/>
+ * [MinecraftChat](https://github.com/rom1504/MinecraftChat) (last open source version, built by AlexKvazos) -  Minecraft web based chat client
  * [Cheese Bot](https://github.com/Minecheesecraft/Cheese-Bot) - Plugin based bot with a clean GUI. Made with Node-Webkit.
  * [Chaoscraft](https://github.com/schematical/chaoscraft) - Minecraft bot using genetic algorithms, see [its youtube videos](https://www.youtube.com/playlist?list=PLLkpLgU9B5xJ7Qy4kOyBJl5J6zsDIMceH)
  * [hexatester/minetelegram](https://github.com/hexatester/minetelegram) -  Minecraft - Telegram bridge, build on top of mineflayer & telegraf.

package/docs/api.md

@@ -16,6 +16,7 @@
     - [vec3](#vec3)
     - [mineflayer.Location](#mineflayerlocation)
     - [Entity](#entity)
+      - [Player Skin Data](#player-skin-data)
     - [Block](#block)
     - [Biome](#biome)
     - [Item](#item)
@@ -405,6 +406,18 @@ Entities represent players, mobs, and objects. They are emitted
 in many events, and you can access your own entity with `bot.entity`.
 See [prismarine-entity](https://github.com/PrismarineJS/prismarine-entity)
 
+#### Player Skin Data
+
+The skin data is stored in the `skinData` property of the player object, if present.
+
+```js
+// player.skinData
+{
+  url: 'http://textures.minecraft.net/texture/...',
+  model: 'slim' // or 'classic'
+}
+```
+
 ### Block
 
 See [prismarine-block](https://github.com/PrismarineJS/prismarine-block)
@@ -785,6 +798,8 @@ Create and return an instance of the class bot.
  * loadInternalPlugins : defaults to true
  * storageBuilder : an optional function, takes as argument version and worldName and return an instance of something with the same API as prismarine-provider-anvil. Will be used to save the world.
  * client : an instance of node-minecraft-protocol, if not specified, mineflayer makes it's own client. This can be used to enable using mineflayer through a proxy of many clients or a vanilla client and a mineflayer client.
+ * brand : the brand name for the client to use. Defaults to vanilla. Can be used to simulate custom clients for servers that require it.
+ * respawn : when set to false disables bot from automatically respawning, defaults to true.
  * plugins : object : defaults to {}
    - pluginName : false : don't load internal plugin with given name ie. `pluginName`
    - pluginName : true : load internal plugin with given name ie. `pluginName` even though loadInternalplugins is set to false
@@ -814,15 +829,13 @@ A sync representation of the world. Check the doc at http://github.com/Prismarin
 
 Fires when a block updates. Both `oldBlock` and `newBlock` provided for
 comparison.
-
-Note that `oldBlock` may be `null`.
+`oldBlock` may be `null` with normal block updates.
 
 ##### world "blockUpdate:(x, y, z)" (oldBlock, newBlock)
 
 Fires for a specific point. Both `oldBlock` and `newBlock` provided for
-comparison.
-
-Note that `oldBlock` may be `null`.
+comparison. All listeners receive null for `oldBlock` and `newBlock` and get automatically removed when the world is unloaded.
+`oldBlock` may be `null` with normal block updates.
 
 
 #### bot.entity
@@ -853,6 +866,8 @@ Whether the bot is using the item that it's holding, for example eating food or
 
 #### bot.game.dimension
 
+The bot's current dimension, such as `overworld`, `the_end` or `the_nether`.
+
 #### bot.game.difficulty
 
 #### bot.game.gameMode
@@ -2064,9 +2079,9 @@ These are lower level methods for the inventory, they can be useful sometimes bu
 
 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 draging is not implemented.
+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_Window
+Click on the current window. See details at https://wiki.vg/Protocol#Click_Container
 
 Prefer using bot.simpleClick.*
 

package/docs/es/FAQ_ES.md

@@ -15,7 +15,7 @@ client.on('end', () => {})
 ## Mi evento de chat no se emite en un servidor personalizado, cómo lo resuelvo?
 
 Los servidores spigot, en particular algunos plugins, usan formatos personalizados de chat, tienes que analizarlos con un regex personalizado.
-Lee y modifica [chat_parsing.js](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js) para que funcione con tu plugin de chat particular. Lee también http://mineflayer.prismarine.js.org/#/tutorial?id=custom-chat
+Lee y modifica [chat_parsing.js](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js) para que funcione con tu plugin de chat particular. Lee también http://prismarinejs.github.io/mineflayer/#/tutorial?id=custom-chat
 
 ### Como puedo recolectar información de un plugin de chat personalizado?
 

package/docs/es/README_ES.md

@@ -104,7 +104,7 @@ bot.once('spawn', () => {
 ```
 Y podrás ver una representación *en vivo* como esta:
 
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarinejs.github.io/prismarine-viewer/)
 
 #### Más ejemplos
 

package/docs/fr/FAQ_FR.md

@@ -23,7 +23,7 @@ client.on('end', () => {})
 
 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>
+plugin de chat. A lire également <http://prismarinejs.github.io/mineflayer/#/tutorial?id=custom-chat>
 
 ### Comment puis-je collecter les informations d'un plugin personnalisé dans le chat ?
 

package/docs/fr/README_FR.md

@@ -108,7 +108,7 @@ bot.once('spawn', () => {
 ```
 et vous obtiendrez un affichage en *direct* qui ressemble à ceci:
 
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarinejs.github.io/prismarine-viewer/)
 
 #### Exemples:
 

package/docs/history.md

@@ -1,3 +1,24 @@
+## 4.9.0
+
+* Fix bot not updating world height on respawn packet (@frej4189)
+* Persist properties received in player_info packet (@Paulomart)
+* Fix reference error with block updates (@IceTank)
+* Add spectator to gameModes array (@williamd5)
+* Standardize dimensions for all versions (@sefirosweb)
+* Emit inject_allowed after a timeout of 0 (@IceTank)
+* Add window transaction timeout (@firejoust)
+* Made bot auto respawning togglable (@Averagess)
+* support 1.19.4 (@extremeheat)
+
+## 4.8.1
+
+* Fix client crashing when player_remove contains unknown player (@frej4189)
+* Improve look and fix bug slow craft (@sefirosweb)
+* Fix player entity being unset when player is updated (@frej4189)
+* Fix type (@sefirosweb)
+* Improve crafting stacks (@sefirosweb)
+* add example for using the node:readline module (@Jovan-04)
+
 ## 4.8.0
 
 * Update chat parsing (@frej4189)

package/docs/ru/FAQ_RU.md

@@ -14,7 +14,7 @@ client.on('end', () => {})
 
 Сервера Spigot, в частности некоторые плагины, используют разные форматы чата, вам необходимо проанализировать его с помощью регулярного выражения/парсера.
 Посмотрите и измените скрипт [chatAddPattern.js](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chatAddPattern.js), чтобы он работал для вашего плагина чата,
-также прочтите http://mineflayer.prismarine.js.org/#/tutorial?id=custom-chat.
+также прочтите http://prismarinejs.github.io/mineflayer/#/tutorial?id=custom-chat.
 
 ### Как я могу отправлять команды серверу?
 

package/docs/ru/README_RU.md

@@ -108,7 +108,7 @@ bot.once('spawn', () => {
 ```
 После запуска, вы в прямом эфире сможете наблюдать за происходящим:
 
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarinejs.github.io/prismarine-viewer/)
 
 #### Больше примеров
 

package/docs/tr/README_TR.md

@@ -104,7 +104,7 @@ bot.once('spawn', () => {
 ```
 ve şuna benzeyen *canlı* bir görüntü elde edeceksin:
 
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarinejs.github.io/prismarine-viewer/)
 
 #### Daha fazla örnek
 

package/docs/tutorial.md

@@ -417,7 +417,7 @@ bot.once('spawn', () => {
 
 ### Listening for an event
 
-The bot object has many useful [events](http://mineflayer.prismarine.js.org/#/api?id=events).
+The bot object has many useful [events](http://prismarinejs.github.io/mineflayer/#/api?id=events).
 You can listen for an event by using either `bot.on()` method or `bot.once()` method of the bot object, which takes the name of an event and a function.
 To remove specific listener you can use `bot.removeListener()` method.
 
@@ -428,7 +428,7 @@ To remove specific listener you can use `bot.removeListener()` method.
 - `bot.removeListener(eventName, listener)`
   Removes the specified `listener` for the event named `eventName`. In order to use this you either need to define your function with `function myNamedFunc() {}` or put your function in a variable with `const myNamedFunc = () => {}`. You can then use `myNamedFunc` in the listener argument.
 
-Not only bot object, [`Chest`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerchest), [`Furnace`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerfurnace), [`Dispenser`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerdispenser), [`EnchantmentTable`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerenchantmenttable), [`Villager`](http://mineflayer.prismarine.js.org/#/api?id=mineflayervillager) object also have their own events!
+Not only bot object, [`Chest`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerchest), [`Furnace`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerfurnace), [`Dispenser`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerdispenser), [`EnchantmentTable`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerenchantmenttable), [`Villager`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayervillager) object also have their own events!
 
 ### Promises
 A [promise](https://nodejs.dev/learn/understanding-javascript-promises) is a function that you can use the `await` variable to wait on until it's job is complete. (you can omit the await to not wait for results)
@@ -557,8 +557,8 @@ In general, you'll want to use `for of` instead of `for in` so make sure you don
 
 ### Creating an event from chat
 
-You can create your own event from chat using [`bot.chatAddPattern()`](http://mineflayer.prismarine.js.org/#/api?id=botchataddpatternpattern-chattype-description) method. Useful for Bukkit servers where the chat format changes a lot.
-[`bot.chatAddPattern()`](http://mineflayer.prismarine.js.org/#/api?id=botchataddpatternpattern-chattype-description) method takes three arguments :
+You can create your own event from chat using [`bot.chatAddPattern()`](http://prismarinejs.github.io/mineflayer/#/api?id=botchataddpatternpattern-chattype-description) method. Useful for Bukkit servers where the chat format changes a lot.
+[`bot.chatAddPattern()`](http://prismarinejs.github.io/mineflayer/#/api?id=botchataddpatternpattern-chattype-description) method takes three arguments :
 
 - `pattern` - regular expression (regex) to match chat
 - `chatType` - the event the bot emits when the pattern matches. e.g. "chat" or "whisper"

package/docs/zh/FAQ.md

@@ -15,7 +15,7 @@ client.on('end', () => {})
 ### 我无法在自定义服务器上获取聊天事件，如何解决?
 
 Spigot 服务器, 特别是一些插件, 使用的是自定义聊天格式,您需要使用自定义正则表达式/解析器对其进行解析。
-阅读并改编[chat_parsing.js](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js)使其适用于您的特定聊天插件. 或者阅读 http://mineflayer.prismarine.js.org/#/tutorial?id=custom-chat
+阅读并改编[chat_parsing.js](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js)使其适用于您的特定聊天插件. 或者阅读 http://prismarinejs.github.io/mineflayer/#/tutorial?id=custom-chat
 
 ### 如何用自定义插件在聊天中收集信息 ?
 

package/docs/zh/README_ZH_CN.md

@@ -101,7 +101,7 @@ bot.on('error', console.log)
 ### 看看你的bot在做什么
 
 感谢 [prismarin-viewer](https://github.com/PrismarineJS/prismarine-viewer)项目，它可以在浏览器窗口显示你的机器人正在做什么。  
-只需要运行 `npm install prismane-viewer` 并将其添加到你的bot代码中。
+只需要运行 `npm install prismarine-viewer` 并将其添加到你的bot代码中。
 
 ```js
 const { mineflayer: mineflayerViewer } = require('prismarine-viewer')
@@ -112,7 +112,7 @@ bot.once('spawn', () => {
 
 然后你会得到一个看起来像这样的*实时视图*：
 
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="500">](https://prismarinejs.github.io/prismarine-viewer/)
 
 #### 更多示例
 

package/docs/zh/tutorial.md

@@ -417,7 +417,7 @@ bot.once('spawn', () => {
 
 ### Listening for an event
 
-The bot object has many useful [events](http://mineflayer.prismarine.js.org/#/api?id=events).
+The bot object has many useful [events](http://prismarinejs.github.io/mineflayer/#/api?id=events).
 You can listen for an event by using either `bot.on()` method or `bot.once()` method of the bot object, which takes the name of an event and a function.
 To remove specific listener you can use `bot.removeListener()` method.
 
@@ -428,7 +428,7 @@ To remove specific listener you can use `bot.removeListener()` method.
 - `bot.removeListener(eventName, listener)`
   Removes the specified `listener` for the event named `eventName`. In order to use this you either need to define your function with `function myNamedFunc() {}` or put your function in a variable with `const myNamedFunc = () => {}`. You can then use `myNamedFunc` in the listener argument.
 
-Not only bot object, [`Chest`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerchest), [`Furnace`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerfurnace), [`Dispenser`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerdispenser), [`EnchantmentTable`](http://mineflayer.prismarine.js.org/#/api?id=mineflayerenchantmenttable), [`Villager`](http://mineflayer.prismarine.js.org/#/api?id=mineflayervillager) object also have their own events!
+Not only bot object, [`Chest`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerchest), [`Furnace`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerfurnace), [`Dispenser`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerdispenser), [`EnchantmentTable`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayerenchantmenttable), [`Villager`](http://prismarinejs.github.io/mineflayer/#/api?id=mineflayervillager) object also have their own events!
 
 ### Callbacks
 A [callback](https://en.wikipedia.org/wiki/Callback_(computer_programming)) is a function that you can give to another function, that is expected to be *called back*, generally when that function ends.  
@@ -491,7 +491,7 @@ The reason the incorrect approach is wrong is because when `bot.craft()` is call
 By the time the code reaches the second `bot.craft()`, the first probably hasn't finished yet, which means the wanted resource is not available yet.  
 Using callbacks can fix this because they will only be called after the `bot.craft()` is finished.
 
-More on the [bot.craft()](https://mineflayer.prismarine.js.org/#/api?id=botcraftrecipe-count-craftingtable-callback) method.
+More on the [bot.craft()](https://prismarinejs.github.io/mineflayer/#/api?id=botcraftrecipe-count-craftingtable-callback) method.
 
 ## 高级
 
@@ -608,8 +608,8 @@ In general, you'll want to use `for of` instead of `for in` so make sure you don
 
 ### 从聊天中创建事件
 
-You can create your own event from chat using [`bot.chatAddPattern()`](http://mineflayer.prismarine.js.org/#/api?id=botchataddpatternpattern-chattype-description) method. Useful for Bukkit servers where the chat format changes a lot.
-[`bot.chatAddPattern()`](http://mineflayer.prismarine.js.org/#/api?id=botchataddpatternpattern-chattype-description) method takes three arguments :
+You can create your own event from chat using [`bot.chatAddPattern()`](http://prismarinejs.github.io/mineflayer/#/api?id=botchataddpatternpattern-chattype-description) method. Useful for Bukkit servers where the chat format changes a lot.
+[`bot.chatAddPattern()`](http://prismarinejs.github.io/mineflayer/#/api?id=botchataddpatternpattern-chattype-description) method takes three arguments :
 
 - `pattern` - regular expression (regex) to match chat
 - `chatType` - the event the bot emits when the pattern matches. e.g. "chat" or "whisper"

package/examples/cli/readline.js

@@ -0,0 +1,50 @@
+/*
+ * This example is an easy way to connect mineflayer to the node:readline module
+ * See: https://nodejs.org/api/readline.html
+ * Using this, we can make a simple terminal-to-ingame-chat interface
+ *
+ * Made by Jovan04 01/24/2023
+*/
+
+if (process.argv.length < 4 || process.argv.length > 6) {
+  console.log('Usage : node readline.js <host> <port> [<name>] [<auth>]')
+  process.exit(1)
+}
+
+const mineflayer = require('mineflayer') // load mineflayer library
+const readline = require('node:readline') // load the node.js readline module
+
+// bot options
+const options = {
+  host: process.argv[2],
+  port: parseInt(process.argv[3]),
+  username: process.argv[4] || 'readline',
+  auth: process.argv[5] || 'offline'
+}
+
+const bot = mineflayer.createBot(options) // join the minecraft server
+
+const rl = readline.createInterface({ // creates our readline interface with our console as input and output
+  input: process.stdin,
+  output: process.stdout
+})
+
+bot.once('spawn', () => {
+  console.log(`Bot joined the game with username ${bot.username}.`)
+  rl.setPrompt('> '); rl.prompt() // gives us a little arrow at the bottom for the input line
+})
+
+bot.on('message', (message) => {
+  readline.moveCursor(process.stdout, -2, 0) // we move the cursor to the left two places because our cursor is already two positions in (because of the input arrow)
+  console.log(message.toAnsi()) // convert our message to ansi to preserve chat formatting
+  rl.prompt() // regenerate our little arrow on the input line
+})
+
+rl.on('line', (line) => {
+  readline.moveCursor(process.stdout, 0, -1) // move cursor up one line
+  readline.clearScreenDown(process.stdout) // clear all the lines below the cursor (i.e. the last line we entered)
+  bot.chat(line.toString()) // sends the line we entered to ingame chat
+})
+
+bot.on('kicked', console.log)
+bot.on('error', console.log)

package/examples/skin_data.js

@@ -0,0 +1,26 @@
+/*
+ * This script will automatically set if a totem is in the inventory or the off-hand.
+ * It checks for a totem every tick.
+ */
+const mineflayer = require('mineflayer')
+
+if (process.argv.length < 4 || process.argv.length > 6) {
+  console.log('Usage : node skin_data.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] : 'skin_data',
+  password: process.argv[5]
+})
+
+setTimeout(() => {
+  bot.quit()
+  console.log('Skin data:')
+  console.log(Object.entries(bot.players).map(([name, player]) => ({
+    name,
+    skinData: player.skinData
+  })))
+}, 10000)

package/examples/trader.js

@@ -96,7 +96,7 @@ async function trade (id, index, count) {
     default: {
       const villager = await bot.openVillager(e)
       const trade = villager.trades[index - 1]
-      count = count || trade.maxTradeuses - trade.tooluses
+      count = count || trade.maximumNbTradeUses - trade.nbTradeUses
       switch (true) {
         case !trade:
           villager.close()
@@ -106,11 +106,11 @@ async function trade (id, index, count) {
           villager.close()
           bot.chat('trade is disabled')
           break
-        case trade.maxTradeuses - trade.tooluses < count:
+        case trade.maximumNbTradeUses - trade.nbTradeUses < count:
           villager.close()
           bot.chat('cant trade that often')
           break
-        case !hasResources(villager.window, trade, count):
+        case !hasResources(villager.slots, trade, count):
           villager.close()
           bot.chat('dont have the resources to do that trade')
           break
@@ -120,7 +120,7 @@ async function trade (id, index, count) {
             await bot.trade(villager, index - 1, count)
             bot.chat(`traded ${count} times`)
           } catch (err) {
-            bot.chat('an error acured while tyring to trade')
+            bot.chat('an error occurred while trying to trade')
             console.log(err)
           }
           villager.close()
@@ -129,23 +129,29 @@ async function trade (id, index, count) {
   }
 
   function hasResources (window, trade, count) {
-    const first = enough(trade.firstInput, count)
-    const second = !trade.hasSecondItem || enough(trade.secondaryInput, count)
+    const first = enough(trade.inputItem1, count)
+    const second = !trade.inputItem2 || enough(trade.inputItem2, count)
     return first && second
 
     function enough (item, count) {
-      return window.count(item.type, item.metadata) >= item.count * count
+      let c = 0
+      window.forEach((element) => {
+        if (element && element.type === item.type && element.metadata === item.metadata) {
+          c += element.count
+        }
+      })
+      return c >= item.count * count
     }
   }
 }
 
 function stringifyTrades (trades) {
   return trades.map((trade) => {
-    let text = stringifyItem(trade.firstInput)
-    if (trade.secondaryInput) text += ` & ${stringifyItem(trade.secondaryInput)}`
+    let text = stringifyItem(trade.inputItem1)
+    if (trade.inputItem2) text += ` & ${stringifyItem(trade.inputItem2)}`
     if (trade.disabled) text += ' x '; else text += ' » '
-    text += stringifyItem(trade.output)
-    return `(${trade.tooluses}/${trade.maxTradeuses}) ${text}`
+    text += stringifyItem(trade.outputItem)
+    return `(${trade.nbTradeUses}/${trade.maximumNbTradeUses}) ${text}`
   })
 }
 
@@ -158,7 +164,7 @@ function stringifyItem (item) {
     const Potion = item.nbt.value.Potion
     const display = item.nbt.value.display
 
-    if (Potion) text += ` of ${Potion.value.replace(/_/g, ' ').split(':')[1] || 'unknow type'}`
+    if (Potion) text += ` of ${Potion.value.replace(/_/g, ' ').split(':')[1] || 'unknown type'}`
     if (display) text += ` named ${display.value.Name.value}`
     if (ench || StoredEnchantments) {
       text += ` enchanted with ${(ench || StoredEnchantments).value.value.map((e) => {

package/examples/viewer/README.md

@@ -1 +1 @@
-[<img src="https://prismarine.js.org/prismarine-viewer/test_1.16.1.png" alt="viewer" width="800">](https://prismarine.js.org/prismarine-viewer/)
+[<img src="https://prismarinejs.github.io/prismarine-viewer/test_1.16.1.png" alt="viewer" width="800">](https://prismarinejs.github.io/prismarine-viewer/)

package/index.d.ts

@@ -28,6 +28,7 @@ export interface BotOptions extends ClientOptions {
   client?: Client
   brand?: string
   defaultChatPatterns?: boolean
+  respawn?: boolean
 }
 
 export type ChatLevel = 'enabled' | 'commandsOnly' | 'disabled'
@@ -40,7 +41,7 @@ export interface PluginOptions {
 
 export type Plugin = (bot: Bot, options: BotOptions) => void
 
-interface BotEvents {
+export interface BotEvents {
   chat: (
     username: string,
     message: string,
@@ -104,7 +105,7 @@ interface BotEvents {
   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
+  'blockUpdate:(x, y, z)': (oldBlock: Block | null, newBlock: Block | null) => Promise<void> | void
   chunkColumnLoad: (entity: Vec3) => Promise<void> | void
   chunkColumnUnload: (entity: Vec3) => Promise<void> | void
   soundEffectHeard: (
@@ -122,7 +123,7 @@ interface BotEvents {
   ) => 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
+  chestLidMove: (block: Block, isOpen: number, block2: Block | null) => Promise<void> | void
   blockBreakProgressObserved: (block: Block, destroyStage: number) => Promise<void> | void
   blockBreakProgressEnd: (block: Block) => Promise<void> | void
   diggingCompleted: (block: Block) => Promise<void> | void
@@ -190,6 +191,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
   world: any
   _client: Client
   heldItem: Item | null
+  usingHeldItem: boolean
   currentWindow: Window | null
   simpleClick: simpleClick
   tablist: Tablist
@@ -449,7 +451,7 @@ export type LevelType =
   | 'buffet'
   | 'default_1_1'
 export type GameMode = 'survival' | 'creative' | 'adventure' | 'spectator'
-export type Dimension = 'minecraft:the_nether' | 'minecraft:overworld' | 'minecraft:the_end'
+export type Dimension = 'the_nether' | 'overworld' | 'the_end'
 export type Difficulty = 'peaceful' | 'easy' | 'normal' | 'hard'
 
 export interface Player {
@@ -459,12 +461,18 @@ export interface Player {
   gamemode: number
   ping: number
   entity: Entity
+  skinData: SkinData | undefined
   profileKeys?: {
     publicKey: Buffer
     signature: Buffer
   }
 }
 
+export interface SkinData {
+  url: string
+  model: string | null
+}
+
 export interface ChatPattern {
   pattern: RegExp
   type: string
@@ -558,7 +566,7 @@ export interface FindBlockOptions {
   matching: number | number[] | ((block: Block) => boolean)
   maxDistance?: number
   count?: number
-  useExtraInfo?: boolean
+  useExtraInfo?: boolean | ((block: Block) => boolean)
 }
 
 export type EquipmentDestination = 'hand' | 'head' | 'torso' | 'legs' | 'feet' | 'off-hand'

package/lib/loader.js

@@ -69,6 +69,7 @@ function createBot (options = {}) {
   options.loadInternalPlugins = options.loadInternalPlugins ?? true
   options.client = options.client ?? null
   options.brand = options.brand ?? 'vanilla'
+  options.respawn = options.respawn ?? true
   const bot = new EventEmitter()
   bot._client = options.client
   bot.end = (reason) => bot._client.end(reason)
@@ -123,7 +124,7 @@ function createBot (options = {}) {
     bot.version = version.minecraftVersion
     options.version = version.minecraftVersion
     bot.supportFeature = bot.registry.supportFeature
-    bot.emit('inject_allowed')
+    setTimeout(() => bot.emit('inject_allowed'), 0)
   }
   return bot
 }

package/lib/plugins/bed.js

@@ -131,7 +131,7 @@ function inject (bot) {
         throw new Error('the bed is too far')
       }
 
-      if (bot.gameMode !== 'creative' || bot.supportFeature('creativeSleepNearMobs')) { // If in creative mode the bot should be able to sleep even if there are monster nearby (starting in 1.13)
+      if (bot.game.gameMode !== 'creative' || bot.supportFeature('creativeSleepNearMobs')) { // If in creative mode the bot should be able to sleep even if there are monster nearby (starting in 1.13)
         const nwMonsterCorner = headPoint.offset(monsterRange[1], -6, monsterRange[2]) // North-West lower corner
         const seMonsterCorner = headPoint.offset(monsterRange[3], 4, monsterRange[0]) // South-East upper corner
 

package/lib/plugins/blocks.js

@@ -275,7 +275,7 @@ function inject (bot, { version, storageBuilder, hideErrors }) {
       bitMap: packet.bitMap,
       heightmaps: packet.heightmaps,
       biomes: packet.biomes,
-      skyLightSent: bot.game.dimension === 'minecraft:overworld',
+      skyLightSent: bot.game.dimension === 'overworld',
       groundUp: packet.groundUp,
       data: packet.chunkData,
       trustEdges: packet.trustEdges,

package/lib/plugins/craft.js

@@ -6,6 +6,7 @@ module.exports = inject
 function inject (bot) {
   const Item = require('prismarine-item')(bot.registry)
   const Recipe = require('prismarine-recipe')(bot.registry).Recipe
+  let windowCraftingTable
 
   async function craft (recipe, count, craftingTable) {
     assert.ok(recipe)
@@ -13,19 +14,36 @@ function inject (bot) {
     if (recipe.requiresTable && !craftingTable) {
       throw new Error('recipe requires craftingTable')
     }
-    for (let i = 0; i < count; i++) {
-      await craftOnce(recipe, craftingTable)
+
+    try {
+      for (let i = 0; i < count; i++) {
+        await craftOnce(recipe, craftingTable)
+      }
+
+      if (windowCraftingTable) {
+        bot.closeWindow(windowCraftingTable)
+        windowCraftingTable = undefined
+      }
+    } catch (err) {
+      if (windowCraftingTable) {
+        bot.closeWindow(windowCraftingTable)
+        windowCraftingTable = undefined
+      }
+      throw new Error(err)
     }
   }
 
   async function craftOnce (recipe, craftingTable) {
     if (craftingTable) {
-      bot.activateBlock(craftingTable)
-      const [window] = await once(bot, 'windowOpen')
-      if (!window.type.startsWith('minecraft:crafting')) {
+      if (!windowCraftingTable) {
+        bot.activateBlock(craftingTable)
+        const [window] = await once(bot, 'windowOpen')
+        windowCraftingTable = window
+      }
+      if (!windowCraftingTable.type.startsWith('minecraft:crafting')) {
         throw new Error('crafting: non craftingTable used as craftingTable')
       }
-      await startClicking(window, 3, 3)
+      await startClicking(windowCraftingTable, 3, 3)
     } else {
       await startClicking(bot.inventory, 2, 2)
     }
@@ -73,7 +91,7 @@ function inject (bot) {
         if (ingredient.id === -1) return nextShapeClick()
         if (!window.selectedItem || window.selectedItem.type !== ingredient.id ||
           (ingredient.metadata != null &&
-          window.selectedItem.metadata !== ingredient.metadata)) {
+            window.selectedItem.metadata !== ingredient.metadata)) {
           // we are not holding the item we need. click it.
           const sourceItem = window.findInventoryItem(ingredient.id, ingredient.metadata)
           if (!sourceItem) throw new Error('missing ingredient')
@@ -89,7 +107,7 @@ function inject (bot) {
         const destSlot = extraSlots.pop()
         if (!window.selectedItem || window.selectedItem.type !== ingredient.id ||
           (ingredient.metadata != null &&
-          window.selectedItem.metadata !== ingredient.metadata)) {
+            window.selectedItem.metadata !== ingredient.metadata)) {
           // we are not holding the item we need. click it.
           const sourceItem = window.findInventoryItem(ingredient.id, ingredient.metadata)
           if (!sourceItem) throw new Error('missing ingredient')
@@ -126,7 +144,6 @@ function inject (bot) {
           for (let i = 1; i <= w * h; i++) {
             window.updateSlot(i, null)
           }
-          closeTheWindow()
           return
         }
         const slotsToClick = []
@@ -145,11 +162,6 @@ function inject (bot) {
         for (const _slot of slotsToClick) {
           await bot.putAway(_slot)
         }
-        closeTheWindow()
-      }
-
-      function closeTheWindow () {
-        bot.closeWindow(window)
       }
 
       function slot (x, y) {

package/lib/plugins/digging.js

@@ -162,7 +162,8 @@ function inject (bot) {
     function onBlockUpdate (oldBlock, newBlock) {
       // vanilla server never actually interrupt digging, but some server send block update when you start digging
       // so ignore block update if not air
-      if (newBlock.type !== 0) return
+      // All block update listeners receive (null, null) when the world is unloaded. So newBlock can be null.
+      if (newBlock?.type !== 0) return
       bot.removeListener(eventName, onBlockUpdate)
       clearInterval(swingInterval)
       clearTimeout(waitTimeout)

package/lib/plugins/entities.js

@@ -361,28 +361,48 @@ function inject (bot) {
     entity.metadata = metadata
     bot.emit('entityUpdate', entity)
 
-    const typeSlot = (bot.supportFeature('itemsAreAlsoBlocks') ? 5 : 6) + (bot.supportFeature('entityMetadataHasLong') ? 1 : 0)
-    const slot = packet.metadata.find(e => e.type === typeSlot)
-    if (entity.name && (entity.name.toLowerCase() === 'item' || entity.name === 'item_stack') && slot) {
-      bot.emit('itemDrop', entity)
-    }
+    if (bot.supportFeature('mcDataHasEntityMetadata')) {
+      const { metadataKeys } = bot.registry.entitiesByName[entity.name] ?? {}
+      const metas = Object.fromEntries(packet.metadata.map(e => [metadataKeys[e.key], e.value]))
+      if (packet.metadata.some(m => m.type === 'item_stack')) {
+        bot.emit('itemDrop', entity)
+      }
+      if (metas.sleeping_pos || metas.pose === 2) {
+        bot.emit('entitySleep', entity)
+      }
+      if (metas.shared_flags != null) {
+        if (metas.shared_flags & 2) {
+          entity.crouching = true
+          bot.emit('entityCrouch', entity)
+        } else if (entity.crouching) { // prevent the initial entity_metadata packet from firing off an uncrouch event
+          entity.crouching = false
+          bot.emit('entityUncrouch', entity)
+        }
+      }
+    } else {
+      const typeSlot = (bot.supportFeature('itemsAreAlsoBlocks') ? 5 : 6) + (bot.supportFeature('entityMetadataHasLong') ? 1 : 0)
+      const slot = packet.metadata.find(e => e.type === typeSlot)
+      if (entity.name && (entity.name.toLowerCase() === 'item' || entity.name === 'item_stack') && slot) {
+        bot.emit('itemDrop', entity)
+      }
 
-    const typePose = bot.supportFeature('entityMetadataHasLong') ? 19 : 18
-    const pose = packet.metadata.find(e => e.type === typePose)
-    if (pose && pose.value === 2) {
-      bot.emit('entitySleep', entity)
-    }
+      const typePose = bot.supportFeature('entityMetadataHasLong') ? 19 : 18
+      const pose = packet.metadata.find(e => e.type === typePose)
+      if (pose && pose.value === 2) {
+        bot.emit('entitySleep', entity)
+      }
 
-    const bitField = packet.metadata.find(p => p.key === 0)
-    if (bitField === undefined) {
-      return
-    }
-    if ((bitField.value & 2) !== 0) {
-      entity.crouching = true
-      bot.emit('entityCrouch', entity)
-    } else if (entity.crouching) { // prevent the initial entity_metadata packet from firing off an uncrouch event
-      entity.crouching = false
-      bot.emit('entityUncrouch', entity)
+      const bitField = packet.metadata.find(p => p.key === 0)
+      if (bitField === undefined) {
+        return
+      }
+      if ((bitField.value & 2) !== 0) {
+        entity.crouching = true
+        bot.emit('entityCrouch', entity)
+      } else if (entity.crouching) { // prevent the initial entity_metadata packet from firing off an uncrouch event
+        entity.crouching = false
+        bot.emit('entityUncrouch', entity)
+      }
     }
   })
 
@@ -462,6 +482,7 @@ function inject (bot) {
         if (packet.action & 1) {
           obj.username = item.player.name
           obj.displayName = player.displayName || new ChatMessage({ text: '', extra: [{ text: item.player.name }] })
+          obj.skinData = extractSkinInformation(item.player.properties)
         }
 
         if (packet.action & 4) {
@@ -484,7 +505,7 @@ function inject (bot) {
           Object.assign(player, obj)
         }
 
-        const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === obj.username)
+        const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === player.username)
         player.entity = playerEntity
 
         if (playerEntity === bot.entity) {
@@ -510,6 +531,7 @@ function inject (bot) {
               ping: item.ping,
               uuid: item.UUID,
               displayName: new ChatMessage({ text: '', extra: [{ text: item.name }] }),
+              skinData: extractSkinInformation(item.properties),
               profileKeys: item.crypto
                 ? {
                     publicKey: item.crypto.publicKey, // DER-encoded public key
@@ -525,6 +547,7 @@ function inject (bot) {
             // Just an Update
             player.gamemode = item.gamemode
             player.ping = item.ping
+            player.skinData = extractSkinInformation(item.properties)
             if (item.crypto) {
               player.profileKeys = {
                 publicKey: item.crypto.publicKey,
@@ -579,7 +602,7 @@ function inject (bot) {
     for (const uuid of packet.players) {
       const player = bot.uuidToUsername[uuid] ? bot.players[bot.uuidToUsername[uuid]] : null
 
-      if (player.entity === bot.entity) continue
+      if (!player || player.entity === bot.entity) continue
 
       player.entity = null
       delete bot.players[player.username]
@@ -706,3 +729,25 @@ function parseMetadata (metadata, entityMetadata = {}) {
 
   return entityMetadata
 }
+
+function extractSkinInformation (properties) {
+  if (!properties) {
+    return undefined
+  }
+
+  const props = Object.fromEntries(properties.map((e) => [e.name, e]))
+  if (!props.textures || !props.textures.value) {
+    return undefined
+  }
+
+  const skinTexture = JSON.parse(Buffer.from(props.textures.value, 'base64').toString('utf8'))
+
+  const skinTextureUrl = skinTexture?.textures?.SKIN?.url ?? undefined
+  const skinTextureModel = skinTexture?.textures?.SKIN?.metadata?.model ?? undefined
+
+  if (!skinTextureUrl) {
+    return undefined
+  }
+
+  return { url: skinTextureUrl, model: skinTextureModel }
+}

package/lib/plugins/game.js

@@ -2,12 +2,12 @@ const nbt = require('prismarine-nbt')
 module.exports = inject
 
 const difficultyNames = ['peaceful', 'easy', 'normal', 'hard']
-const gameModes = ['survival', 'creative', 'adventure']
+const gameModes = ['survival', 'creative', 'adventure', 'spectator']
 
 const dimensionNames = {
-  '-1': 'minecraft:nether',
-  0: 'minecraft:overworld',
-  1: 'minecraft:end'
+  '-1': 'the_nether',
+  0: 'overworld',
+  1: 'the_end'
 }
 
 const parseGameMode = gameModeBits => gameModes[(gameModeBits & 0b11)] // lower two bits
@@ -29,9 +29,9 @@ function inject (bot, options) {
     if (bot.supportFeature('dimensionIsAnInt')) {
       bot.game.dimension = dimensionNames[packet.dimension]
     } else if (bot.supportFeature('dimensionIsAString')) {
-      bot.game.dimension = packet.dimension
+      bot.game.dimension = packet.dimension.replace('minecraft:', '')
     } else if (bot.supportFeature('dimensionIsAWorld')) {
-      bot.game.dimension = packet.worldName
+      bot.game.dimension = packet.worldName.replace('minecraft:', '')
     } else {
       throw new Error('Unsupported dimension type in login packet')
     }
@@ -48,6 +48,9 @@ function inject (bot, options) {
         bot.game.height = height
       } else if (packet.dimension) { // respawn
         bot.game.dimension = packet.dimension.replace('minecraft:', '')
+        const { minY, height } = bot.registry.dimensionsByName[bot.game.dimension]
+        bot.game.minY = minY
+        bot.game.height = height
       }
     } else if (bot.supportFeature('dimensionDataIsAvailable')) { // 1.18
       const dimensionData = nbt.simplify(packet.dimension)
@@ -57,6 +60,7 @@ function inject (bot, options) {
       bot.game.minY = 0
       bot.game.height = 256
     }
+
     if (packet.difficulty) {
       bot.game.difficulty = difficultyNames[packet.difficulty]
     }

package/lib/plugins/health.js

@@ -1,6 +1,6 @@
 module.exports = inject
 
-function inject (bot) {
+function inject (bot, options) {
   bot.isAlive = true
 
   bot._client.on('respawn', (packet) => {
@@ -24,6 +24,7 @@ function inject (bot) {
         bot.isAlive = false
         bot.emit('death')
       }
+      if (!options.respawn) return
       bot._client.write('client_command', { payload: 0 })
     } else if (bot.health > 0 && !bot.isAlive) {
       bot.isAlive = true

package/lib/plugins/inventory.js

@@ -12,6 +12,8 @@ const DIG_CLICK_TIMEOUT = 500
 // This number is larger than the eat time of 1.61 seconds to account for latency and low tps.
 // The eat time comes from https://minecraft.fandom.com/wiki/Food#Usage
 const CONSUME_TIMEOUT = 2500
+// milliseconds to wait for the server to respond to a window click transaction
+const WINDOW_TIMEOUT = 5000
 
 const ALWAYS_CONSUMABLES = [
   'potion',
@@ -544,7 +546,10 @@ function inject (bot, { hideErrors }) {
       if (!window.transactionRequiresConfirmation(click)) {
         confirmTransaction(window.id, actionId, true)
       }
-      const [success] = await response
+      const [success] = await withTimeout(response, WINDOW_TIMEOUT)
+        .catch(() => {
+          throw new Error(`Server didn't respond to transaction for clicking on slot ${slot} on window with id ${window?.id}.`)
+        })
       if (!success) {
         throw new Error(`Server rejected transaction for clicking on slot ${slot}, on window with id ${window?.id}.`)
       }

package/lib/plugins/physics.js

@@ -235,6 +235,10 @@ function inject (bot, { physicsEnabled }) {
     const yawChange = Math.round((yaw - bot.entity.yaw) / sensitivity) * sensitivity
     const pitchChange = Math.round((pitch - bot.entity.pitch) / sensitivity) * sensitivity
 
+    if (yawChange === 0 && pitchChange === 0) {
+      return
+    }
+
     bot.entity.yaw += yawChange
     bot.entity.pitch += pitchChange
 

package/lib/plugins/place_block.js

@@ -13,8 +13,12 @@ function inject (bot) {
       [oldBlock, newBlock] = await onceWithCleanup(bot, `blockUpdate:${dest}`, { timeout: 5000 })
     }
 
-    if (oldBlock.type === newBlock.type) {
-      throw new Error(`No block has been placed : the block is still ${oldBlock.name}`)
+    // blockUpdate emits (null, null) when the world unloads
+    if (!oldBlock && !newBlock) {
+      return
+    }
+    if (oldBlock?.type === newBlock.type) {
+      throw new Error(`No block has been placed : the block is still ${oldBlock?.name}`)
     } else {
       bot.emit('blockPlaced', oldBlock, newBlock)
     }

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mineflayer",
-  "version": "4.8.0",
+  "version": "4.9.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.26.0",
-    "minecraft-protocol": "^1.40.3",
+    "minecraft-protocol": "^1.42.0",
     "prismarine-biome": "^1.1.1",
     "prismarine-block": "^1.13.1",
     "prismarine-chat": "^1.7.1",
@@ -40,13 +40,13 @@
     "vec3": "^0.1.7"
   },
   "devDependencies": {
-    "@types/node": "^18.0.6",
+    "@types/node": "^20.2.1",
     "doctoc": "^2.0.1",
     "minecraft-wrap": "^1.3.0",
     "mineflayer": "file:.",
     "mocha": "^10.0.0",
     "standard": "^17.0.0",
     "standard-markdown": "^7.1.0",
-    "typescript": "^4.4.3"
+    "typescript": "^5.0.3"
   }
 }

package/docs/CNAME

@@ -1 +0,0 @@
-mineflayer.prismarine.js.org