190 lines
15 KiB
Markdown
190 lines
15 KiB
Markdown
# Minecraft бот (mineflayer)
|
||
|
||
Бот для Minecraft на JavaScript. Подключается к серверу, ходит, следует за игроком
|
||
и отвечает на команды в чате. Есть автопереподключение.
|
||
|
||
## Запуск
|
||
|
||
```bash
|
||
npm install
|
||
npm start
|
||
```
|
||
|
||
По умолчанию подключается к `localhost:25565` с ником `Bot` в offline-режиме.
|
||
|
||
## Настройка
|
||
|
||
Меняй параметры в [config.js](config.js) или через переменные окружения:
|
||
|
||
```bash
|
||
MC_HOST=play.example.com MC_PORT=25565 MC_USER=MyBot MC_AUTH=offline npm start
|
||
```
|
||
|
||
| Переменная | Значение по умолчанию | Описание |
|
||
|--------------|-----------------------|-------------------------------------------|
|
||
| `MC_HOST` | `localhost` | Адрес сервера |
|
||
| `MC_PORT` | `25565` | Порт |
|
||
| `MC_USER` | `Bot` | Ник бота |
|
||
| `MC_AUTH` | `offline` | `offline` или `microsoft` (лицензия) |
|
||
| `MC_VERSION` | авто | Версия игры (обычно не нужна) |
|
||
| `MC_MASTER` | пусто | Ник игрока, чьи команды слушать (пусто — всех) |
|
||
|
||
## Плагины
|
||
|
||
- **mineflayer-web-inventory** — веб-просмотр инвентаря бота в реальном времени.
|
||
Открывается на `http://localhost:3000` (порт — `webInventoryPort` в config). Команда `веб`
|
||
печатает ссылку. Стартует после захода на сервер, закрывается при отключении.
|
||
- **prismarine-viewer** — 3D-обзор мира вокруг бота в браузере (вид от третьего лица).
|
||
Открывается на `http://localhost:3001` (порт — `viewerPort` в config, `VIEWER_PORT=...`).
|
||
Команда `обзор` (или `3d`) печатает ссылку. Стартует после захода на сервер и закрывается
|
||
при отключении (освобождает порт к реконнекту).
|
||
Server-side рендер атласа текстур тянет нативный `canvas` (как и панорама), поэтому 3D-обзор
|
||
работает **только через `npm run start:pano`** (Node 20); под Node 26 он мягко отключается.
|
||
- **mineflayer-auto-auth** — авто-вход на серверах с `/login` (AuthMe). Включается, если
|
||
задан `authPassword` в config (или `MC_PASSWORD=... npm start`). Иначе выключен.
|
||
- **Панорама** (`панорама`/`фото`) — своя реализация в [src/panorama.js](src/panorama.js):
|
||
рендерит 4 стороны света на уровне глаз (fov 90°) и склеивает в **одну ленту 360°** с ровным
|
||
горизонтом, сохраняет JPG в `panoramaDir`. (Готовая сборка из mineflayer-panorama давала
|
||
кубическую развёртку 3×2 с пустой гранью и заваленным горизонтом — заменено своим рендером.)
|
||
Графика тянет нативный `gl`/`canvas`, которые **не работают на Node 26** — они уже собраны
|
||
под локальный Node 20, поэтому панорама доступна только через `npm run start:pano`.
|
||
|
||
## Запуск
|
||
|
||
```bash
|
||
npm start # обычный запуск (Node 26). Панорама и 3D-обзор отключены.
|
||
npm run start:pano # запуск под встроенным Node 20 — с панорамой и 3D-обзором мира.
|
||
```
|
||
|
||
### Почему два режима
|
||
|
||
`mineflayer-panorama` зависит от нативного `gl` (headless-gl), который **не собирается на
|
||
Node 26** (системный GCC 16 ломает старый код ANGLE, нет prebuild-бинарей). Поэтому в проект
|
||
положен локальный **Node 20** (папка `.node20/`, в git не коммитится), под которым `gl` и
|
||
`canvas` уже собраны и работают.
|
||
|
||
- `npm start` — под системным Node 26: бот работает полностью, кроме панорамы и 3D-обзора
|
||
(они мягко отключаются, бот пишет об этом в консоль).
|
||
- `npm run start:pano` — под `.node20/bin/node`: панорама и 3D-обзор (prismarine-viewer) тоже
|
||
работают — у обоих нативный `canvas`, собранный под Node 20.
|
||
|
||
`mineflayer-panorama` вынесен в `optionalDependencies`, поэтому обычный `npm install` на
|
||
Node 26 не падает, даже если `gl` не соберётся.
|
||
|
||
Если папку `.node20/` удалить — `npm start` продолжит работать (без панорамы). Чтобы снова
|
||
собрать панораму, нужен Node 18/20 (через `.nvmrc` + fnm/nvm) и `npm install`.
|
||
|
||
## Консоль управления (TUI)
|
||
|
||
Все команды ниже можно слать **прямо из терминала**, где запущен бот, не заходя
|
||
в игру. При запуске появляется строка ввода `бот»`:
|
||
|
||
```
|
||
бот» добудь железо 5
|
||
бот» атакуй Steve
|
||
бот» стой
|
||
```
|
||
|
||
- **обычная строка** — команда бота (тот же список, что и в игровом чате: `иди`,
|
||
`стой`, `помощь` и т.д.). Из консоли бот действует от имени мастера (`MC_MASTER`),
|
||
поэтому «иди»/«за мной»/«kit pvp» работают; если мастер не задан — берётся
|
||
ближайший игрок.
|
||
- **строка с `/`** — уходит на сервер как есть: `/tp`, `/gamemode creative`, `/say привет`.
|
||
- **`выход`** или **Ctrl-C** — закрыть бота.
|
||
|
||
Ответы бота и весь чат печатаются над строкой ввода, не сбивая набор. Консоль
|
||
переживает переподключения. При запуске не в терминале (вывод в файл/пайп) TUI
|
||
не включается — бот работает как раньше.
|
||
|
||
## Команды в чате
|
||
|
||
Напиши в игровом чате (или в консоли, см. выше):
|
||
|
||
- `помощь` — список команд
|
||
- `иди` — бот идёт к тебе
|
||
- `за мной` — следует за тобой
|
||
- `стой` — остановиться
|
||
- `прыгай` — подпрыгнуть
|
||
- `координаты` — назвать свои координаты
|
||
- `инвентарь` — показать содержимое инвентаря
|
||
- `выкинуть <предмет> [N]` — выбросить предмет из инвентаря. Без `N` выкидывает все
|
||
этого вида. Имя — по minecraft-id (точное или частичное совпадение), напр.
|
||
`выкинуть cobblestone 32`, `выкинуть rotten_flesh`
|
||
- `сортировка` (или `sort`) — слить неполные стопки и отсортировать рюкзак по имени.
|
||
- `автосорт` — вкл/выкл авто-сортировку (по умолчанию **включено**): бот сам сортирует
|
||
инвентарь через пару секунд после подбора предметов (но не во время боя, другой задачи
|
||
или когда открыт сундук/печь). Сортируется только рюкзак (слоты 9–35), хотбар/броня
|
||
не трогаются.
|
||
|
||
### Добыча и ферма
|
||
|
||
- `добудь еды [N]` — бот охотится на ближайших животных (корова, свинья, курица, овца,
|
||
кролик) и собирает мясо. `N` — сколько животных (по умолчанию 3, максимум 64). Пример: `добудь еды 6`
|
||
- `добудь <руду> [N]` — находит, доходит и копает указанную руду нужной киркой.
|
||
`N` — сколько блоков (по умолчанию 5, максимум 64). Пример: `добудь алмаз 10`
|
||
Поддерживает: `уголь`, `железо`, `медь`, `золото`, `редстоун`, `лазурит`, `алмаз`, `изумруд`, `кварц`
|
||
(есть и английские названия). Учитывает deepslate-варианты.
|
||
- `следи` (за огородом) — фоновый режим: бот ходит по грядкам, собирает спелые
|
||
культуры (пшеница, морковь, картофель, свёкла) и пересаживает семена обратно.
|
||
|
||
- `приготовь` (или `пожарь`/`cook`) — бот находит ближайшую печь/коптильню (или ставит
|
||
свою, если печь есть в инвентаре), кладёт всё сырое мясо и топливо, ждёт прожарки и
|
||
забирает готовое. Топливо выбирает само (уголь/уголёк → дерево → прочее).
|
||
- `автоеда` — вкл/выкл авто-питание (по умолчанию **включено**): бот следит за сытостью.
|
||
Приоритет: сначала **готовая** еда → если её нет, а есть сырьё — **жарит в печи и ест** →
|
||
если еды совсем нет и он сильно голоден, идёт на охоту, жарит добычу и ест.
|
||
Сырое мясо съедает только как фолбэк (если жарить негде/нечем). Не отвлекается на еду
|
||
во время боя; не ест ценное (золотые яблоки/морковь) и вредное (гнильё, ядовитый
|
||
картофель и т.п.).
|
||
|
||
- `броня` — надеть лучшую броню из инвентаря прямо сейчас.
|
||
- `автоброня` — вкл/выкл авто-броню (по умолчанию **включено**): бот сам надевает лучшую
|
||
по материалу броню (незерит → алмаз → железо → кольчуга/панцирь → золото → кожа) при
|
||
спавне и каждый раз, когда что-то поднимает. Не снимает уже надетую лучшую.
|
||
|
||
Прервать любую из этих задач: `стой`.
|
||
|
||
### Бой (PvP/PvE)
|
||
|
||
- `атакуй <ник>` — атаковать игрока по нику
|
||
- `мобы` — атаковать ближайшего враждебного моба
|
||
- `охрана` — вкл/выкл режим охраны (бот сам бьёт враждебных мобов рядом)
|
||
- `не` — прекратить бой и выключить охрану
|
||
- `стой` — тоже останавливает бой
|
||
|
||
Перед атакой бот сам надевает лучшее оружие (меч приоритетнее топора). При нападении
|
||
поблизости бот огрызается и даёт сдачи.
|
||
|
||
- `кристалл <ник> [N]` (или `crystal`) — **Crystal PvP**: бот подходит к игроку, ставит
|
||
энд-кристалл на обсидиан/бедрок рядом с целью и тут же взрывает его, повторяя до `N` раз
|
||
(по умолчанию 10). Нужны `end_crystal` в инвентаре (и `obsidian`, если рядом нет основы).
|
||
В левую руку сам берёт тотем бессмертия, если есть. Прервать — `стой`.
|
||
|
||
- `булава <ник> [N]` (или `mace`/`элитра`/`мейс`) — **Elytra-Mace** (техника 1.21): бот
|
||
надевает элитры, взлетает на фейерверках над целью и пикирует с булавой. **На подлёте
|
||
(≈8 блоков до цели) бот сбрасывает элитры и надевает нагрудник** — срывается в свободное
|
||
падение и бьёт уже в броне, иначе элитры в полёте срезают смэш-урон булавы. Делает `N`
|
||
заходов (по умолчанию 1, максимум 16). Нужны в инвентаре: `elytra`, `mace`,
|
||
`firework_rocket` (взлёт/разгон) и **металлический нагрудник** (`*_chestplate` — для свапа
|
||
и полного урона; без него бьёт прямо в элитрах ослабленно). Полёт считается локальной
|
||
физикой, без `pathfinder`. Прервать — `стой`.
|
||
|
||
### Kit PvP (дуэль) — нужны права OP у бота
|
||
|
||
- `kit pvp` — сохраняет инвентари игрока и бота, очищает их и выдаёт обоим PvP-кит
|
||
(бот сам надевает броню и берёт меч/щит). Кит настраивается в [config.js](config.js) → `pvpKit`.
|
||
- `kit end` — возвращает сохранённые инвентари обоим.
|
||
|
||
Как это работает: бот не передаёт NBT-инвентаря через чат (там лимит 256 символов),
|
||
а копирует его **на стороне сервера** в data-storage командой
|
||
`/data modify storage … set from entity …`, и возвращает обратно тем же способом.
|
||
Поэтому фича требует OP и сервер с поддержкой data-storage (Minecraft 1.16+).
|
||
|
||
(Английские варианты: `come`, `follow`, `stop`, `jump`, `pos`, `inv`, `attack`,
|
||
`mobs`, `guard`, `ceasefire`, `kit pvp`, `kit end`.)
|
||
|
||
## Как проверить без своего сервера
|
||
|
||
Поставь локальный сервер (например [PaperMC](https://papermc.io/)) с `online-mode=false`
|
||
в `server.properties`, запусти его, затем `npm start`.
|