Поведения мобов
Поведение моба — это 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_distance | 6 | Как далеко должен отойти владелец, чтобы моб пошёл за ним |
follow_stop | 3 | Как близко он подходит |
follow_speed | 1.2 | Скорость при следовании |
chase_speed | 1.3 | Скорость в бою |
reach | 2.2 | Как близко он подходит, чтобы ударить |
fuse_distance | 3 | Крипер начинает поджигать фитиль, когда оказывается на таком расстоянии от цели |
fuse_escape | 7 | Фитиль крипера гаснет, когда цель отходит на такое расстояние или пропадает из виду |
shoot_distance | 12 | Моб, который стреляет, делает это с такого расстояния и ближе, пока видит цель |
attack_ticks | 20 | Время между двумя ударами или выстрелами |
assist | true | Также сражается с теми, кого ранит владелец |
defend_itself | true | Также сражается с теми, кто ранит его самого |
hostile
Он атакует того, кто ранил его за последние 10 секунд, а иначе ближайшую цель в пределах range. Новую цель он ищет каждые 10 тиков. Если у него есть владелец, он щадит его и других мобов, которые ему служат.
| Настройка | По умолчанию | Значение |
|---|---|---|
targets | player | player, hostile, passive, living или тип сущности, например zombie |
range | 16 | Как далеко он замечает цели |
damage | 0 | Сколько наносит удар. 0 оставляет это собственной атаке моба, которая равна 2 для типа, у которого её нет, например для курицы |
chase_speed, reach, fuse_distance, fuse_escape, shoot_distance, attack_ticks | как у guardian | Как в guardian |
coward
Он начинает бежать, когда то, чего он боится, оказывается в пределах range, и останавливается, когда оно отходит на safe_distance. Он также бежит от того, кто ранил его за последние 10 секунд, пока этот нападающий находится в пределах range, а когда моб уже бежит, — в пределах safe_distance. Убегая, он каждый раз прокладывает путь примерно в десять блоков прочь от источника испуга. В комнате или загоне, где нет такого длинного выхода, он отступает к дальней стене.
| Настройка | По умолчанию | Значение |
|---|---|---|
fears | player | player, hostile, passive, living или тип сущности, например wolf |
range | 10 | Как близко должен подойти источник испуга, чтобы моб побежал |
safe_distance | 16 | На каком расстоянии он перестаёт бежать |
speed | 1.5 | Скорость при беге |
cornered_distance | 6 | Как далеко он пытается отступить там, где не находит выхода |
wander
Он выбирает точку не дальше radius блоков, идёт туда, затем отдыхает. Любое другое поставляемое поведение сразу забирает у него моба.
| Настройка | По умолчанию | Значение |
|---|---|---|
radius | 8 | Как далеко заходит прогулка |
speed | 1 | Скорость при прогулке |
rest_ticks | 60 | Отдых после прогулки |
rest_random_ticks | 120 | Случайное число тиков от 0 до этого значения минус один, добавляемое к каждому отдыху |
walk_ticks | 200 | Прогулка, которую он не может закончить, прекращается по истечении этого времени |
Из Lua-скрипта
В каждом Lua-скрипте, который выполняет FreeMinecraftModels, у таблицы сущности моба есть ещё три члена. У таблиц игроков их нет.
| Член | Возвращает | Описание |
|---|---|---|
mob:override_ai(behaviors, options?) | true либо false и причину | Переопределяет ИИ моба. behaviors — одно имя или список имён. Если у моба уже есть переопределение, это заменяет его |
mob:restore_ai() | bool | Возвращает мобу его собственный ИИ. true, если переопределение было |
mob.ai_overridden | bool | Выполняет ли моб переопределение сейчас |
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.memory | get(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.