The agent¶
An Agent groups a Blackboard and a list of components (AgentComponent).
The built-in components are perception (the senses + their memory) and alert;
you can add your own.
flowchart LR
S[Senses<br/>hearing, sight, smell…] -->|StimulusInput| M[Memory]
M -->|best stimulus| A[Alert]
A -->|writes| B[(Blackboard)]
M -->|writes| B
B -->|read by| G[Goals<br/>listen, investigate, yours]
C[Your components] <-->|read / write| B
The builder¶
| Method | Effect |
|---|---|
.rules(SentienceRules) |
Your mod's perception rules (guide) |
.hearing(HearingProfile[, interest]) |
Hearing |
.sight(SightConfig) |
Sight |
.scent(ScentSense) |
Smell |
.damage() / .touch([targets]) |
Pain, touch |
.sense(SenseModule) |
Custom sense |
.memory(capacity, ticks) |
Memory size and duration (8 memories, 600 ticks) |
.awareness(AwarenessProfile) / .noAwareness() |
Alert levels |
.defaultGoals(priority, walk, run) |
Ready-to-use behaviours |
.searchDuration(ticks) |
Search duration before giving up (240) |
.component(AgentComponent) |
Custom component |
.build() |
Creates the agent and attaches it to the mob |
Lifecycle¶
| Moment | What happens |
|---|---|
build() |
onAttach on each component |
| The mob spawns / its chunk loads | onLoad: senses register themselves (e.g. with the hearing system) |
| Every server tick | tick(agent, world, deltaTicks), before the vanilla AI |
| Death / unload | onUnload |
Level of detail (LOD)¶
An agent far from every player thinks less often:
| Distance to the nearest player | Thinking |
|---|---|
| ≤ 32 blocks | every tick |
| ≤ 64 blocks | 1 tick in 2 |
| ≤ 128 blocks | 1 tick in 5 |
| beyond | 1 tick in 20 |
deltaTicks tells how many ticks have passed since the last think.
Any new perception forces a reaction on the next tick: a distant mob that hears an explosion
reacts immediately.
Events¶
agent.onStimulus((agent, stimulus) -> { ... }); // every perception
agent.onAwarenessChanged((agent, from, to) -> { ... }); // alert change