mineflayer 4.29.0 → 4.31.0

package/docs/api.md

@@ -764,11 +764,11 @@ Determines what color the boss bar color is, one of `pink`, `blue`, `red`, `gree
 
 #### Particle.id
 
-Particle ID, as defined in the [protocol](https://wiki.vg/Protocol#Particle)
+Particle ID, as defined in the [protocol](https://minecraft.wiki/w/Protocol#Particle)
 
 #### Particle.name
 
-Particle Name, as defined in the [protocol](https://wiki.vg/Protocol#Particle)
+Particle Name, as defined in the [protocol](https://minecraft.wiki/w/Protocol#Particle)
 
 #### Particle.position
 
@@ -1139,7 +1139,7 @@ All scoreboards known to the bot in an object scoreboard displaySlot -> scoreboa
  * `belowName` - scoreboard placed in belowName
  * `sidebar` - scoreboard placed in sidebar
  * `list` - scoreboard placed in list
- * `0-18` - slots defined in [protocol](https://wiki.vg/Protocol#Display_Scoreboard)
+ * `0-18` - slots defined in [protocol](https://minecraft.wiki/w/Protocol#Display_Scoreboard)
 
 #### bot.teams
 
@@ -2158,7 +2158,7 @@ mode support:
     - drag clicks (5)
     - double clicks (6)
 
-Click on the current window. See details at https://wiki.vg/Protocol#Click_Container
+Click on the current window. See details at https://minecraft.wiki/w/Protocol#Click_Container
 
 Prefer using bot.simpleClick.*
 

package/docs/br/api_br.md

@@ -1920,7 +1920,7 @@ Esses são métodos de nível mais baixo para o inventário e podem ser úteis e
 
 Esta função também retorna uma `Promise`, com `void` como argumento quando concluída.
 
-Clique na janela/interface atual; os detalhes estão em https://wiki.vg/Protocol#Click_Window
+Clique na janela/interface atual; os detalhes estão em https://minecraft.wiki/w/Protocol#Click_Window
  * slot - número que representa a posição na janela
  * mouseButton - 0 para clique esquerdo e 1 para clique direito
  * mode - mineflayer só tem o modo 0 disponível

package/docs/es/api_es.md

@@ -993,7 +993,7 @@ Todos los scoreboards que el bot conoce en un object de forma casilla de visuali
  * `belowName` - scoreboard que está debajo del nombre
  * `sidebar` - scoreboard que está en la barra del lado
  * `list` - scoreboard que está en la lista
- * `0-18` - casillas definidas en el [protocol](https://wiki.vg/Protocol#Display_Scoreboard)
+ * `0-18` - casillas definidas en el [protocol](https://minecraft.wiki/w/Protocol#Display_Scoreboard)
 
 #### bot.controlState
 
@@ -1931,7 +1931,7 @@ Estos son métodos de un nivel más bajo para el inventario, pueden ser útils a
 
 Esta función también devueve un `Promise`, con `void` como argumento al finalizar.
 
-Hacer click en la ventana/interfaz actual, los detalles están en https://wiki.vg/Protocol#Click_Window
+Hacer click en la ventana/interfaz actual, los detalles están en https://minecraft.wiki/w/Protocol#Click_Window
  * slot - número que representa la casilla de la ventan
  * mouseButton - 0 para click izquierdo, y 1 para click derecho
  * mode - mineflayer solo tiene disponible el modo 0

package/docs/history.md

@@ -1,3 +1,11 @@
+## 4.31.0
+* [Cursor 1 21 5 (#3701)](https://github.com/PrismarineJS/mineflayer/commit/8770129d26a85f9b077d2a8969d45436fa09c3f3) (thanks @rom1504)
+
+## 4.30.0
+* [Update player_info handling (#3689)](https://github.com/PrismarineJS/mineflayer/commit/3f2fd6d393bc39167410df5a292759c93c9b249f) (thanks @extremeheat)
+* [Bump @types/node from 22.15.33 to 24.0.6 (#3686)](https://github.com/PrismarineJS/mineflayer/commit/12e50a2e2d0a921d075ebae8aa835437672a2b29) (thanks @dependabot[bot])
+* [Replace wiki.vg by minecraft.wiki. Close #3596](https://github.com/PrismarineJS/mineflayer/commit/c2794e43da71b346278818ff68acb690ec66a4fb) (thanks @rom1504)
+
 ## 4.29.0
 * [Sound test (#3657)](https://github.com/PrismarineJS/mineflayer/commit/51495665bbc3789ddc4284403c1ef288fea18ddc) (thanks @rom1504)
 * [Add boss bar test (#3655)](https://github.com/PrismarineJS/mineflayer/commit/b6950e9c42324c0f6fba6f2f802d0c87973a8c92) (thanks @rom1504)

package/docs/ru/api_ru.md

@@ -773,11 +773,11 @@ UUID существа, который определяется боссом.
 
 #### Particle.id
 
-Идентификатор частицы, который прописан в [протоколе](https://wiki.vg/Protocol#Particle).
+Идентификатор частицы, который прописан в [протоколе](https://minecraft.wiki/w/Protocol#Particle).
 
 #### Particle.name
 
-Название частицы, которое прописано в [протоколе](https://wiki.vg/Protocol#Particle).
+Название частицы, которое прописано в [протоколе](https://minecraft.wiki/w/Protocol#Particle).
 
 #### Particle.position
 
@@ -1170,7 +1170,7 @@ UUID существа, который определяется боссом.
  * `belowName` - Cкорборд размещен снизу никнейма.
  * `sidebar` - Cкорборд размещен на боковой панели.
  * `list` - Cкорборд помещен в список игроков.
- * `0-18` - Cлоты, определённые в [протоколе](https://wiki.vg/Protocol#Display_Scoreboard).
+ * `0-18` - Cлоты, определённые в [протоколе](https://minecraft.wiki/w/Protocol#Display_Scoreboard).
 
 #### bot.teams
 
@@ -2120,7 +2120,7 @@ bot.once('login', () => {
 
 Единственное действительное значение для `mode` - 0. Нажатие с шифтом или перемещение через мышь не реализовано.
 
-Нажимает на текущее окно. Подробнее - https://wiki.vg/Protocol#Click_Container
+Нажимает на текущее окно. Подробнее - https://minecraft.wiki/w/Protocol#Click_Container
 
 Рекомендуется использовать `bot.simpleClick.*`
 

package/docs/update_to_1_21_5.md

@@ -0,0 +1,342 @@
+# Mineflayer 1.21.5 Support Plan
+
+## 🚩 Latest Progress (July 2025)
+
+- ✅ **Chunk loading/parsing is now fixed** in both `node_modules` and the local `prismarine-chunk` repo. The fix was applied to `PaletteChunkSection.js` and `BitArrayNoSpan.js`.
+- 🔗 **Local development uses `npm link` to the local prismarine-chunk repo** for immediate testing of fixes.
+- 🛠️ **BitArrayNoSpan.js** now validates the buffer size and logs a warning if it is invalid (e.g., Infinity), preventing crashes.
+- 🤖 **The bot can now spawn and interact with the world** in 1.21.5. Chunk parsing errors are resolved.
+- ✅ **12 tests pass** for 1.21.5, confirming core protocol and chunk logic is working.
+- ❌ **4 tests fail**, but these are due to higher-level Mineflayer/game logic (timeouts, creative set slot, etc.), not chunk/protocol errors.
+- 🚧 **Current blockers:**
+  - Creative set slot protocol changes (UntrustedSlot)
+  - declare_commands packet parsing (PartialReadError)
+
+---
+
+## Current Status
+
+As of July 2025, Mineflayer has partial 1.21.5 support with several critical issues remaining. The version is already listed in `testedVersions` but tests are failing due to protocol changes in 1.21.5.
+
+## Key Issues Identified
+
+Based on the analysis of pull requests and issues, the main problems for 1.21.5 support are:
+
+### 1. Chunk Protocol Changes (✅ FIXED)
+- **Issue**: Network has small changes to chunk format where size is now auto-computed to save a byte
+- **Status**: **RESOLVED** - Fixed size computation formula in prismarine-chunk
+- **Fix Applied**: Changed from `Math.ceil(constants.BLOCK_SECTION_VOLUME * bitsPerValue / 64)` to `Math.ceil(constants.BLOCK_SECTION_VOLUME / Math.floor(64 / bitsPerValue))`
+- **Impact**: Chunk loading now works correctly for 1.21.5
+- **Files Modified**: 
+  - `prismarine-chunk/src/pc/common/PaletteContainer.js` (both DirectPaletteContainer and IndirectPaletteContainer)
+- **Dependencies**: Updated package.json to point to fixed prismarine-chunk branch
+
+### 2. Creative Set Slot Packet Behavior
+- **Issue**: Creative set slot packet behavior is the main breaking change (not working right now)
+- **Status**: Critical issue affecting creative mode functionality
+- **Impact**: `bot.creative.setInventorySlot()` fails
+- **Location**: `lib/plugins/creative.js`
+
+### 3. Item Format Changes
+- **Issue**: New concepts of hashed items and unsecure items (related to components)
+- **Status**: Protocol changes need investigation
+- **Impact**: Item handling and inventory management
+- **Dependencies**: minecraft-data and minecraft-protocol updates needed
+
+### 4. Entity Metadata Changes
+- **Issue**: Entity metadata may have changed
+- **Status**: Could cause issues with various listeners in mineflayer
+- **Impact**: Entity tracking and interaction
+- **Location**: `lib/plugins/entities.js`
+
+## Detailed Action Plan
+
+### Phase 1: Dependency Updates and Investigation
+
+#### 1.1 Investigate Chunk Protocol Issues
+- **Task**: Manually dump and decode chunk packets to understand the new format
+- **Tools**: Use packet analyzers or debug tools
+- **Expected Outcome**: Identify exact changes in chunk size computation
+- **Files to Modify**: `lib/plugins/blocks.js` (chunk handling)
+
+#### 1.2 Analyze Creative Set Slot Issues
+- **Task**: Debug creative set slot packet failures
+- **Method**: Compare packet structure between 1.21.4 and 1.21.5
+- **Files to Modify**: `lib/plugins/creative.js`
+- **Test**: `test/externalTests/creative.js`
+
+### Phase 2: Protocol Implementation
+
+#### 2.1 Fix Chunk Loading
+```javascript
+// In lib/plugins/blocks.js
+// Update chunk loading logic to handle auto-computed size
+bot._client.on('map_chunk', (packet) => {
+  // Handle new chunk format with auto-computed size
+  // May need to adjust data parsing based on new format
+})
+```
+
+#### 2.2 Fix Creative Set Slot
+```javascript
+// In lib/plugins/creative.js
+// Update setInventorySlot to handle new packet format
+async function setInventorySlot (slot, item, waitTimeout = 400) {
+  // Investigate and fix packet structure changes
+  // May need new packet format or different handling
+}
+```
+
+#### 2.3 Update Item Handling
+```javascript
+// In lib/plugins/inventory.js
+// Handle new hashed items and unsecure items concepts
+// Update Item.fromNotch and Item.toNotch methods
+```
+
+#### 2.4 Fix Entity Metadata
+```javascript
+// In lib/plugins/entities.js
+// Update entity metadata parsing for 1.21.5 changes
+bot._client.on('entity_metadata', (packet) => {
+  // Handle new metadata format
+})
+```
+
+### Phase 3: Testing and Validation
+
+#### 3.1 Create 1.21.5 Specific Tests
+```javascript
+// Add to test/externalTests/
+// Create tests that specifically validate 1.21.5 functionality
+```
+
+#### 3.2 Update Existing Tests
+- **Task**: Fix failing tests for 1.21.5
+- **Focus**: Creative mode, chunk loading, entity handling
+- **Method**: Run `npm run mocha_test -- -g "mineflayer_external 1.21.5v"`
+
+#### 3.3 Manual Testing
+- **Task**: Test core functionality manually
+- **Areas**: World loading, inventory management, entity interaction
+- **Tools**: Use examples in `examples/` directory
+
+### Phase 4: Documentation and Cleanup
+
+#### 4.1 Update Documentation
+- **Task**: Update README and API docs for 1.21.5
+- **Files**: `docs/README.md`, `docs/api.md`
+- **Content**: Document any new features or breaking changes
+
+#### 4.2 Update Version Support
+- **Task**: Ensure 1.21.5 is properly listed as supported
+- **Files**: `lib/version.js`, `package.json`
+
+## Analysis of Current Fix Status
+
+### ✅ **Good News: Fix Already Implemented**
+The [prismarine-chunk PR #289](https://github.com/PrismarineJS/prismarine-chunk/pull/289/files) has already implemented the 1.21.5 chunk protocol fix:
+
+**Key Changes in PR #289:**
+1. **Added `noSizePrefix` detection**: Uses `mcData.version['>=']('1.21.5')` to detect 1.21.5+
+2. **Modified chunk reading**: All palette containers now handle the `noSizePrefix` option
+3. **Dynamic size computation**: When `noSizePrefix` is true, size is computed as `Math.ceil(constants.BLOCK_SECTION_VOLUME * bitsPerValue / 64)`
+
+### 🔍 **Current Status Check**
+Mineflayer is already using the experimental branches:
+- `prismarine-chunk`: `extremeheat/prismarine-chunk#pc1.21.5` ✅
+- `minecraft-protocol`: `extremeheat/node-minecraft-protocol#pcp1.21.5` ✅
+
+### ✅ **Chunk Loading Issue RESOLVED**
+**FIXED**: The chunk loading issue has been resolved by correcting the size computation formula.
+
+**Root Cause Analysis:**
+1. ✅ **Fix is implemented**: `noSizePrefix` detection and logic is present in the code
+2. ✅ **Version detection works**: `mcData.version['>=']('1.21.5')` returns `true` correctly
+3. ✅ **Size computation fixed**: Changed from `Math.ceil(constants.BLOCK_SECTION_VOLUME * bitsPerValue / 64)` to `Math.ceil(constants.BLOCK_SECTION_VOLUME / Math.floor(64 / bitsPerValue))`
+4. ✅ **Buffer reading works**: No more "Target offset is beyond the bounds of the internal SmartBuffer data" errors
+
+**The Solution:**
+The issue was in the `readBuffer` method in `PaletteContainer.js`. The formula needed to calculate the number of longs based on the actual BitArray logic used in the constructor.
+
+## Current Test Status
+
+### ✅ **Chunk Loading Fixed**
+- **Status**: Chunk loading now works correctly for 1.21.5
+- **Evidence**: No more "Target offset is beyond the bounds of the internal SmartBuffer data" errors
+- **Next**: Focus on remaining test failures
+
+### 🚨 **New Test Failures Identified**
+After fixing chunk loading, new issues emerged:
+
+1. **Test Setup Timeout**: "Event message did not fire within timeout of 5000ms" in "before each" hook for "bed"
+2. **Server Shutdown Issues**: "Server shutdown took too long. Killing process."
+3. **Potential Protocol Changes**: Other 1.21.5 protocol changes may be affecting test functionality
+
+## Next Priority Issues
+
+### 1. **Investigate Test Setup Failures** (High Priority)
+- **Issue**: Tests are timing out during setup phase
+- **Location**: `test/externalTests/plugins/testCommon.js:127:21` - `clearInventory` function
+- **Possible Causes**: 
+  - Creative set slot packet changes
+  - Inventory protocol changes
+  - Entity metadata changes
+
+### 2. **Debug Creative Set Slot** (High Priority - PROTOCOL CHANGE IDENTIFIED)
+- **Issue**: Creative mode functionality broken due to protocol change
+- **Location**: `lib/plugins/creative.js`
+- **Test**: `test/externalTests/creative.js`
+- **Root Cause**: `set_creative_slot` packet changed from `Slot` to `UntrustedSlot` type
+- **Key Changes**:
+  - **1.21.4**: `packet_set_creative_slot.item` type: `Slot`
+  - **1.21.5**: `packet_set_creative_slot.item` type: `UntrustedSlot`
+  - `UntrustedSlot` has `present` boolean field first
+  - Uses `UntrustedSlotComponent` instead of `SlotComponent`
+  - New component system with `addedComponentCount` and `removedComponentCount`
+- **Files to Modify**: `lib/plugins/creative.js` (creative set slot handling)
+
+### 3. **Check Item Format Changes** (Medium Priority - PROTOCOL CHANGES IDENTIFIED)
+- **Issue**: New hashed items and unsecure items concepts
+- **Location**: `lib/plugins/inventory.js`
+- **Impact**: Item handling and inventory management
+- **Protocol Changes Found**:
+  - **New `vec3i` type**: Added for 3D integer vectors
+  - **Item component system**: New component-based item system
+  - **Component reordering**: Item component IDs have been reordered (e.g., `hide_additional_tooltip` → `tooltip_display`)
+  - **New components**: Added `blocks_attacks`, `weapon` components
+  - **Entity metadata**: `item_stack` type still uses `Slot` but may have component changes
+
+### 4. **Entity Metadata Changes** (Medium Priority - MINIMAL CHANGES)
+- **Issue**: Entity metadata format changes
+- **Location**: `lib/plugins/entities.js`
+- **Impact**: Entity tracking and interaction
+- **Protocol Analysis**: 
+  - **Good news**: `entity_metadata` packet structure unchanged
+  - **Good news**: `item_stack` type in metadata still uses `Slot` (not `UntrustedSlot`)
+  - **Minimal impact**: Entity metadata changes appear to be minimal for 1.21.5
+
+## Protocol Analysis Summary
+
+Based on the [minecraft-data PR #1029](https://github.com/PrismarineJS/minecraft-data/pull/1029/files) analysis, here are the key protocol changes for 1.21.5:
+
+### 🔥 **Critical Changes (Blocking Issues)**
+
+1. **Creative Set Slot Packet**:
+   - **Change**: `packet_set_creative_slot.item` type changed from `Slot` to `UntrustedSlot`
+   - **Impact**: Creative mode inventory management completely broken
+   - **Fix Required**: Update `lib/plugins/creative.js` to handle `UntrustedSlot` format
+
+2. **New Packet Types**:
+   - **Added**: `set_test_block` (0x39) and `test_instance_block_action` (0x3c)
+   - **Impact**: May affect block interaction tests
+
+### 📦 **Item System Changes**
+
+1. **Component System**:
+   - **New**: `UntrustedSlot` with component-based system
+   - **Components**: `addedComponentCount`, `removedComponentCount`, `UntrustedSlotComponent`
+   - **Impact**: Item serialization/deserialization needs updates
+
+2. **Component Reordering**:
+   - **Changed**: Component IDs reordered (e.g., `hide_additional_tooltip` → `tooltip_display`)
+   - **Added**: New components like `blocks_attacks`, `weapon`
+
+### 🎯 **Minimal Impact Changes**
+
+1. **Entity Metadata**: 
+   - **Status**: Unchanged - still uses `Slot` for `item_stack`
+   - **Impact**: Minimal - no changes needed
+
+2. **New Types**:
+   - **Added**: `vec3i` type for 3D integer vectors
+   - **Impact**: May be used in new packets but not critical
+
+## Implementation Steps
+```bash
+cd /media/documents/Documents/programmation/interlangage/minecraft/mineflayer
+npm install
+```
+
+### Step 2: Run Current Tests
+```bash
+# Test current 1.21.5 status
+npm run mocha_test -- -g "mineflayer_external 1.21.5v"
+```
+
+### Step 3: Investigate Specific Issues
+```bash
+# Debug chunk loading
+DEBUG="minecraft-protocol" npm run mocha_test -- -g "mineflayer_external 1.21.5v.*blocks"
+
+# Debug creative mode
+npm run mocha_test -- -g "mineflayer_external 1.21.5v.*creative"
+```
+
+### Step 4: Implement Fixes
+1. Start with chunk protocol fixes
+2. Fix creative set slot issues
+3. Update item handling
+4. Fix entity metadata
+
+### Step 5: Validate Fixes
+```bash
+# Run all 1.21.5 tests
+npm run mocha_test -- -g "mineflayer_external 1.21.5v"
+
+# Run specific functionality tests
+npm run mocha_test -- -g "mineflayer_external 1.21.5v.*inventory"
+npm run mocha_test -- -g "mineflayer_external 1.21.5v.*entities"
+```
+
+## Success Criteria
+
+1. All 1.21.5 tests pass
+2. Core functionality works (world loading, inventory, entities)
+3. Creative mode functions properly
+4. No regressions in other versions
+5. Documentation is updated
+
+## Risk Mitigation
+
+1. **Backward Compatibility**: Ensure fixes don't break older versions
+2. **Incremental Testing**: Test each fix individually
+3. **Fallback Mechanisms**: Implement fallbacks for protocol changes
+4. **Version Detection**: Use `bot.supportFeature()` for version-specific code
+
+## Resources Needed
+
+1. **Minecraft 1.21.5 Server**: For testing
+2. **Packet Analyzer**: For debugging protocol changes
+3. **Documentation**: Minecraft 1.21.5 protocol changes
+4. **Time**: 1-2 weeks of focused development
+
+## Contributing Guidelines
+
+For anyone wanting to contribute to 1.21.5 support:
+
+1. **Read the Documentation**: `docs/llm_contribute.md` and `docs/README.md`
+2. **Understand the Test System**: `test/externalTests/`
+3. **Focus on One Issue**: Pick one specific problem to solve
+4. **Test Thoroughly**: Run tests for multiple versions
+5. **Document Changes**: Update relevant documentation
+
+## Updated Timeline
+
+- **Phase 1**: ✅ COMPLETED (chunk protocol fix)
+- **Phase 2**: 2-3 days (investigate and fix test setup failures)
+- **Phase 3**: 2-3 days (fix creative set slot and other protocol issues)
+- **Phase 4**: 1-2 days (testing and validation)
+- **Phase 5**: 1 day (documentation and cleanup)
+
+**Total Estimated Time**: 6-9 days remaining
+
+**Note**: Chunk loading is now fixed! Focus is on remaining protocol changes and test failures.
+
+## References
+
+- [PrismarineJS/prismarine-chunk#289](https://github.com/PrismarineJS/prismarine-chunk/pull/289)
+- [PrismarineJS/mineflayer#3691](https://github.com/PrismarineJS/mineflayer/pull/3691)
+- [PrismarineJS/mineflayer#3641](https://github.com/PrismarineJS/mineflayer/issues/3641)
+- [PrismarineJS/minecraft-data#1029](https://github.com/PrismarineJS/minecraft-data/pull/1029)
+- [PrismarineJS/node-minecraft-protocol#1408](https://github.com/PrismarineJS/node-minecraft-protocol/pull/1408) 

package/docs/zh/api.md

@@ -737,8 +737,8 @@ Determines what color the boss bar color is,  `pink`, `blue`, `red`, `green`, `y
  * port : 端口，默认为 25565
  * password : 可以省略 (如果token也被省略，那么它将尝试以离线模式连接)
  * host : 默认为 localhost
- * version : 默认为自动猜测服务器的版本。值示例：“1.12.2”
- * auth : 默认为“mojang”，也可以是“microsoft”
+ * version : 默认为自动猜测服务器的版本。值示例："1.12.2"
+ * auth : 默认为"mojang"，也可以是"microsoft"
  * clientToken : 如果给定密码，则生成
  * accessToken : 如果给定密码，则生成
  * logErrors : 默认情况下为true，捕获错误并记录它们
@@ -1041,7 +1041,7 @@ All scoreboards known to the bot in an object scoreboard displaySlot -> scoreboa
  * `belowName` - scoreboard placed in belowName
  * `sidebar` - scoreboard placed in sidebar
  * `list` - scoreboard placed in list
- * `0-18` - slots defined in [protocol](https://wiki.vg/Protocol#Display_Scoreboard)
+ * `0-18` - slots defined in [protocol](https://minecraft.wiki/w/Protocol#Display_Scoreboard)
 
 #### bot.teams
 
@@ -2022,7 +2022,7 @@ These are lower level methods for the inventory, they can be useful sometimes bu
 
 This function also returns a `Promise`, with `void` as its argument upon completion.
 
-Click on the current window. See details at https://wiki.vg/Protocol#Click_Window
+Click on the current window. See details at https://minecraft.wiki/w/Protocol#Click_Window
 
 #### bot.putSelectedItemRange(start, end, window, slot)
 

package/lib/conversions.js

@@ -6,7 +6,7 @@ const PI_2 = Math.PI * 2
 const TO_RAD = PI / 180
 const TO_DEG = 1 / TO_RAD
 const FROM_NOTCH_BYTE = 360 / 256
-// From wiki.vg: Velocity is believed to be in units of 1/8000 of a block per server tick (50ms)
+// From minecraft.wiki: Velocity is believed to be in units of 1/8000 of a block per server tick (50ms)
 const FROM_NOTCH_VEL = 1 / 8000
 
 exports.toRadians = toRadians

package/lib/plugins/bed.js

@@ -146,9 +146,10 @@ function inject (bot) {
         }
       }
 
+      // We need to register the listener before actually going to sleep to avoid race conditions
+      const waitingPromise = waitUntilSleep()
       bot.activateBlock(bedBlock)
-
-      await waitUntilSleep()
+      await waitingPromise
     }
   }
 

package/lib/plugins/block_actions.js

@@ -103,7 +103,7 @@ function inject (bot) {
     const entity = bot.entities[packet.entityId]
 
     if (destroyStage < 0 || destroyStage > 9) {
-      // http://wiki.vg/Protocol#Block_Break_Progress
+      // http://minecraft.wiki/w/Protocol#Block_Break_Progress
       // "0-9 to set it, any other value to remove it"
       bot.emit('blockBreakProgressEnd', block, entity)
     } else {

package/lib/plugins/chat.js

@@ -118,7 +118,7 @@ function inject (bot, options) {
         target: data.targetName ? JSON.parse(data.targetName) : undefined,
         content: message ? JSON.parse(message) : { text: data.plainMessage }
       }
-      const registryIndex = data.type.registryIndex ? data.type.registryIndex : data.type
+      const registryIndex = data.type.chatType != null ? data.type.chatType : data.type
       msg = ChatMessage.fromNetwork(registryIndex, parameters)
 
       if (data.unsignedContent) {

package/lib/plugins/entities.js

@@ -232,6 +232,8 @@ function inject (bot) {
     bot.emit('entitySpawn', entity)
   })
 
+  // spawn_entity_experience_orb packet was removed in 1.21.5+
+  // XP orbs are now handled through the general spawn_entity packet
   bot._client.on('spawn_entity_experience_orb', (packet) => {
     const entity = fetchEntity(packet.entityId)
     entity.type = 'orb'
@@ -599,201 +601,139 @@ function inject (bot) {
     bot.emit('entitySpawn', bot.entity)
   })
 
-  bot._client.on('player_info', (packet) => {
-    // player list item(s)
+  function handlePlayerInfoBitfield (packet) {
+    for (const item of packet.data) {
+      let player = bot._playerFromUUID(item.uuid)
+      const newPlayer = !player
 
-    if (typeof packet.action !== 'number') {
-      // the features checks below this will be un-needed with https://github.com/PrismarineJS/minecraft-data/pull/948
-      for (const update of packet.data) {
-        let player = bot.uuidToUsername[update.uuid] ? bot.players[bot.uuidToUsername[update.uuid]] : null
-        let newPlayer = false
-
-        const obj = {
-          uuid: update.uuid
-        }
-
-        if (!player) newPlayer = true
-
-        player ||= obj
-
-        if (packet.action.add_player) {
-          obj.username = update.player.name
-          obj.displayName = player.displayName || new ChatMessage({ text: '', extra: [{ text: update.player.name }] })
-          obj.skinData = extractSkinInformation(update.player.properties)
-        }
-
-        if (packet.action.update_game_mode) {
-          obj.gamemode = update.gamemode
-        }
-
-        if (packet.action.update_latency) {
-          obj.ping = update.latency
-        }
+      if (newPlayer) {
+        player = { uuid: item.uuid }
+      }
 
-        if (update.displayName) {
-          obj.displayName = ChatMessage.fromNotch(update.displayName)
+      if (packet.action.add_player) {
+        player.username = item.player.name
+        player.displayName = new ChatMessage({ text: '', extra: [{ text: item.player.name }] })
+        player.skinData = extractSkinInformation(item.player.properties)
+      }
+      if (packet.action.initialize_chat && item.chatSession) {
+        player.chatSession = {
+          publicKey: item.chatSession.publicKey,
+          sessionUuid: item.chatSession.uuid
         }
+      }
+      if (packet.action.update_game_mode) {
+        player.gamemode = item.gamemode
+      }
+      if (packet.action.update_listed) {
+        player.listed = item.listed
+      }
+      if (packet.action.update_latency) {
+        player.ping = item.latency
+      }
+      if (packet.action.update_display_name) {
+        player.displayName = item.displayName ? ChatMessage.fromNotch(item.displayName) : new ChatMessage({ text: '', extra: [{ text: player.username }] })
+      }
 
-        if (newPlayer) {
-          if (!obj.username) continue // Should be unreachable
-          player = bot.players[obj.username] = obj
-          bot.uuidToUsername[obj.uuid] = obj.username
-        } else {
-          Object.assign(player, obj)
-        }
+      if (newPlayer) {
+        if (!player.username) continue // Should be unreachable if add_player is always sent for new players
+        bot.players[player.username] = player
+        bot.uuidToUsername[player.uuid] = player.username
+      }
 
-        const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === player.username)
-        player.entity = playerEntity
+      const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === player.username)
+      player.entity = playerEntity
 
-        if (playerEntity === bot.entity) {
-          bot.player = player
-        }
+      if (playerEntity === bot.entity) {
+        bot.player = player
+      }
 
-        if (newPlayer) {
-          bot.emit('playerJoined', player)
-        } else {
-          bot.emit('playerUpdated', player)
-        }
+      if (newPlayer) {
+        bot.emit('playerJoined', player)
+      } else {
+        bot.emit('playerUpdated', player)
       }
-      return
     }
+  }
 
-    if (bot.supportFeature('playerInfoActionIsBitfield')) {
-      for (const item of packet.data) {
-        let player = bot.uuidToUsername[item.uuid] ? bot.players[bot.uuidToUsername[item.uuid]] : null
-        let newPlayer = false
-
-        const obj = {
-          uuid: item.uuid
-        }
-
-        if (!player) newPlayer = true
-
-        player = player || obj
-
-        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) {
-          obj.gamemode = item.gamemode
-        }
-
-        if (packet.action & 16) {
-          obj.ping = item.latency
-        }
-
-        if (item.displayName) {
-          obj.displayName = ChatMessage.fromNotch(item.displayName)
-        } else if (packet.action & 32) obj.displayName = new ChatMessage({ text: '', extra: [{ text: player.username || obj.username }] })
-
-        if (newPlayer) {
-          if (!obj.username) continue // Should be unreachable
-          player = bot.players[obj.username] = obj
-          bot.uuidToUsername[obj.uuid] = obj.username
-        } else {
-          Object.assign(player, obj)
-        }
-
-        const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === player.username)
-        player.entity = playerEntity
-
-        if (playerEntity === bot.entity) {
-          bot.player = player
-        }
-
-        if (newPlayer) {
-          bot.emit('playerJoined', player)
-        } else {
-          bot.emit('playerUpdated', player)
-        }
-      }
-    } else {
-      for (const item of packet.data) {
-        let player = bot.uuidToUsername[item.UUID] ? bot.players[bot.uuidToUsername[item.UUID]] : null
-        if (packet.action === 0) {
-          let newPlayer = false
+  function handlePlayerInfoLegacy (packet) {
+    for (const item of packet.data) {
+      let player = bot._playerFromUUID(item.uuid)
 
-          // New Player
-          if (!player) {
+      switch (packet.action) {
+        case 'add_player': {
+          const newPlayer = !player
+          if (newPlayer) {
             player = bot.players[item.name] = {
               username: item.name,
-              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
-                    signature: item.crypto.signature // Signature
-                  }
-                : null
+              uuid: item.uuid
             }
+            bot.uuidToUsername[item.uuid] = item.name
+          }
 
-            bot.uuidToUsername[item.UUID] = item.name
-            bot.emit('playerJoined', player)
-            newPlayer = true
-          } else {
-            // Just an Update
-            player.gamemode = item.gamemode
-            player.ping = item.ping
+          player.ping = item.ping
+          player.gamemode = item.gamemode
+          player.displayName = item.displayName ? ChatMessage.fromNotch(item.displayName) : new ChatMessage({ text: '', extra: [{ text: item.name }] })
+          if (item.properties) {
             player.skinData = extractSkinInformation(item.properties)
-            if (item.crypto) {
-              player.profileKeys = {
-                publicKey: item.crypto.publicKey,
-                signature: item.crypto.signature
-              }
-            }
           }
-
-          if (item.displayName) {
-            player.displayName = ChatMessage.fromNotch(item.displayName)
+          if (item.crypto) {
+            player.profileKeys = {
+              publicKey: item.crypto.publicKey,
+              signature: item.crypto.signature
+            }
           }
 
           const playerEntity = Object.values(bot.entities).find(e => e.type === 'player' && e.username === item.name)
           player.entity = playerEntity
-
           if (playerEntity === bot.entity) {
             bot.player = player
           }
 
-          if (!newPlayer) {
+          if (newPlayer) bot.emit('playerJoined', player)
+          else bot.emit('playerUpdated', player)
+          break
+        }
+        case 'update_gamemode': {
+          if (player) {
+            player.gamemode = item.gamemode
             bot.emit('playerUpdated', player)
           }
-        } else if (player) {
-          if (packet.action === 1) {
-            player.gamemode = item.gamemode
-          } else if (packet.action === 2) {
+          break
+        }
+        case 'update_latency': {
+          if (player) {
             player.ping = item.ping
-          } else if (packet.action === 3 && !item.displayName) {
-            player.displayName = new ChatMessage({ text: '', extra: [{ text: player.username }] })
-          } else if (packet.action === 3 && item.displayName) {
-            player.displayName = ChatMessage.fromNotch(item.displayName)
-          } else if (packet.action === 4) {
+            bot.emit('playerUpdated', player)
+          }
+          break
+        }
+        case 'update_display_name': {
+          if (player) {
+            player.displayName = item.displayName ? ChatMessage.fromNotch(item.displayName) : new ChatMessage({ text: '', extra: [{ text: player.username }] })
+            bot.emit('playerUpdated', player)
+          }
+          break
+        }
+        case 'remove_player': {
+          if (player) {
             if (player.entity === bot.entity) continue
-
             player.entity = null
             delete bot.players[player.username]
-            delete bot.uuidToUsername[item.UUID]
+            delete bot.uuidToUsername[item.uuid]
             bot.emit('playerLeft', player)
-            continue
-          } else {
-            continue
           }
-
-          bot.emit('playerUpdated', player)
+          break
         }
       }
     }
-  })
+  }
 
-  // (1.19.3) player(s) leave the game
+  bot._client.on('player_info', bot.supportFeature('playerInfoActionIsBitfield') ? handlePlayerInfoBitfield : handlePlayerInfoLegacy)
+
+  // 1.19.3+ - player(s) leave the game
   bot._client.on('player_remove', (packet) => {
     for (const uuid of packet.players) {
-      const player = bot.uuidToUsername[uuid] ? bot.players[bot.uuidToUsername[uuid]] : null
-
+      const player = bot._playerFromUUID(uuid)
       if (!player || player.entity === bot.entity) continue
 
       player.entity = null

package/lib/plugins/physics.js

@@ -354,38 +354,36 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
     // e.g. when crouching/crawling/swimming. Can someone confirm?
     bot.entity.height = 1.8
 
-    // Velocity is reset if the x, y, z flags are not set
     const vel = bot.entity.velocity
-    // If the x, y, z flags are not set, the position is absolute
     const pos = bot.entity.position
-
-    // TODO: this current mineflayer logic maybe incorrect. New (maybe even older) versions of minecraft have flag values for
-    // dx/dy/dz but mineflayer is assuming that 0b111 applies for both velocity and position.
-
     let newYaw, newPitch
 
-    if (bot.registry.version['>=']('1.21.3')) {
-      // flags is now an object with keys
-      // "flags": ["x", "y", "z", "yaw", "pitch", "dx", "dy", "dz", "yawDelta"]
-      const flags = packet.flags
+    // Note: 1.20.5+ uses a bitflags object, older versions use a bitmask number
+    if (typeof packet.flags === 'object') {
+      // Modern path with bitflags object
+      // Velocity is only set to 0 if the flag is not set, otherwise keep current velocity
       vel.set(
-        flags.x ? vel.x : 0,
-        flags.y ? vel.y : 0,
-        flags.z ? vel.z : 0
+        packet.flags.x ? vel.x : 0,
+        packet.flags.y ? vel.y : 0,
+        packet.flags.z ? vel.z : 0
       )
+      // If flag is set, then the corresponding value is relative, else it is absolute
       pos.set(
-        flags.x ? (pos.x + packet.x) : packet.x,
-        flags.y ? (pos.y + packet.y) : packet.y,
-        flags.z ? (pos.z + packet.z) : packet.z
+        packet.flags.x ? (pos.x + packet.x) : packet.x,
+        packet.flags.y ? (pos.y + packet.y) : packet.y,
+        packet.flags.z ? (pos.z + packet.z) : packet.z
       )
-      newYaw = (flags.yaw ? conv.toNotchianYaw(bot.entity.yaw) : 0) + packet.yaw
-      newPitch = (flags.pitch ? conv.toNotchianPitch(bot.entity.pitch) : 0) + packet.pitch
+      newYaw = (packet.flags.yaw ? conv.toNotchianYaw(bot.entity.yaw) : 0) + packet.yaw
+      newPitch = (packet.flags.pitch ? conv.toNotchianPitch(bot.entity.pitch) : 0) + packet.pitch
     } else {
+      // Legacy path with bitmask number
+      // Velocity is only set to 0 if the flag is not set, otherwise keep current velocity
       vel.set(
         packet.flags & 1 ? vel.x : 0,
         packet.flags & 2 ? vel.y : 0,
         packet.flags & 4 ? vel.z : 0
       )
+      // If flag is set, then the corresponding value is relative, else it is absolute
       pos.set(
         packet.flags & 1 ? (pos.x + packet.x) : packet.x,
         packet.flags & 2 ? (pos.y + packet.y) : packet.y,

package/lib/plugins/ray_trace.js

@@ -11,7 +11,6 @@ module.exports = (bot) => {
   }
 
   bot.blockInSight = (maxSteps = 256, vectorLength = 5 / 16) => {
-    console.warn('[deprecated] use bot.blockAtCursor instead')
     const block = bot.blockAtCursor(maxSteps * vectorLength)
     if (block) return block
   }

package/lib/plugins/sound.js

@@ -3,8 +3,6 @@ const { Vec3 } = require('vec3')
 module.exports = inject
 
 function inject (bot) {
-  const mcData = require('minecraft-data')(bot.version)
-
   bot._client.on('named_sound_effect', (packet) => {
     const soundName = packet.soundName
     const pt = new Vec3(packet.x / 8, packet.y / 8, packet.z / 8)
@@ -24,20 +22,27 @@ function inject (bot) {
   })
 
   bot._client.on('sound_effect', (packet) => {
-    const soundId = packet.soundId
     const soundCategory = packet.soundCategory
     const pt = new Vec3(packet.x / 8, packet.y / 8, packet.z / 8)
     const volume = packet.volume
     const pitch = packet.pitch
 
-    // Try to resolve sound name from mcData
-    let soundName = soundId
-    if (mcData.sounds && mcData.sounds[soundId]) {
-      soundName = mcData.sounds[soundId].name
+    let soundId, soundName
+
+    if (packet.sound) { // ItemSoundHolder
+      if (packet.sound.data) soundName = packet.sound.data.soundName
+      else soundId = packet.sound.soundId // Sound specified by ID (registry reference)
+    } else { // Legacy packet
+      soundId = packet.soundId
     }
 
-    // Emit both events for compatibility
-    bot.emit('hardcodedSoundEffectHeard', soundId, soundCategory, pt, volume, pitch)
-    bot.emit('soundEffectHeard', soundName, pt, volume, pitch)
+    // If we have an ID but no name yet, try to look it up in the registry
+    soundName ??= bot.registry?.sounds?.[soundId]?.name
+
+    if (soundName) {
+      bot.emit('soundEffectHeard', soundName, pt, volume, pitch)
+    } else if (soundId !== null) {
+      bot.emit('hardcodedSoundEffectHeard', soundId, soundCategory, pt, volume, pitch)
+    }
   })
 }

package/lib/version.js

@@ -1,4 +1,4 @@
-const testedVersions = ['1.8.8', '1.9.4', '1.10.2', '1.11.2', '1.12.2', '1.13.2', '1.14.4', '1.15.2', '1.16.5', '1.17.1', '1.18.2', '1.19', '1.19.2', '1.19.3', '1.19.4', '1.20.1', '1.20.2', '1.20.4', '1.20.6', '1.21.1', '1.21.3', '1.21.4']
+const testedVersions = ['1.8.8', '1.9.4', '1.10.2', '1.11.2', '1.12.2', '1.13.2', '1.14.4', '1.15.2', '1.16.5', '1.17.1', '1.18.2', '1.19', '1.19.2', '1.19.3', '1.19.4', '1.20.1', '1.20.2', '1.20.4', '1.20.6', '1.21.1', '1.21.3', '1.21.4', '1.21.5']
 module.exports = {
 
   testedVersions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mineflayer",
-  "version": "4.29.0",
+  "version": "4.31.0",
   "description": "create minecraft bots with a stable, high level API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -22,13 +22,13 @@
   "license": "MIT",
   "dependencies": {
     "minecraft-data": "^3.76.0",
-    "minecraft-protocol": "^1.51.0",
+    "minecraft-protocol": "^1.60.0",
     "prismarine-biome": "^1.1.1",
-    "prismarine-block": "^1.17.0",
+    "prismarine-block": "^1.22.0",
     "prismarine-chat": "^1.7.1",
-    "prismarine-chunk": "^1.36.0",
+    "prismarine-chunk": "^1.39.0",
     "prismarine-entity": "^2.5.0",
-    "prismarine-item": "^1.15.0",
+    "prismarine-item": "^1.17.0",
     "prismarine-nbt": "^2.0.0",
     "prismarine-physics": "^1.9.0",
     "prismarine-recipe": "^1.3.0",
@@ -40,7 +40,7 @@
     "vec3": "^0.1.7"
   },
   "devDependencies": {
-    "@types/node": "^22.1.0",
+    "@types/node": "^24.0.6",
     "doctoc": "^2.0.1",
     "minecraft-wrap": "^1.3.0",
     "mineflayer": "file:",