Aller au contenu

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

Accès

Agent agent = Agent.of(entity);                 // null si l'entité n'a pas d'agent
agent.mob(); agent.rules(); agent.blackboard();
agent.perception();                             // sens + mémoire
agent.awareness();                              // niveau d'alerte
agent.find(MonComposant.class);                 // un composant précis
agent.thinkInterval();                          // LOD actuel