mineflayer 4.32.0 → 4.34.0

package/.github/helper/package.json

@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "gh-helpers": "^1.0.0"
+  }
+}

package/.github/helper/updator.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Updator script triggered from minecraft-data repository to auto generate PR
+ */
+const fs = require('fs')
+const cp = require('child_process')
+const assert = require('assert')
+const github = require('gh-helpers')()
+const { join } = require('path')
+const exec = (cmd) => github.mock ? console.log('> ', cmd) : (console.log('> ', cmd), cp.execSync(cmd, { stdio: 'inherit' }))
+
+console.log('Starting update process...')
+// Sanitize and validate environment variables all non alpha numeric / underscore / dot
+const newVersion = process.env.NEW_MC_VERSION?.replace(/[^a-zA-Z0-9_.]/g, '_')
+const triggerBranch = process.env.MCDATA_BRANCH?.replace(/[^a-zA-Z0-9_.]/g, '_')
+const mcdataPrURL = process.env.MCDATA_PR_URL
+console.log({ newVersion, triggerBranch, mcdataPrURL })
+
+assert(newVersion)
+assert(triggerBranch)
+
+async function main () {
+  const currentSupportedPath = require.resolve('../../lib/version.js')
+  const readmePath = join(__dirname, '../../docs/README.md')
+  const ciPath = join(__dirname, '../../.github/workflows/ci.yml')
+
+  // Update the version.js
+  const currentSupportedVersion = require('../../lib/version.js')
+  const currentContents = fs.readFileSync(currentSupportedPath, 'utf8')
+  console.log('Current supported version:', currentContents)
+  const latestV = currentSupportedVersion.testedVersions.at(-1)
+  const newContents = currentContents.includes(newVersion)
+    ? currentContents
+    : currentContents
+      .replace(`, '${latestV}'`, `, '${latestV}', '${newVersion}'`)
+
+  // Update the README.md
+  const currentContentsReadme = fs.readFileSync(readmePath, 'utf8')
+  if (!currentContentsReadme.includes(newVersion)) {
+    const newReadmeContents = currentContentsReadme
+      .replace(/Minecraft 1\.8 to [0-9A-Za-z._-]+ \(/, `Minecraft 1.8 to ${newVersion} (`)
+      .replace(') <!--version-->', `, ${newVersion}) <!--version-->`)
+    fs.writeFileSync(readmePath, newReadmeContents)
+    console.log('Updated README with new version:', newVersion)
+  }
+  fs.writeFileSync(currentSupportedPath, newContents)
+
+  // Update the CI workflow
+  const currentContentsCI = fs.readFileSync(ciPath, 'utf8')
+  if (!currentContentsCI.includes(newVersion)) {
+    const newCIContents = currentContentsCI.replace(
+      'run: npm install', `run: npm install
+      - run: cd node_modules && cd minecraft-data && mv minecraft-data minecraft-data-old && git clone -b ${triggerBranch} https://github.com/PrismarineJS/minecraft-data --depth 1 && node bin/generate_data.js
+      - run: curl -o node_modules/protodef/src/serializer.js https://raw.githubusercontent.com/extremeheat/node-protodef/refs/heads/dlog/src/serializer.js && curl -o node_modules/protodef/src/compiler.js https://raw.githubusercontent.com/extremeheat/node-protodef/refs/heads/dlog/src/compiler.js
+`)
+    fs.writeFileSync(ciPath, newCIContents)
+    console.log('Updated CI workflow with new version:', newVersion)
+  }
+
+  const branchName = 'pc' + newVersion.replace(/[^a-zA-Z0-9_]/g, '_')
+  exec(`git checkout -b ${branchName}`)
+  exec('git config user.name "github-actions[bot]"')
+  exec('git config user.email "41898282+github-actions[bot]@users.noreply.github.com"')
+  exec('git add --all')
+  exec(`git commit -m "Update to version ${newVersion}"`)
+  exec(`git push origin ${branchName} --force`)
+  //     createPullRequest(title: string, body: string, fromBranch: string, intoBranch?: string): Promise<{ number: number, url: string }>;
+  const pr = await github.createPullRequest(
+    `🎈 ${newVersion}`,
+    `This automated PR sets up the relevant boilerplate for Minecraft version ${newVersion}.
+
+Ref: ${mcdataPrURL}
+
+* You can help contribute to this PR by opening a PR against this <code branch>${branchName}</code> branch instead of <code>master</code>.
+    `,
+    branchName,
+    'master'
+  )
+  console.log(`Pull request created`, pr)
+}
+
+main().catch(err => {
+  console.error('Error during update process:', err)
+  process.exit(1)
+})

package/.github/workflows/handle-update.yml

@@ -0,0 +1,54 @@
+name: Update from minecraft-data
+
+on:
+  workflow_dispatch:
+    inputs:
+      new_mc_version:
+        description: New minecraft version number
+        required: true
+        type: string
+      mcdata_branch:
+        description: minecraft-data branch for this version
+        required: true
+        type: string
+      mcdata_pr_url:
+        description: minecraft-data PR number to open a PR here against
+        required: false
+        default: ''
+        type: string
+      nmp_branch:
+        description: minecraft-protocol branch for this version
+        required: true
+        type: string
+      nmp_pr_url:
+        description: minecraft-protocol PR number to open a PR here against
+        required: false
+        default: ''
+        type: string
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        token: ${{ secrets.PAT_PASSWORD }}
+
+    - name: Use Node.js 22.x
+      uses: actions/setup-node@v1.4.4
+      with:
+        node-version: 22.x
+
+    - run: npm install PrismarineJS/node-minecraft-protocol#${{ github.event.inputs.nmp_branch }}
+
+    - name: Run updator script
+      run: cd .github/helper && npm install && node updator.js
+      env:
+        GITHUB_TOKEN: ${{ secrets.PAT_PASSWORD }}
+        NEW_MC_VERSION: ${{ github.event.inputs.new_mc_version }}
+        MCDATA_BRANCH: ${{ github.event.inputs.mcdata_branch }}
+        MCDATA_PR_URL: ${{ github.event.inputs.mcdata_pr_url }}
+        NMP_BRANCH: ${{ github.event.inputs.nmp_branch }}
+        NMP_PR_URL: ${{ github.event.inputs.nmp_pr_url }}

package/README.md

@@ -17,7 +17,7 @@ First time using Node.js? You may want to start with the [tutorial](tutorial.md)
 
 ## Features
 
- * Supports Minecraft 1.8 to 1.21 (1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, and 1.21)
+ * Supports Minecraft 1.8 to 1.21.9 (1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.21.9) <!--version-->
  * Entity knowledge and tracking.
  * Block knowledge. You can query the world around you. Milliseconds to find any block.
  * Physics and movement - handle all bounding boxes

package/docs/README.md

@@ -17,7 +17,7 @@ First time using Node.js? You may want to start with the [tutorial](tutorial.md)
 
 ## Features
 
- * Supports Minecraft 1.8 to 1.21 (1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, and 1.21)
+ * Supports Minecraft 1.8 to 1.21.9 (1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.21.9) <!--version-->
  * Entity knowledge and tracking.
  * Block knowledge. You can query the world around you. Milliseconds to find any block.
  * Physics and movement - handle all bounding boxes

package/docs/history.md

@@ -1,3 +1,15 @@
+## 4.34.0
+* [🎈 1.21.9/1.21.10 support (#3754)](https://github.com/PrismarineJS/mineflayer/commit/f0afaf73061c15b67e5d3457b60ed543e711acb6) (thanks @rom1504bot)
+* [Update russian docs (#3762)](https://github.com/PrismarineJS/mineflayer/commit/887b52b933d943c8d605d7835d6d55d198208fee) (thanks @fungoza)
+* [Swap out deprecated bot.chatAddPattern() in tutorial.md (#3709)](https://github.com/PrismarineJS/mineflayer/commit/e5fcf1f022656c7432ef11b4e458ca9b2e08c1ee) (thanks @TheSharkyOfficial)
+* [Add missing uuid-1345 dep](https://github.com/PrismarineJS/mineflayer/commit/464000aa05fc44cc6da236fc370bce6911648a75) (thanks @extremeheat)
+* [Update README.md](https://github.com/PrismarineJS/mineflayer/commit/9d7ea28c3321170f9958f54dfe24cedf48f1113f) (thanks @extremeheat)
+* [Resolved type mismatch (#3748)](https://github.com/PrismarineJS/mineflayer/commit/266af6786edc78d17e7afad77a3e89fc7649e0e0) (thanks @BF5258)
+
+## 4.33.0
+* [Add update workflow (#3727)](https://github.com/PrismarineJS/mineflayer/commit/9c335366d435b58cfe45bbfbbc534b99ee669dc2) (thanks @extremeheat)
+* [Add support for Minecraft 1.21.8 (#3732)](https://github.com/PrismarineJS/mineflayer/commit/ec8220d7c63b72acb4bf16f30cdf4ba346b83f98) (thanks @rom1504)
+
 ## 4.32.0
 * [1.21.6 (#3713)](https://github.com/PrismarineJS/mineflayer/commit/01f537c394fc78bf2e765b28a8b24a30c1d1fd2e) (thanks @extremeheat)
 * [Fix knockback physics crash (#3715)](https://github.com/PrismarineJS/mineflayer/commit/e3f89d17418ece9e9fac4b111d8243dfe1a5d376) (thanks @Omena0)

package/docs/ru/CONTRIBUTING_RU.md

@@ -21,6 +21,20 @@ Mineflayer имеет 2 вида тестов :
  
 Цель этих тестов - автоматически определить, что работает, а что нет в mineflayer, чтобы было проще заставить mineflayer работать.
 
+## Запуск тестов
+Вы можете запустить тесты для разных версий Minecraft, используя флаг `-g` в npm run mocha_test. Например:
+
+```bash
+# Запуск всех тестов для всех поддерживаемых версий
+npm run test
+
+# Запуск определённого теста для Minecraft 1.20.4
+npm run mocha_test -- -g "mineflayer_external 1.20.4v.*exampleBee"
+
+# Запуск всех тестов только для версии 1.20.4
+npm run mocha_test -- -g "mineflayer_external 1.20.4v"
+```
+
 ### Создание внешних тестов
 
 Для внешних тестов вам просто нужно создать файл в [test/externalTests](../../test/externalTests)

package/docs/ru/FAQ_RU.md

@@ -2,6 +2,10 @@
 
 Это документ с часто задаваемыми вопросами, предназначен для помощи людям в самых распространенных вещах.
 
+### Выдаёт ошибку (например, protocol/data) когда бот пытается подключиться к серверу Minecraft.
+
+Убедитесь, что версия сервера Minecraft поддерживается (см. README), иначе попробуйте ещё раз, используя [тестовые версии mineflayer](../../lib/version.js).
+
 ### Выдаёт ошибку при попытке войти в систему через аккаунт Microsoft.
 
 Убедитесь, что адрес электронной почты, который вы ввели в поле username в createBot, можно использовать для входа на `minecraft.net` используя кнопку «Войти с помощью Microsoft».

package/docs/ru/README_RU.md

@@ -17,7 +17,7 @@
 
 ## Возможности
 
- * Поддержка 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19 и 1.20.
+ * Поддержка с Minecraft 1.8 до 1.21.8 (1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21.8)
  * Поддержка энтити и их отслеживание.
  * Вы можете полностью взаимодействовать с миром. Миллисекунды на поиск любого блока.
  * Физика и управление.
@@ -39,7 +39,10 @@
 
 `npm install mineflayer`
 
-Чтобы обновить пакет mineflayer (или любой Node.js) и его зависимости, используйте `npm update --depth 9999`
+Чтобы обновить пакет mineflayer (или любой Node.js) и его зависимости, используйте
+```bash
+npm update
+```
 
 ## Документация
 
@@ -97,6 +100,27 @@ bot.on('kicked', console.log)
 bot.on('error', console.log)
 ```
 
+Если в `auth` установлен `microsoft`, вам предложит войти в microsoft.com с кодом в вашем браузере. После входа через браузер 
+бот автоматически получит и сохранит в кэш токен аутентификации (для вашего ника), чтобы потом вам опять не пришлось входить.
+
+Чтобы сменить аккаунт, обновите `username`. По умолчанию кэшированые токены храняться в вашей папке .minecraft или в `profilesFolder`, если это указано.
+Для большей информации о настройках бота смотрите [API документацию](https://github.com/PrismarineJS/node-minecraft-protocol/blob/master/docs/API.md#mccreateclientoptions) по node-minecraft-protocol.
+
+#### Подключение к Realm
+
+Чтобы зайти в Realm, куда ваш аккаунт был приглашён, вы можете вписать объект `realms` с функцией, как показано ниже.
+
+```js
+const client = mineflayer.createBot({
+  username: 'email@example.com', // майнкрафт ник
+  realms: {
+    // Эта функция вызывается с массивом доступных для аккаунта Realm'ов. Оно должно возвращать то, куда оно хочет зайти.
+    pickRealm: (realms) => realms[0]
+  },
+  auth: 'microsoft'
+})
+```
+
 ### Смотрите, что делает бот
 
 Спасибо репозиторию [prismarine-viewer](https://github.com/PrismarineJS/prismarine-viewer), с помощью которого можно через браузер увидеть, что делает бот.
@@ -131,7 +155,13 @@ bot.once('spawn', () => {
 
 Большая часть разработки происходит внутри небольших пакетов npm, которые используются mineflayer.
 
-Модули, из которых состоит Mineflayer:
+#### The Node Way™
+
+> "Когда приложения сделаны правильно, они представляют собой лишь ту самую специфичную, "солоноватую" прослойку логики, которую нельзя так просто абстрагировать. Все изящные, переиспользуемые компоненты возносятся на github и npm, где все могут совместно работать на общее благо." — substack из ["как я пишу модули"](https://gist.github.com/substack/5075355)
+
+#### Модули
+
+Здесь основная часть пакетов, которые используются в mineflayer:
 
 | Модуль                                                                        | Описание                                                                                |
 | ----------------------------------------------------------------------------- |---------------------------------------------------------------------------------------- |
@@ -172,6 +202,7 @@ Mineflayer поддерживает сторонние плагины. Любо
 
 Наиболее обновлённые и полезные:
 
+ * [minecraft-mcp-server](https://github.com/yuniko-software/minecraft-mcp-server) Сервер MCP для mineflayer, позволяющий использовать mineflayer из LLM
  * [pathfinder](https://github.com/Karang/mineflayer-pathfinder) - Продвинутый A* поиск пути с множеством настраиваемых функций
  * [prismarine-viewer](https://github.com/PrismarineJS/prismarine-viewer) - Простой web клиент для просмотра чанков
  * [web-inventory](https://github.com/ImHarvol/mineflayer-web-inventory) - Веб клиент для взаимодействия с инвентарём
@@ -201,6 +232,7 @@ Mineflayer поддерживает сторонние плагины. Любо
 ## Проекты, созданные с помощью Mineflayer
 
  * [Voyager](https://github.com/MineDojo/Voyager) - Открытый агент с большими языковыми моделями
+ * [mindcraft](https://github.com/kolbytn/mindcraft) - Библиотека для использования mineflayer с LLM
  * [rom1504/rbot](https://github.com/rom1504/rbot)
    - [YouTube - постройка спиральной лестницы](https://www.youtube.com/watch?v=UM1ZV5200S0)
    - [YouTube - дублирование постройки](https://www.youtube.com/watch?v=0cQxg9uDnzA)
@@ -211,8 +243,9 @@ Mineflayer поддерживает сторонние плагины. Любо
  * [Cheese Bot](https://github.com/Minecheesecraft/Cheese-Bot) - Плагин с чистым GUI. Создан с помощью Node-Webkit. http://bot.ezcha.net/
  * [Chaoscraft](https://github.com/schematical/chaoscraft) - Бот Minecraft, использующий генетические алгоритмы, посмотрите [эти видео](https://www.youtube.com/playlist?list=PLLkpLgU9B5xJ7Qy4kOyBJl5J6zsDIMceH)
  * [hexatester/minetelegram](https://github.com/hexatester/minetelegram) - Мост между Minecraft и Telegram, созданный при помощи Mineflayer & Telegraf
-  * [PrismarineJS/mineflayer-builder](https://github.com/PrismarineJS/mineflayer-builder) - Строит схемы в режиме выживания, сохраняя направление
-  * [и многие другие](https://github.com/PrismarineJS/mineflayer/network/dependents) - Все проекты, обнаруженные GitHub, в которых используется Mineflayer
+ * [PrismarineJS/mineflayer-builder](https://github.com/PrismarineJS/mineflayer-builder) - Строит схемы в режиме выживания, сохраняя направление
+ * [SilkePilon/OpenDeliveryBot](https://github.com/SilkePilon/OpenDeliveryBot) - Minecraft бот на Python для переноса вещей с места на место.
+ * [и многие другие](https://github.com/PrismarineJS/mineflayer/network/dependents) - Все проекты, обнаруженные GitHub, в которых используется Mineflayer
 
 
 ## Тестирование

package/docs/ru/api_ru.md

@@ -170,6 +170,8 @@
       - ["game"](#game)
       - ["resourcePack" (url, hash)](#resourcepack-url-hash)
       - ["title" (title, type)](#title-title-type)
+      - ["title_times" (fadeIn, stay, fadeOut)](#title_times-fadein-stay-fadeout)
+      - ["title_clear"](#title_clear)
       - ["rain"](#rain)
       - ["weatherUpdate"](#weatherupdate)
       - ["time"](#time)
@@ -225,7 +227,7 @@
       - ["blockBreakProgressEnd" (block, entity)](#blockbreakprogressend-block-entity)
       - ["diggingCompleted" (block)](#diggingcompleted-block)
       - ["diggingAborted" (block)](#diggingaborted-block)
-      - ["usedFirework"](#usedfirework)
+      - ["usedFirework" (fireworkEntityId)](#usedfirework-fireworkentityid)
       - ["move"](#move)
       - ["forcedMove"](#forcedmove)
       - ["mount"](#mount)
@@ -270,7 +272,7 @@
     - [Methods](#methods)
       - [bot.end(reason)](#botendreason)
       - [bot.quit(reason)](#botquitreason)
-      - [bot.tabComplete(str, [assumeCommand], [sendBlockInSight])](#bottabcompletestr-assumecommand-sendblockinsight)
+      - [bot.tabComplete(str, [assumeCommand], [sendBlockInSight], [timeout])](#bottabcompletestr-assumecommand-sendblockinsight-timeout)
       - [bot.chat(message)](#botchatmessage)
       - [bot.whisper(username, message)](#botwhisperusername-message)
       - [bot.chatAddPattern(pattern, chatType, description)](#botchataddpatternpattern-chattype-description)
@@ -291,7 +293,7 @@
       - [bot.getExplosionDamages(entity, position, radius, [rawDamages])](#botgetexplosiondamagesentity-position-radius-rawdamages)
       - [bot.lookAt(point, [force])](#botlookatpoint-force)
       - [bot.look(yaw, pitch, [force])](#botlookyaw-pitch-force)
-      - [bot.updateSign(block, text, back = false)](#botupdatesignblock-text)
+      - [bot.updateSign(block, text, back = false)](#botupdatesignblock-text-back--false)
       - [bot.equip(item, destination)](#botequipitem-destination)
       - [bot.unequip(destination)](#botunequipdestination)
       - [bot.tossStack(item)](#bottossstackitem)
@@ -331,6 +333,7 @@
       - [bot.setCommandBlock(pos, command, [options])](#botsetcommandblockpos-command-options)
       - [bot.supportFeature(name)](#botsupportfeaturename)
       - [bot.waitForTicks(ticks)](#botwaitforticksticks)
+      - [bot.respawn()](#botrespawn)
     - [Lower level inventory methods](#lower-level-inventory-methods)
       - [bot.clickWindow(slot, mouseButton, mode)](#botclickwindowslot-mousebutton-mode)
       - [bot.putSelectedItemRange(start, end, window, slot)](#botputselecteditemrangestart-end-window-slot)
@@ -1271,6 +1274,26 @@ UUID существа, который определяется боссом.
  * `title` - Текст на экране.
  * `type` - Тип текста "subtitle" или "title"
 
+#### "title_times" (fadeIn, stay, fadeOut)
+
+Срабатывает, когда сервер отправляет пакет с временем для текста по центру экрана (например, когда устанавливается или обновляется время для появления, отображения и исчезновения надписи).
+
+ * `fadeIn` - время появления в тиках (число)
+ * `stay` - время отображения в тиках (число)
+ * `fadeOut` - время исчезновения в тиках (число)
+
+Пример:
+
+```js
+bot.on('title_times', (fadeIn, stay, fadeOut) => {
+  console.log(`Время для надписей: fadeIn=${fadeIn}, stay=${stay}, fadeOut=${fadeOut}`)
+})
+```
+
+#### "title_clear"
+
+Срабатывает, когда сервер очищает все надписи по центру экрана.
+
 #### "rain"
 
 Срабатывает, когда начинается или прекращается дождь. Если вы присоединитесь к
@@ -1454,10 +1477,12 @@ UUID существа, который определяется боссом.
 
  * `block` - Блок, который не был разрушен.
 
-#### "usedfirework"
+#### "usedFirework" (fireworkEntityId)
 
 Срабатывает при использовании фейерверка во время полёта на элитрах.
 
+ * `fireworkEntityId` - айди существа фейерверка.
+
 #### "move"
 
 Срабатывает при движении бота. Если вы хотите узнать текущее положение, используйте `bot.entity.position`, если вы хотите узнать предыдущее положение, используйте `bot.entity.position.minus(bot.entity.velocity)`.
@@ -1635,7 +1660,7 @@ UUID существа, который определяется боссом.
 
 #### bot.recipesFor(itemType, metadata, minResultCount, craftingTable)
 
-Возвращает список рецептов(`Recipe`), которые вы можете использовать для крафта
+Возвращает список рецептов(`Recipe`), которые вы можете использовать для крафта 
 предмета(`itemType`) с мета-данными(`metadata`).
 
  * `itemType` - Числовой ID предмета, который вы хотите создать.
@@ -1667,7 +1692,7 @@ const cow = bot.nearestEntity(entity => entity.name.toLowerCase() === 'cow') //
 
 Принудительно завершает соединение по собственной причине (по умолчанию `'disconnect.quitting'`).
 
-#### bot.tabComplete(str, [assumeCommand], [sendBlockInSight])
+#### bot.tabComplete(str, [assumeCommand], [sendBlockInSight], [timeout])
 
 Эта функция возвращает `Promise` с `matches` в качестве аргумента при завершении.
 
@@ -1676,6 +1701,7 @@ const cow = bot.nearestEntity(entity => entity.name.toLowerCase() === 'cow') //
  * `str` - Строка для завершения через подсказки.
  * `assumeCommand` - Поле отправляемое серверу, по умолчанию `false`.
  * `sendBlockInSight` - Поле отправляемое серверу, по умолчанию `true`. Установите для этого параметра значение `false`, если вы хотите повысить производительность.
+ * `timeout` - Время в миллисекундах, после которого функция вернёт пустой массив, по умолчанию 5000.
 
 #### bot.chat(message)
 
@@ -1711,6 +1737,8 @@ const cow = bot.nearestEntity(entity => entity.name.toLowerCase() === 'cow') //
 
 Возвращает число, которое используется методом `bot.removeChatPattern()` лишь для того, чтобы можно было удалить этот шаблон.
 
+ - :eyes: см. [examples/chat_parsing](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js#L17-L36)
+
 #### bot.addChatPatternSet(name, patterns, chatPatternOptions)
 
 Создаёт событие, который вызывается каждый раз, когда сообщения совпадают с шаблонами.
@@ -1723,6 +1751,8 @@ const cow = bot.nearestEntity(entity => entity.name.toLowerCase() === 'cow') //
 
 Возвращает число, которое используется методом `bot.removeChatPattern()` лишь для того, чтобы можно было удалить этот шаблон.
 
+ - :eyes: см. [examples/chat_parsing](https://github.com/PrismarineJS/mineflayer/blob/master/examples/chat_parsing.js#L17-L36)
+
 #### bot.removeChatPattern(name)
 
 Удаляет шаблон(ы) чата.
@@ -2110,6 +2140,10 @@ bot.once('login', () => {
 
 Это функция основана на промисе. Она ожидает определённое количество игровых тиков перед продолжением. Может быть полезно для быстрых таймеров, который требуют особых задержек, независимо от заданной физической скорости тиканья бота. Это похоже на стандартную функцию Javascript `setTimeout`, но выполняется специально по физическому таймеру бота.
 
+#### bot.respawn()
+
+Когда выключена настройка `respawn`, вы можете вызвать этот метод для ручного возрождения.
+
 ### Методы инвентаря низкого уровня
 
 Эти методы могут быть иногда полезны, но мы рекомендуем использовать методы, описанные выше.
@@ -2117,8 +2151,20 @@ bot.once('login', () => {
 #### bot.clickWindow(slot, mouseButton, mode)
 
 Эта функция возвращает `Promise` с `void` в качестве аргумента при завершении.
-
-Единственное действительное значение для `mode` - 0. Нажатие с шифтом или перемещение через мышь не реализовано.
+  
+Поддержка mode:
+  - стабильно:
+    - клик мышью (0)
+
+  - экспериментально:
+    - клик с шифтом (1)
+    - клик цифрой (2)
+    - клик колёсиком (3)
+    - выкидывающий клик (4)
+
+  - не реализовано:
+    - драг клик (5)
+    - двойной клик (6)
 
 Нажимает на текущее окно. Подробнее - https://minecraft.wiki/w/Protocol#Click_Container
 

package/docs/tutorial.md

@@ -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://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 :
+You can create your own event from chat using [`bot.addChatPattern()`](http://prismarinejs.github.io/mineflayer/#/api?id=botaddchatpatternname-pattern-chatpatternoptions) method. Useful for Bukkit servers where the chat format changes a lot.
+[`bot.addChatPattern()`](http://prismarinejs.github.io/mineflayer/#/api?id=botaddchatpatternname-pattern-chatpatternoptions) 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"
@@ -575,7 +575,7 @@ Examples :
 Here we're creating a bot that answer 'hello' from the other player.
 
 ```js
-bot.chatAddPattern(
+bot.addChatPattern(
   /(helo|hello|Hello)/,
   'hello',
   'Someone says hello'
@@ -601,7 +601,7 @@ Custom chat example:
 ```
 
 ```js
-bot.chatAddPattern(
+bot.addChatPattern(
   /^\[(.+)\] (\S+) > (.+)$/,
   'my_chat_event',
   'Custom chat event'

package/lib/loader.js

@@ -47,6 +47,8 @@ const plugins = {
 
 const minecraftData = require('minecraft-data')
 const { testedVersions, latestSupportedVersion, oldestSupportedVersion } = require('./version')
+const latestSupportedProtocolVersion = minecraftData.versionsByMinecraftVersion.pc[latestSupportedVersion].version
+if (!latestSupportedProtocolVersion) throw new Error(`Version '${latestSupportedVersion}' not supported by minecraft-data - is it up to date?`)
 
 module.exports = {
   createBot,
@@ -118,7 +120,7 @@ function createBot (options = {}) {
     if (!bot.registry?.version) throw new Error(`Server version '${serverPingVersion}' is not supported, no data for version`)
 
     const versionData = bot.registry.version
-    if (versionData['>'](latestSupportedVersion)) {
+    if (versionData['>'](latestSupportedVersion) && (versionData.version !== latestSupportedProtocolVersion)) {
       throw new Error(`Server version '${serverPingVersion}' is not supported. Latest supported version is '${latestSupportedVersion}'.`)
     } else if (versionData['<'](oldestSupportedVersion)) {
       throw new Error(`Server version '${serverPingVersion}' is not supported. Oldest supported version is '${oldestSupportedVersion}'.`)

package/lib/plugins/entities.js

@@ -271,7 +271,12 @@ function inject (bot) {
     entity.pitch = conv.fromNotchianPitchByte(packet.pitch)
     entity.headPitch = conv.fromNotchianPitchByte(packet.headPitch)
 
-    const notchVel = new Vec3(packet.velocityX, packet.velocityY, packet.velocityZ)
+    let notchVel
+    if (bot.supportFeature('entityVelocityIsLpVec3')) {
+      notchVel = new Vec3(packet.velocity.x, packet.velocity.y, packet.velocity.z)
+    } else {
+      notchVel = new Vec3(packet.velocityX, packet.velocityY, packet.velocityZ)
+    }
     entity.velocity.update(conv.fromNotchVelocity(notchVel))
     entity.metadata = parseMetadata(packet.metadata, entity.metadata)
 
@@ -281,7 +286,12 @@ function inject (bot) {
   bot._client.on('entity_velocity', (packet) => {
     // entity velocity
     const entity = fetchEntity(packet.entityId)
-    const notchVel = new Vec3(packet.velocityX, packet.velocityY, packet.velocityZ)
+    let notchVel
+    if (bot.supportFeature('entityVelocityIsLpVec3')) {
+      notchVel = new Vec3(packet.velocity.x, packet.velocity.y, packet.velocity.z)
+    } else {
+      notchVel = new Vec3(packet.velocityX, packet.velocityY, packet.velocityZ)
+    }
     entity.velocity.update(conv.fromNotchVelocity(notchVel))
   })
 
@@ -348,7 +358,7 @@ function inject (bot) {
   bot._client.on('sync_entity_position', (packet) => {
     const entity = fetchEntity(packet.entityId)
     entity.position.set(packet.x, packet.y, packet.z)
-    entity.velocity.update(packet.dx, packet.dy, packet.dz)
+    entity.velocity.set(packet.dx, packet.dy, packet.dz)
     entity.yaw = packet.yaw
     entity.pitch = packet.pitch
     bot.emit('entityMoved', entity)

package/lib/plugins/spawn_point.js

@@ -5,7 +5,8 @@ module.exports = inject
 function inject (bot) {
   bot.spawnPoint = new Vec3(0, 0, 0)
   bot._client.on('spawn_position', (packet) => {
-    bot.spawnPoint = new Vec3(packet.location.x, packet.location.y, packet.location.z)
+    const pos = bot.supportFeature('spawnPositionIsGlobal') ? packet.globalPos.location : packet.location
+    bot.spawnPoint = new Vec3(pos.x, pos.y, pos.z)
     bot.emit('game')
   })
 }

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', '1.21.5', '1.21.6']
+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', '1.21.6', '1.21.8', '1.21.9']
 module.exports = {
 
   testedVersions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mineflayer",
-  "version": "4.32.0",
+  "version": "4.34.0",
   "description": "create minecraft bots with a stable, high level API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -21,8 +21,8 @@
   },
   "license": "MIT",
   "dependencies": {
-    "minecraft-data": "^3.76.0",
-    "minecraft-protocol": "^1.60.0",
+    "minecraft-data": "^3.98.0",
+    "minecraft-protocol": "^1.63.0",
     "prismarine-biome": "^1.1.1",
     "prismarine-block": "^1.22.0",
     "prismarine-chat": "^1.7.1",
@@ -37,6 +37,7 @@
     "prismarine-world": "^3.6.0",
     "protodef": "^1.18.0",
     "typed-emitter": "^1.0.0",
+    "uuid-1345": "^1.0.2",
     "vec3": "^0.1.7"
   },
   "devDependencies": {