HeroBot

HeroBot - это мод для Майнкрафт на Fabric, который создан специально для разработчиков датапаков и любителей PVP. Он позволяет создавать на сервере ботов, которые ведут себя почти как настоящие игроки - могут атаковать, защищаться, прыгать через препятствия и даже имитировать пинг. В отличие от Carpet, боты HeroBot гораздо ближе к поведению ванильного клиента.

Если вы когда-нибудь хотели потренировать PVP против живых противников, но друзья онлайн не всегда есть - HeroBot решает эту проблему. Просто спавните бота и настраивайте его поведение под свои задачи.

---

Важно знать

Мод несовместим с Carpet Mod и Carpet PVP. Если у вас установлен один из них - HeroBot работать не будет.

---

Настройки

Все настройки мода управляются через команду /herobot. Если ввести её без аргументов - покажет версию мода.

Как использовать:

• /herobot <настройка> - показывает текущее значение и описание
• /herobot <настройка> <значение> - временно меняет настройку до перезапуска
• /herobot <настройка> <значение> perm - сохраняет настройку навсегда в конфиг

Боты

• allowSpawningOfflinePlayers - разрешает спавнить офлайн-игроков как ботов, если игрок с таким ником не онлайн. По умолчанию: true
• allowListingBotPlayers - показывает ботов в списке игроков (Tab). По умолчанию: true
• botPingToTicks - конвертация пинга бота (в мс) в тики задержки для отбрасывания. По умолчанию: 25
• botLagAttacks - [Экспериментально] задерживает атаки бота на значение его пинга. По умолчанию: false
• botLagUses - [Экспериментально] задерживает использование предметов ботом на значение его пинга. По умолчанию: false
• botLeaveOnDeath - бот отключается от сервера при смерти вместо авто-возрождения. По умолчанию: false

Креатив

• creativeNoClip - режим ноклипа для креативных игроков в полёте (проходят сквозь блоки). По умолчанию: false
• creativeFlySpeed - множитель скорости полёта в креативе. По умолчанию: 1.0
• creativeFlyDrag - сопротивление воздуха при полёте. Меньше значение = меньше сопротивления. По умолчанию: 0.09

Бой

• shieldStunning - включает оглушение щитов: после того как щит выбили, урон проходит сразу. По умолчанию: false
• noProjectileRandom - убирает разброс у снарядов, делая их абсолютно точными. По умолчанию: false

Взрывы

• explosionNoBlockDamage - контролирует, разрушают ли взрывы блоки:
  • FALSE - ванильное поведение
  • MOST - не разрушает твёрдые блоки, кроме светокамня и редстоун-механизмов
  • TRUE - полностью отключает разрушение блоков взрывами По умолчанию: FALSE
• explosionNoFire - взрывы от кроватей и якоря возрождения не создают огонь. По умолчанию: false
• windChargeNoTrigger - заряды ветра не активируют редстоун. По умолчанию: false

Мир / Разное

• clientsIgnoreSlowTickRate - если false, клиенты игнорируют замедление тиков. По умолчанию: true
• editablePlayerNbt - разрешает редактировать NBT игроков напрямую. Также позволяет сажать игроков верхом через /ride. По умолчанию: false
• xpNoCooldown - опыт подбирается мгновенно без задержки. По умолчанию: false
• shulkerBoxAlwaysDrops - шалкер-боксы всегда выпадают при разрушении, независимо от правила doTileDrops. По умолчанию: false
• deleteChunkEntities - при сбросе/удалении чанков также удаляются файлы сущностей внутри них. По умолчанию: false
• rainThroughMovingPiston - дождь проходит сквозь блоки, которые двигаются поршнями. По умолчанию: false
• disableExperimentalScreen - убирает экран экспериментальных настроек мира. Если включено на клиенте - убирает все такие экраны, если на мире - только для этого мира. По умолчанию: false

---

Управление ботами

Боты в HeroBot - это фейковые игроки, которые подключаются к серверу и полностью управляются через команды. Спавнятся через /playerspawn, управляются через /player. Боты корректно обрабатывают бой, движение и использование предметов на стороне сервера.

При смерти бот автоматически возрождается с полным здоровьем, пустым инвентарём и без опыта (если не включён botLeaveOnDeath).

/playerspawn

Спавнит бота с опциональными параметрами:

• /playerspawn <имя> - спавн на месте исполнителя команды
• /playerspawn <имя> at <координаты> - спавн в конкретном месте
• /playerspawn <имя> at <координаты> facing <поворот> - спавн с определённым yaw/pitch
• /playerspawn <имя> at <координаты> facing <сторона> - спавн лицом к стороне света (north, south, east, west, up, down)
• /playerspawn <имя> ... in <режим> - спавн в определённом режиме (по умолчанию креатив)
• /playerspawn <имя> ... on <измерение> - спавн в конкретном измерении

Не даёт создать бота с уже занятым ником. Учитывает вайтлист и баны. Зрители спавнятся в полёте, выживающие - на земле.

/player

Управление ботами через наборы действий (action packs). Все подкоманды работают через /player <цели> ..., поддерживают селекторы для массового управления.

Действия:

• /player <цели> use/attack/swing/jump/drop/dropStack/swapHands [once/continuous/interval <тики>]

  • Без параметра - останавливает действие
  • once - выполняет один раз
  • continuous - выполняет каждый тик
  • interval <тики> - выполняет каждые N тиков

  use без параметров останавливает использование без повторного клика (в отличие от Carpet).

  swing махает рукой без действия и сбрасывает кулдаун атаки.

  Атака с копьём/кинетическим оружием выполняет укол вместо обычного удара.

Автопрыжок:

• /player <цели> autojump - попытка одного прыжка через препятствие при движении
• /player <цели> autojump true/false - включение/выключение постоянного автопрыжка

Движение:

• /player <цели> move [forward/backward/left/right] Без направления - останавливает движение.

Приседание/Спринт:

• /player <цели> sneak/unsneak/sprint/unsprint Приседание замедляет движение до 30%, использование предмета (не копья) до 20%.

Взгляд: Большинство команд взгляда поддерживают delta <тики> для плавного поворота.

• По сторонам света: /player <цели> look north/south/east/west/up/down [delta <тики>]
• Точный поворот: /player <цели> look <yaw> <pitch> [delta <тики>]
• Относительный поворот: /player <цели> look left/right/back/relative <угол> [delta <тики>]
• Взгляд на позицию: /player <цели> look at <координаты> [delta <тики>]
• Взгляд на сущность: /player <цели> look upon <сущность> [eyes/feet/closest] [delta <тики>]
• Случайный взгляд: /player <цели> look random

Горячая панель:

• /player <цели> hotbar <слот> - выбирает слот от 1 до 9

Кулдауны предметов:

• /player <цели> itemCd - сбрасывает все кулдауны (показывает сколько сброшено)
• /player <цели> itemCd <предмет> - показывает оставшиеся тики кулдауна для предмета
• /player <цели> itemCd <предмет> reset/set/set <тики> - управление кулдауном предмета

Пинг: Имитация пинга бота. Отбрасывание задерживается на количество тиков из расчёта botPingToTicks.

• /player <цели> ping - показывает текущий пинг и эквивалентную задержку в тиках
• /player <цели> ping <значение> - устанавливает пинг в мс (рекомендуется: 0, 25, 50, 100, 150, 200) Задержка имеет случайность если пинг не делится ровно на botPingToTicks.

Копирование:

• /player <цели> copycat <игрок> - копирует инвентарь и действия другого игрока на бота. Скин / Рука: Управление видимостью частей скина:
• /player <цели> skin cape/jacket/leftSleeve/rightSleeve/leftPant/rightPant/hat - переключает видимость части скина. Левая/правая рука:
• /player <цели> handedness left/right Остановка / Убийство / Отключение:
• /player <цели> stop - останавливает все действия и движение бота.
• /player <цели> kill - убивает бота (вызывает смерть и возрождение).
• /player <цели> disconnect - удаляет бота с сервера без смерти.

---

Расстояние (/distance)

Команда для измерения расстояния между двумя точками, сущностями или хитбоксами. Результат сохраняется как возвращаемое значение команды (можно использовать в скорборде). По умолчанию расстояние сферическое (3D). from: Измерение от точки до точки.

• /distance from <позиция1> to <позиция2|сущность> fromHitbox: Использует полный хитбокс источника вместо центра.
• /distance fromHitbox <блок|сущность> to ... Можно комбинировать с toHitbox: /distance fromHitbox ... toHitbox ... e (масштабирование): Умножает результат на 10^exp. Пример: 4 блока с e 3 вернёт 4000. horizontal: Измеряет только по XZ (игнорирует Y). Поддерживает e. vertical: Измеряет только по Y (игнорирует XZ). Поддерживает e.

---

Отложенные команды (/delayed)

Позволяет запланировать выполнение команд или функций через определённое количество тиков. tickDelay: Запускает команду или функцию после задержки.

• /delayed tickDelay <тики> command <команда>
• /delayed tickDelay <тики> function <функция> queue: Просмотр и управление отложенными командами.
• /delayed queue [entity [<сущность>]]
• /delayed queue remove <индекс> clear: Очищает все отложенные команды.

---

Сброс чанков (/chunk-resetter)

Сбрасывает (удаляет) данные чанков, чтобы они перегенерировались при следующей загрузке. Загруженные чанки пропускаются. chunk: Сброс конкретных чанков по координатам столбца блоков.

• /chunk-resetter chunk <позиция>
• /chunk-resetter chunk <откуда> <докуда> (макс 256 чанков) Сущности в сбрасываемых чанках удаляются. world: Сброс всех незагруженных чанков в измерении. Также удаляет POI данные. Файлы сущностей удаляются только если включён deleteChunkEntities.

---

HeroBot - мощный инструмент для тех, кто хочет выжать максимум из PVP и автоматизации на сервере Майнкрафт. Если вы делаете датапак для мини-игр или просто хотите потренироваться в бою без живых соперников - этот мод для вас.