Update russian docs (#3762)

* Update api_ru

* Update api_ru

* Update README_RU.md

* Update FAQ_RU.md

* Update CONTRIBUTING_RU.md

* Update api_ru.md

* Update README_RU.md

* revert wiki url change

---------

Co-authored-by: extremeheat <extreme@protonmail.ch>

Author: fungoza

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)

docs/ru/FAQ_RU.md

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

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
 
 
 ## Тестирование

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,15 +2140,31 @@ bot.once('login', () => {
 
 Это функция основана на промисе. Она ожидает определённое количество игровых тиков перед продолжением. Может быть полезно для быстрых таймеров, который требуют особых задержек, независимо от заданной физической скорости тиканья бота. Это похоже на стандартную функцию Javascript `setTimeout`, но выполняется специально по физическому таймеру бота.
 
+#### bot.respawn()
+
+Когда выключена настройка `respawn`, вы можете вызвать этот метод для ручного возрождения.
+
 ### Методы инвентаря низкого уровня
 
 Эти методы могут быть иногда полезны, но мы рекомендуем использовать методы, описанные выше.
 
 #### bot.clickWindow(slot, mouseButton, mode)
 
 Эта функция возвращает `Promise` с `void` в качестве аргумента при завершении.
-
-Единственное действительное значение для `mode` - 0. Нажатие с шифтом или перемещение через мышь не реализовано.
+  
+Поддержка mode:
+  - стабильно:
+    - клик мышью (0)
+
+  - экспериментально:
+    - клик с шифтом (1)
+    - клик цифрой (2)
+    - клик колёсиком (3)
+    - выкидывающий клик (4)
+
+  - не реализовано:
+    - драг клик (5)
+    - двойной клик (6)
 
 Нажимает на текущее окно. Подробнее - https://minecraft.wiki/w/Protocol#Click_Container