Requêtes d'environnement (EQS)¶
Une requête d'environnement (l'Environment Query System d'Unreal) répond à des questions comme « où me cacher ? », « où m'abriter ? », « par où la contourner ? ». Elle :
- génère des points candidats autour d'une cible (posés au sol, là où un mob tient debout) ;
- les filtre et les note avec des tests ;
- renvoie le meilleur, en vérifiant au besoin qu'on peut l'atteindre.
Requêtes intégrées¶
La menace est la cible vue avec certitude, sinon la position du focus.
| Identifiant | Trouve |
|---|---|
sentience:hide |
un endroit proche où la menace ne te voit pas, plutôt loin d'elle |
sentience:cover |
un abri tout proche, avec un bloc solide entre toi et la menace |
sentience:flank |
un point sur le côté de la menace, pour la contourner |
sentience:flee |
un point loin de la menace, hors de sa vue si possible |
Dans un Behavior Tree :
{ "type": "run_query", "query": "sentience:hide", "result": "monmod:cachette" },
{ "type": "move_to", "target": "monmod:cachette", "speed": 1.4 }
run_query échoue s'il n'y a aucun point valable : la séquence s'arrête et l'arbre passe à autre chose.
Écrire une requête en JSON¶
Fichier data/monmod/sentience/env_query/coin_sombre.json → identifiant monmod:coin_sombre.
{
"generator": { "type": "ring", "center": "querier", "radius": [4, 14], "rings": 3, "points": 10 },
"tests": [
{ "type": "light", "max": 9, "weight": 2, "prefer": "low" },
{ "type": "visible_from", "target": "threat", "max": 0 },
{ "type": "distance", "target": "querier", "weight": 0.5, "prefer": "high" }
],
"pathable": true
}
Générateurs¶
| Type | Paramètres |
|---|---|
ring |
center, radius (nombre ou [min, max]), rings (3), points par anneau (12) |
grid |
center, radius (10), spacing (2) |
Cibles¶
querier (l'agent), threat (la menace), focus (position du focus) ou l'identifiant d'une clé
du Blackboard.
Tests¶
| Type | Mesure |
|---|---|
distance |
distance entre le point et target |
visible_from |
1 si target voit le point (à hauteur de tête, à travers le verre), 0 sinon |
cover |
1 si un bloc solide protège le point du côté de target |
dot |
cosinus de l'angle, vu de from, entre le point et to (1 = même direction, 0 = de côté) |
light |
lumière au point (0-15) |
random |
valeur aléatoire, pour départager |
Chaque test peut :
- filtrer :
minet/oumaxéliminent les points hors de l'intervalle ; - noter :
weight(0 = filtre seul) etprefer(highoulow). Les valeurs sont normalisées entre 0 et 1 sur les points restants, puis additionnées.
"pathable": true garde seulement un point atteignable : le chemin n'est calculé que pour les
meilleurs points, jusqu'à en trouver un.
En Java¶
public static final EnvQuery CACHETTE = EnvQueries.register(Identifier.of("monmod", "cachette"),
EnvQuery.builder(QueryGenerator.ring(QueryTarget.QUERIER, 4, 16, 3, 12))
.test(QueryTest.visibleFrom(QueryTarget.THREAT).atMost(0)) // filtre : caché
.test(QueryTest.distance(QueryTarget.THREAT).preferHigh(1)) // loin de la menace
.test(QueryTest.distance(QueryTarget.QUERIER).preferLow(1.5)) // pas trop loin de moi
.pathable()
.build());
Vec3d spot = CACHETTE.run(agent).best(); // null si rien ne convient
Une mesure personnalisée est une fonction qui reçoit l'agent et le monde, et renvoie la mesure de chaque point :
QueryTest.of((agent, world) -> point -> world.getBlockState(BlockPos.ofFloored(point).down()).isOf(Blocks.GRASS_BLOCK) ? 1 : 0)
.preferHigh(1);
Debug¶
Avec /sentience debug, chaque requête affiche ses points : gris = éliminés, verts = retenus,
et des étincelles sur le meilleur.
Performances¶
Une requête coûte quelques dizaines de tests de bloc ou de ligne de vue, et quelques calculs de chemin
avec pathable. Lance-la à l'entrée d'une branche (run_query) ou avec un service espacé (20 ticks ou plus),
pas à chaque tick.