Фильтры

Фильтр - это вопрос с ответом «да» или «нет», который игра задаёт о мобе. «Атакующий - игрок?» «Сейчас день?» «Этот моб в воде?» Если ответ «да», фильтр проходит, и то, что он охраняет, может произойти.

Фильтры встречаются во всех файлах моба: в событиях, в компонентах вроде датчиков урона и выбора цели и в правилах появления. Разберитесь в них один раз, и сможете использовать их везде.

Файлы

У фильтров нет своего файла. Они находятся внутри других файлов, под ключами filters (или biome_filter в правилах появления).

BP/
  entities/
    ruby_golem.json      <- in events and many components
  spawn_rules/
    ruby_golem.json      <- minecraft:biome_filter

Одна проверка

Самый маленький фильтр - это одна проверка (test):

{ "test": "is_family", "subject": "other", "operator": "==", "value": "player" }

Читайте её как предложение: «Семейство (family) другой (other) сущности равно player?»

Благодаря значениям по умолчанию короткие фильтры встречаются часто:

{ "test": "is_daytime" }
{ "test": "in_water", "value": false }
{ "test": "has_tag", "value": "wiki:tamed" }

Первый спрашивает «сейчас день?». Второй спрашивает «этот моб не в воде?».

Субъекты: кого проверяем

Какие субъекты имеют смысл, зависит от того, где стоит фильтр. В датчике урона other и damager - это атакующий. В поведении выбора цели other - это моб, которого рассматривают как цель.

Операторы: как сравнивать

Операторы «больше/меньше» имеют смысл только для числовых проверок, таких как actor_health или distance_to_nearest_player.

Объединение проверок

Несколько проверок объединяются в группу:

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

"filters": {
  "all_of": [
    { "test": "is_family", "subject": "other", "value": "player" },
    { "test": "is_sneaking", "subject": "other", "value": false },
    {
      "any_of": [
        { "test": "is_daytime", "value": false },
        { "test": "weather_at_position", "value": "thunderstorm" }
      ]
    }
  ]
}

Где используются фильтры

Датчик урона: реакция на того, кто ударил

"minecraft:damage_sensor": {
  "triggers": [
    {
      "on_damage": {
        "filters": { "test": "is_family", "subject": "other", "value": "player" },
        "event": "wiki:become_angry"
      }
    }
  ]
}

Злить голема могут только игроки. Урон от мобов, падения или огня ничего особенного не вызывает. См. minecraft:damage_sensor.

Выбор цели: кого атаковать

"minecraft:behavior.nearest_attackable_target": {
  "priority": 2,
  "entity_types": [
    {
      "filters": {
        "all_of": [
          { "test": "is_family", "subject": "other", "value": "monster" },
          { "test": "is_family", "subject": "other", "operator": "not", "value": "creeper" }
        ]
      },
      "max_dist": 16
    }
  ]
}

Голем охотится на монстров, но не трогает криперов. См. behavior.nearest_attackable_target.

Датчик окружения: реакция на мир

"minecraft:environment_sensor": {
  "triggers": [
    {
      "filters": { "test": "in_water" },
      "event": "wiki:start_rusting"
    }
  ]
}

Датчик окружения постоянно проверяет свои фильтры и вызывает событие, пока они проходят.

События и правила появления

Внутри событий filters решают, выполнится ли запись (см. События сущностей). В правилах появления minecraft:biome_filter использует те же проверки для выбора биомов (см. Правила появления).

Самые полезные проверки

Всего проверок больше сотни. Вот те, которые вам понадобятся чаще всего, сгруппированные по тому, что они проверяют.

Кто это?

Здоровье и состояние

Предметы

Где он находится

Расстояние

Время, погода и мир

Свойства сущности

Эти проверки читают свойства, объявленные в description моба. Имя свойства пишется в domain:

{ "test": "enum_property", "domain": "wiki:mood", "value": "angry" }

Если что-то пошло не так

Больше помощи в разделе Когда что-то сломалось.