L'agent¶
Un Agent regroupe un Blackboard et une liste de composants (AgentComponent).
Les composants intégrés sont la perception (les sens + leur mémoire) et l'alerte ;
tu peux ajouter les tiens.
flowchart LR
S[Sens<br/>ouïe, vue, odorat…] -->|StimulusInput| M[Mémoire]
M -->|meilleur stimulus| A[Alerte]
A -->|écrit| B[(Blackboard)]
M -->|écrit| B
B -->|lu par| G[Goals<br/>écouter, aller voir, tes goals]
C[Tes composants] <-->|lit / écrit| B
Le builder¶
| Méthode | Effet |
|---|---|
.rules(SentienceRules) |
Règles de perception de ton mod (guide) |
.hearing(HearingProfile[, intérêt]) |
Ouïe |
.sight(SightConfig) |
Vue |
.scent(ScentSense) |
Odorat |
.damage() / .touch([cibles]) |
Douleur, toucher |
.sense(SenseModule) |
Sens personnalisé |
.memory(capacité, ticks) |
Taille et durée de la mémoire (8 souvenirs, 600 ticks) |
.awareness(AwarenessProfile) / .noAwareness() |
Niveaux d'alerte |
.defaultGoals(priorité, marche, course) |
Comportements prêts à l'emploi |
.searchDuration(ticks) |
Durée de fouille avant abandon (240) |
.component(AgentComponent) |
Composant personnalisé |
.build() |
Crée l'agent et l'attache au mob |
Cycle de vie¶
| Moment | Ce qui se passe |
|---|---|
build() |
onAttach sur chaque composant |
| Le mob apparaît / son chunk se charge | onLoad : les sens s'enregistrent (ex. auprès du système d'ouïe) |
| Chaque tick serveur | tick(agent, world, deltaTicks), avant l'IA vanilla |
| Mort / déchargement | onUnload |
Niveau de détail (LOD)¶
Un agent loin de tout joueur réfléchit moins souvent :
| Distance au joueur le plus proche | Réflexion |
|---|---|
| ≤ 32 blocs | chaque tick |
| ≤ 64 blocs | 1 tick sur 2 |
| ≤ 128 blocs | 1 tick sur 5 |
| au-delà | 1 tick sur 20 |
deltaTicks indique combien de ticks se sont écoulés depuis la dernière réflexion.
Toute nouvelle perception force une réaction au tick suivant : un mob lointain qui entend une explosion
réagit immédiatement.
Événements¶
agent.onStimulus((agent, stimulus) -> { ... }); // chaque perception
agent.onAwarenessChanged((agent, from, to) -> { ... }); // changement d'alerte