Filtres

Un filtre est une question à laquelle on répond par oui ou par non, que le jeu se pose sur une créature. « L'attaquant est-il un joueur ? » « Fait-il jour ? » « Cette créature est-elle dans l'eau ? » Si la réponse est oui, le filtre passe et ce qu'il protège peut se produire.

Les filtres apparaissent partout dans les fichiers d'une créature : dans les événements, dans des composants comme les capteurs de dégâts et le ciblage, et dans les règles d'apparition. Apprends-les une fois et tu pourras t'en servir partout.

Les fichiers

Les filtres n'ont pas de fichier à eux. Ils se trouvent à l'intérieur d'autres fichiers, sous des clés nommées filters (ou biome_filter dans les règles d'apparition).

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

Un seul test

Le plus petit filtre est un seul test :

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

Lis-le comme une phrase : « La famille de l'entité other est-elle égale à player ? »

Grâce aux valeurs par défaut, les filtres courts sont fréquents :

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

Le premier demande « fait-il jour ? ». Le deuxième demande « cette créature n'est-elle pas dans l'eau ? ».

Sujets : qui est testé

Les sujets qui ont du sens dépendent de l'endroit où se trouve le filtre. Dans un capteur de dégâts, other et damager désignent l'attaquant. Dans un comportement de ciblage, other est la créature envisagée comme cible.

Opérateurs : comment comparer

Les opérateurs supérieur/inférieur n'ont de sens que pour les tests de nombres comme actor_health ou distance_to_nearest_player.

Combiner des tests

Rassemble plusieurs tests dans un groupe :

Les groupes peuvent contenir d'autres groupes, donc tu peux construire n'importe quelle règle. Celle-ci passe pour un joueur qui ne s'accroupit pas, la nuit ou pendant un orage :

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

Où on utilise les filtres

Capteur de dégâts : réagir à qui t'a frappé

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

Seuls les joueurs mettent le golem en colère. Les dégâts des créatures, des chutes ou du feu ne font rien de spécial. Voir minecraft:damage_sensor.

Ciblage : qui attaquer

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

Le golem chasse les monstres, mais laisse les creepers tranquilles. Voir behavior.nearest_attackable_target.

Capteur d'environnement : réagir au monde

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

Le capteur d'environnement vérifie ses filtres en permanence et déclenche l'événement tant qu'ils passent.

Événements et règles d'apparition

Dans les événements, filters décide si une entrée s'exécute (voir Événements d'entité). Dans les règles d'apparition, minecraft:biome_filter utilise les mêmes tests pour choisir les biomes (voir Règles d'apparition).

Les tests les plus utiles

Il existe plus d'une centaine de tests. Voici ceux dont tu te serviras le plus souvent, rangés selon ce qu'ils vérifient.

Qui est-ce ?

Santé et état

Objets

Où il se trouve

Distance

Heure, météo et monde

Propriétés d'entité

Ces tests lisent les propriétés déclarées dans la description de la créature. Le nom de la propriété va dans domain :

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

Quand quelque chose ne va pas

Plus d'aide dans Dépannage.