Перейти к основному содержимому

Поведения мобов

Поведение моба — это Lua-файл, который берёт на себя ИИ моба, созданного не FreeMinecraftModels: естественно заспавнившегося крипера, курицы, разбойника из рейда. Пока переопределение действует, моб делает то, что сказано в файле. После этого к нему возвращается его собственный ИИ, и он ведёт себя как прежде.

С плагином поставляются четыре поведения. Крипер может следовать за игроком и взрываться рядом с тем, кто нападает на этого игрока, курица может напасть на игроков, а разбойники могут в страхе убегать. Поведение назначается мобу командой или из Lua-скрипта, на заданное время или до тех пор, пока что-то его не снимет.

Доступность в сборках

Для поведений мобов нужна версия FreeMinecraftModels после 2.15.0 и Minecraft 1.21.4 или новее.

Что делает переопределение​

  • Собственные цели и Brain моба останавливаются, поэтому сам по себе он ничего не делает. Двигают его, поворачивают и заставляют атаковать только поведения.
  • Всё остальное у него остаётся: здоровье, снаряжение, скорость движения и имя, а солнечный свет по-прежнему его сжигает.
  • Он по-прежнему исчезает, когда в радиусе 128 блоков нет ни одного игрока, если только что-то уже не заставило его остаться. Более медленное исчезновение моба, оставленного без дела на расстоянии от 32 до 128 блоков от игроков, при переопределении не происходит.
  • Он двигается и сражается так, как свойственно его типу. Крипер раздувается и взрывается, скелет стреляет стрелами, зомби бьёт.
  • У моба может быть владелец — игрок или любая другая живая сущность. Собственные атаки моба никогда не наносят урон его владельцу: его удары, выпущенные им снаряды и взрыв крипера отменяются. Эффекты зелий не отменяются, как и всё, что поведение делает с владельцем через c.overlay.owner.
  • Когда время истекло или что-то сняло переопределение, к мобу возвращается его собственный ИИ. Зомби снова охотится на игроков, а курица бродит.
  • Переопределение остаётся на мобе при выгрузке чанков, перезапусках сервера и /fmm reload. Переопределение с ограничением по времени продолжает отсчёт, пока моб выгружен, и снимается, если за это время его срок истёк. Памяти поведения начинаются пустыми, когда моб возвращается.
  • Оно заканчивается само, когда истекло его время, когда моб умирает, когда моб превращается в другого моба, например житель в ведьму, или когда поведение вызывает c.overlay:finish().

Команды​

Все они требуют права freeminecraftmodels.mobbehaviors.admin, которое есть у операторов, и доступны только игрокам.

КомандаНазначение
/fmm mobbehavior apply <behaviors> [seconds] [radius]Переопределяет ИИ моба в вашем прицеле, на расстоянии до 32 блоков, указанными поведениями и делает вас его владельцем. С радиусом вместо этого берёт каждого моба в пределах этого числа блоков от вас по каждой оси
/fmm mobbehavior applywild <behaviors> [seconds] [radius]То же самое, но без владельца
/fmm mobbehavior clearВозвращает мобу в вашем прицеле его собственный ИИ
/fmm mobbehavior clear allВозвращает собственный ИИ каждому загруженному мобу с переопределением. Моб в выгруженном чанке сохраняет переопределение и возобновляет его, когда загружается
/fmm mobbehavior listВыводит список загруженных поведений и число мобов, выполняющих одно из них
  • behaviors — одно имя или несколько, соединённых запятыми без пробелов, например coward,wander.
  • seconds — на сколько длится переопределение. Если его не указать или указать 0, оно длится, пока его не снимут.
  • Моб никогда не атакует своего владельца и не боится его. Чтобы испытать hostile или coward на себе, используйте applywild.
  • hostile и coward не выбирают целью игроков в творческом режиме и режиме наблюдателя, поэтому проверяйте в режиме выживания. Если игрок в творческом режиме ударил моба, моб всё равно сражается с ним или убегает от него в течение 10 секунд.
/fmm mobbehavior apply guardian
/fmm mobbehavior applywild hostile 30
/fmm mobbehavior applywild coward,wander 0 12

Первая команда заставляет крипера, на которого вы смотрите, следовать за вами и защищать вас. Вторая заставляет курицу атаковать вас в течение 30 секунд. Третья отправляет каждого моба в пределах 12 блоков убегать от вас, пока вы не выполните clear all.

Поставляемые поведения​

ИмяЧто делает моб
guardianДержится рядом с владельцем и сражается с тем, кто ранит владельца, с тем, кого ранит владелец, и с тем, кто ранит самого моба
hostileАтакует ближайшего игрока или того, кого называет его настройка targets
cowardУбегает от ближайшего игрока или от того, кого называет его настройка fears
wanderПрогуливается, когда ничто другое его не двигает

Моб с переопределением вместе с остальным ИИ потерял и свои прогулки, поэтому без wander он стоит на месте всякий раз, когда другим его поведениям нечего делать. Добавьте wander в список, как в coward,wander. Его место в списке не имеет значения: какое поведение двигает моба, решает priority поведения.

Моб, который стреляет, не стреляет, а бьёт в ближнем бою, когда его цель находится в пределах reach.

Скорости умножают собственную скорость движения моба, так что 1 — его обычный шаг. Расстояния указаны в блоках, время — в тиках.

guardian​

Он следует за владельцем, как только тот оказывается на расстоянии follow_distance, и останавливается на расстоянии follow_stop от него. Сначала он сражается с тем, кто напал на владельца, затем с тем, кто напал на него самого, затем с целью владельца. Каждый из них запоминается на 10 секунд после удара. Без владельца он защищает только себя.

НастройкаПо умолчаниюЗначение
follow_distance6Как далеко должен отойти владелец, чтобы моб пошёл за ним
follow_stop3Как близко он подходит
follow_speed1.2Скорость при следовании
chase_speed1.3Скорость в бою
reach2.2Как близко он подходит, чтобы ударить
fuse_distance3Крипер начинает поджигать фитиль, когда оказывается на таком расстоянии от цели
fuse_escape7Фитиль крипера гаснет, когда цель отходит на такое расстояние или пропадает из виду
shoot_distance12Моб, который стреляет, делает это с такого расстояния и ближе, пока видит цель
attack_ticks20Время между двумя ударами или выстрелами
assisttrueТакже сражается с теми, кого ранит владелец
defend_itselftrueТакже сражается с теми, кто ранит его самого

hostile​

Он атакует того, кто ранил его за последние 10 секунд, а иначе ближайшую цель в пределах range. Новую цель он ищет каждые 10 тиков. Если у него есть владелец, он щадит его и других мобов, которые ему служат.

НастройкаПо умолчаниюЗначение
targetsplayerplayer, hostile, passive, living или тип сущности, например zombie
range16Как далеко он замечает цели
damage0Сколько наносит удар. 0 оставляет это собственной атаке моба, которая равна 2 для типа, у которого её нет, например для курицы
chase_speed, reach, fuse_distance, fuse_escape, shoot_distance, attack_ticksкак у guardianКак в guardian

coward​

Он начинает бежать, когда то, чего он боится, оказывается в пределах range, и останавливается, когда оно отходит на safe_distance. Он также бежит от того, кто ранил его за последние 10 секунд, пока этот нападающий находится в пределах range, а когда моб уже бежит, — в пределах safe_distance. Убегая, он каждый раз прокладывает путь примерно в десять блоков прочь от источника испуга. В комнате или загоне, где нет такого длинного выхода, он отступает к дальней стене.

НастройкаПо умолчаниюЗначение
fearsplayerplayer, hostile, passive, living или тип сущности, например wolf
range10Как близко должен подойти источник испуга, чтобы моб побежал
safe_distance16На каком расстоянии он перестаёт бежать
speed1.5Скорость при беге
cornered_distance6Как далеко он пытается отступить там, где не находит выхода

wander​

Он выбирает точку не дальше radius блоков, идёт туда, затем отдыхает. Любое другое поставляемое поведение сразу забирает у него моба.

НастройкаПо умолчаниюЗначение
radius8Как далеко заходит прогулка
speed1Скорость при прогулке
rest_ticks60Отдых после прогулки
rest_random_ticks120Случайное число тиков от 0 до этого значения минус один, добавляемое к каждому отдыху
walk_ticks200Прогулка, которую он не может закончить, прекращается по истечении этого времени

Из Lua-скрипта​

В каждом Lua-скрипте, который выполняет FreeMinecraftModels, у таблицы сущности моба есть ещё три члена. У таблиц игроков их нет.

ЧленВозвращаетОписание
mob:override_ai(behaviors, options?)true либо false и причинуПереопределяет ИИ моба. behaviors — одно имя или список имён. Если у моба уже есть переопределение, это заменяет его
mob:restore_ai()boolВозвращает мобу его собственный ИИ. true, если переопределение было
mob.ai_overriddenboolВыполняет ли моб переопределение сейчас

options — это таблица, и каждый ключ в ней необязателен:

КлючЗначение
ownerТаблица сущности или строка UUID. Не указывайте, если моб никому не служит
durationКак долго длится переопределение, в тиках. Если не указать, оно длится, пока его не снимут
settingsТаблица таблиц настроек по именам поведений со значениями, которые заменяют значения по умолчанию каждого поведения
local ok, why = mob:override_ai({ 'guardian', 'wander' }, {
owner = player,
duration = 600,
settings = { guardian = { chase_speed = 1.6, assist = false } }
})

override_ai возвращает false с причиной, когда имя поведения не загрузилось или когда сущность нельзя переопределить. Пустой список или owner, который не является ни таблицей сущности, ни UUID, вызывает ошибку. Настройка, которой у поведения нет, или значение неверного типа сообщается в консоли, а значение по умолчанию остаётся.

Из скриптов EliteMobs​

Начиная с версии EliteMobs после 10.9.14, у таблицы сущности моба есть те же три члена и в скриптах EliteMobs, включая способности боссов, если установлен FreeMinecraftModels. Поведения по-прежнему выполняет FreeMinecraftModels, из своей папки mob_behaviors.

  • Элитные мобы, боссы и NPC EliteMobs там отклоняются, и override_ai возвращает false с причиной. Босс может сделать мобов вокруг себя своими стражами, но самого босса переопределить нельзя.
  • В качестве owner можно указать босса: owner = context.boss.
  • Задавайте переопределению duration. Оно переживает босса, который его начал.
  • Без FreeMinecraftModels или с версией, вышедшей до поведений мобов, override_ai возвращает false с причиной.
mob:override_ai('guardian', { owner = context.boss, duration = 600 })

Из другого плагина​

Плагин обращается к поведениям мобов в Java через com.magmaguy.freeminecraftmodels.api.MobBehaviorAPI. overrideAI(mob, behaviors, owner, durationTicks, settings) возвращает null или причину отказа. restoreAI(mob) и isAIOverridden(entity) возвращают логическое значение, а behaviors() перечисляет загруженные имена. Каждый параметр — простой тип Java или Bukkit, поэтому плагин, скомпилированный с более старым FreeMinecraftModels, может найти методы по имени. Вызывайте их в потоке сервера.

Какие мобы​

  • Переопределить можно любого моба, независимо от того, чем он заспавнен. Игроков и стойки для брони переопределить нельзя.
  • Оно рассчитано на мобов, которые ходят по путям: зомби, скелетов, криперов, разбойников, коров, куриц и подобных. Пока оно проверено на кадаврах, криперах и курицах.
  • Мобы, которые не ходят по путям, могут под переопределением двигаться плохо или не двигаться вовсе. Сюда относятся слизни, кубы магмы, гасты, фантомы, кролики, кальмары и рыбы.
  • Питомцев и других мобов, которые уже выполняют программу поведения, например босса EliteMobs с behavior, переопределить нельзя.
  • Элитный моб EliteMobs без программы поведения для FreeMinecraftModels — обычный моб и принимает переопределение, но эта комбинация ещё не проверялась.

Файлы​

  • Поведения лежат в plugins/FreeMinecraftModels/mob_behaviors/, в этой папке или в любой подпапке. Каждый файл .lua там — поведение.
  • Имя поведения — это имя его файла без .lua. В нём можно использовать только строчные буквы, цифры, ., _ и -.
  • Его id должен быть fmm:mob/ плюс его имя, то есть mob_behaviors/scared_of_cats.lua объявляет id = 'fmm:mob/scared_of_cats'. Файл, id которого не совпадает с именем, пропускается с предупреждением.
  • Если у двух файлов одинаковое имя, загружается тот, чей путь идёт первым при сортировке, а консоль предупреждает о другом.
  • FreeMinecraftModels записывает каждое из своих четырёх поведений, если в самой папке mob_behaviors/ нет файла с таким именем. Удалённое поведение возвращается при следующем запуске или /fmm reload. Файл, который вы отредактировали, никогда не перезаписывается. Если перенести его в подпапку, рядом с ним снова появится файл по умолчанию, и загрузится только тот, чей путь идёт первым при сортировке.
  • /fmm reload перечитывает каждый файл. Действующие переопределения останавливаются и запускаются снова с новыми файлами.

Написание поведения​

Файл поведения — это модуль поведения питомца с другим префиксом id: ai.module с settings, memories, behaviors и sensors. Общие правила описаны в разделе Программы поведения EliteMobs. Начните с поставляемого файла, ближайшего к желаемому, скопируйте его под новым именем и измените его id, id его поведений и имена его памятей так, чтобы они начинались с нового имени.

Это поведение заставляет моба убегать от кошек:

-- Runs from the nearest cat within range.
return ai.module {
id = 'fmm:mob/scared_of_cats', revision = 1,
settings = { range = 8, speed = 1.4 },
behaviors = {
ai.behavior {
-- Asked and run every 5 ticks: each run plans a new way out.
id = 'fmm:mob/scared_of_cats', priority = 5, probe_interval = 5, tick_interval = 5,
controls = { ai.controls.move },
can_start = function(c)
return c.overlay:nearest(c.settings.range, 'cat') ~= nil
end,
tick = function(c)
local cat = c.overlay:nearest(c.settings.range, 'cat')
if cat ~= nil then c.actuator:flee(cat.current_location, c.settings.speed) end
end,
stop = function(c) c.actuator:stop_moving() end
}
}
}
  • Меньшее число priority идёт первым и забирает перечисленные в нём элементы управления у работающего поведения с большим числом. Поставляемые поведения используют 5 для coward и для боя guardian, 10 для hostile, 20 для следования guardian и 40 для wander.
  • probe_interval — как часто остановленному поведению задаётся вопрос can_start, в тиках. tick_interval — как часто работающее поведение выполняет can_continue и tick. Оба по умолчанию равны 1, а значения выше 200 считаются равными 200.
  • Два поведения на одном мобе не могут иметь одинаковый id поведения, id сенсора или имя памяти. override_ai и команда отказывают для такой пары и объясняют почему.

Что получает коллбэк​

ИмяЧто это
c.overlayМесто моба в переопределении. См. c.overlay
c.settingsНастройки этого поведения для этого моба: его значения по умолчанию, поверх которых лежат значения переопределения
c.memoryget(name), set(name, value), forget(name) и contains(name) для имён из memories. У каждого моба она своя
c.tickТекущий игровой тик, для таймеров
c.entityТаблица сущности моба, с current_location, health, entity_type и прочим
c.perception, c.actuatorКонтекст Mind из MagmaCore. См. Контекст программы Mind

c.overlay​

Четыре сущности считываются заново при каждом обращении, поэтому сохраняйте нужную в локальной переменной, если коллбэк использует её более одного раза.

ЧленЧто он даёт или делает
c.overlay.ownerТаблица сущности владельца, пока он жив в мире моба, иначе nil
c.overlay.owner_attackerТот, кто ранил владельца за последние 10 секунд, или nil
c.overlay.owner_targetТот, кого владелец ранил за последние 10 секунд, или nil
c.overlay.attackerТот, кто ранил этого моба за последние 10 секунд, или nil
c.overlay:nearest(radius, kind?)Ближайшая живая сущность заданного типа в пределах радиуса или nil. kind — это player, hostile (монстры), passive (животные), living (по умолчанию) или тип сущности по его имени в Bukkit, например zombie или iron_golem. Жители и големы не являются ни hostile, ни passive. Радиус не превышает 128 блоков
c.overlay:entity(uuid)Живая сущность с этим UUID, пока она жива в мире моба, иначе nil. Для поведения, которое хранит UUID своей цели в памяти
c.overlay.remainingСколько тиков осталось у переопределения, или nil, если у него нет конца
c.overlay:finish()Завершает переопределение после окончания этого тика, и к мобу возвращается его собственный ИИ

owner_attacker, owner_target, attacker и nearest никогда не отдают владельца моба или другого моба, служащего тому же владельцу. nearest также пропускает игроков в творческом режиме и режиме наблюдателя и стойки для брони.

Движение и бой​

Эти вызовы c.actuator делают работу. Каждому нужно, чтобы его поведение перечисляло указанный элемент управления.

ВызовЭлемент управленияЧто делает
c.actuator:move_to(location, speed)moveИдёт туда по пути
c.actuator:flee(location, speed)moveПрокладывает путь примерно в десять блоков прочь от точки и следует по нему. false, когда моб не находит выхода или не может прокладывать пути. Вызывайте его раз в несколько тиков, а не каждый тик
c.actuator:stop_moving()moveОстанавливает
c.actuator:look_at(location)lookПоворачивает голову туда на следующие два тика
c.actuator:attack(target)attackСобственный удар типа: взмах, наносящий урон от атаки моба, или 2 для типа, у которого её нет. Крипер вместо этого раздувается, пока вызов приходит каждый тик, и взрывается, когда раздулся полностью. На тике без вызова он сдувается
c.actuator:attack(target, damage)attackВзмах, наносящий столько урона
c.actuator:shoot(target)attackСобственный выстрел типа: стрела скелета, арбалет разбойника, зелье ведьмы, плевок ламы. false для типа, у которого его нет

flee, shoot и attack с уроном появились вместе с поведениями мобов и работают также в модулях поведения питомцев, где для flee нужно тело, прокладывающее пути, а для shoot — тело, тип которого стреляет.

Правила​

  • Вызывайте актуатор только из start, tick или stop поведения, в поведении, которое перечисляет нужный ему элемент управления.
  • Храните состояние каждого моба в c.memory, объявленной в memories, с именами, начинающимися с имени поведения.
  • Делайте коллбэки короткими. Поведения мобов работают в тех же пределах, что и модули поведения питомцев, и делят с ними 10 мс на тик.

Когда что-то не так​

Ничто из этого не останавливает сервер или других мобов. Ищите в консоли, не учитывая регистр, mob behavior.

  • Поведение не загружается. Файл, который не компилируется, чей id не совпадает с именем файла или в чьём имени есть другие символы, пропускается с предупреждением, называющим файл и причину. Все остальные файлы всё равно загружаются.
  • Команда или override_ai отказывает. Она говорит почему: имя поведения, которое не загрузилось, с перечнем тех, что загрузились, или сущность, которую нельзя переопределить.
  • Моб стоит на месте. Его поведениям нечего делать. Добавьте wander или проверьте, что вы в режиме выживания и не являетесь владельцем моба.
  • Коллбэк падает, пока мобы работают. Об этом сообщается один раз на коллбэк и вид сбоя до следующей перезагрузки. Поведение останавливается или не запускается и снова опрашивается при следующей проверке по probe_interval.
  • Моб не смог возобновить своё переопределение. Когда его чанк загружается, а одного из его поведений больше нет, консоль сообщает об этом, и моб сохраняет свой собственный ИИ. Переопределение возвращается, когда файл снова на месте и выполнен /fmm reload: сразу у загруженных мобов, а у остальных — когда они загружаются.

После исправления выполните /fmm reload.