Filtros

Un filtro es una pregunta de sí o no que el juego se hace sobre una criatura. "¿El atacante es un jugador?" "¿Es de día?" "¿Esta criatura está en el agua?" Si la respuesta es sí, el filtro se cumple y lo que protege puede ocurrir.

Los filtros aparecen por todas partes en los archivos de una criatura: en los eventos, en componentes como los sensores de daño y la selección de objetivos, y en las reglas de aparición. Apréndelos una vez y podrás usarlos en todas partes.

Los archivos

Los filtros no tienen un archivo propio. Van dentro de otros archivos, bajo claves llamadas filters (o biome_filter en las reglas de aparición).

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

Una prueba

El filtro más pequeño es una sola prueba (test):

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

Léelo como una frase: "¿La familia de la otra entidad es igual a player?"

Gracias a los valores por defecto, los filtros cortos son muy comunes:

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

El primero pregunta "¿es de día?". El segundo pregunta "¿esta criatura no está en el agua?".

Sujetos: a quién se pone a prueba

Qué sujetos tienen sentido depende de dónde esté el filtro. En un sensor de daño, other y damager son el atacante. En un comportamiento de selección de objetivos, other es la criatura que se está valorando como objetivo.

Operadores: cómo comparar

Los operadores de mayor/menor solo tienen sentido en pruebas de números como actor_health o distance_to_nearest_player.

Combinar pruebas

Junta varias pruebas con un grupo:

Los grupos pueden contener otros grupos, así que puedes construir cualquier regla que necesites. Este se cumple para un jugador que no va agachado, de noche o durante una tormenta eléctrica:

"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" }
      ]
    }
  ]
}

Dónde se usan los filtros

Sensor de daño: reacciona a quien te golpea

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

Solo los jugadores hacen enfadar al gólem. El daño de criaturas, caídas o fuego no hace nada especial. Consulta minecraft:damage_sensor.

Selección de objetivos: a quién atacar

"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
    }
  ]
}

El gólem caza monstruos, pero deja en paz a los creepers. Consulta behavior.nearest_attackable_target.

Sensor de entorno: reacciona al mundo

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

El sensor de entorno comprueba sus filtros todo el tiempo y dispara el evento mientras se cumplen.

Eventos y reglas de aparición

Dentro de los eventos, filters decide si una entrada se ejecuta (consulta Eventos de entidad). En las reglas de aparición, minecraft:biome_filter usa las mismas pruebas para elegir biomas (consulta Reglas de aparición).

Las pruebas más útiles

Hay más de cien pruebas. Estas son las que usarás más a menudo, agrupadas por lo que comprueban.

¿Quién es?

Vida y estado

Objetos

Dónde está

Distancia

Hora, tiempo y el mundo

Propiedades de entidad

Estas leen las propiedades declaradas en la descripción de la criatura. El nombre de la propiedad va en domain:

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

Cuando algo sale mal

Tienes más ayuda en Solución de problemas.