Detection Activities

In addition to vision, the Vanilla extension provides several sensory-based detection activities. These activities proactive scan for nearby players based on specific conditions and trigger actions.

Common Features

All detection activities support the following:

One-Time Trigger: Actions are executed once when a player is first detected. The action will only trigger again if the player leaves the detection range and then returns.
Criteria: Filter which players can be detected.

Hearing Activity

Detects players who are moving or making noise nearby.

Entry ID: hearing_activity

Field	Type	Default	Description
`radius`	`Double`	`10.0`	Hearing range.
`triggers`	`List<Ref<TriggerableEntry>>`	`[]`	Actions to trigger when heard.
`criteria`	`List<Criteria>`	`[]`	Conditions for detection.

Smell Activity

Detects players within a certain radius.

Entry ID: smell_activity

Field	Type	Default	Description
`radius`	`Double`	`10.0`	Smell range.
`triggers`	`List<Ref<TriggerableEntry>>`	`[]`	Actions to trigger when smelled.
`criteria`	`List<Criteria>`	`[]`	Conditions for detection.

Equipment Detection Activity

Detects players wearing specific armor or holding specific items.

Entry ID: equipment_detection_activity

Field	Type	Default	Description
`material`	`Material`	`IRON_CHESTPLATE`	Material to detect.
`radius`	`Double`	`10.0`	Detection range.
`triggers`	`List<Ref<TriggerableEntry>>`	`[]`	Actions to trigger when detected.
`criteria`	`List<Criteria>`	`[]`	Conditions for detection.

Health Detection Activity

Detects players with health below a certain threshold.

Entry ID: health_detection_activity

Field	Type	Default	Description
`threshold`	`Double`	`10.0`	Health threshold (in half-hearts).
`radius`	`Double`	`10.0`	Detection range.
`triggers`	`List<Ref<TriggerableEntry>>`	`[]`	Actions to trigger when detected.
`criteria`	`List<Criteria>`	`[]`	Conditions for detection.

Invisible Player Detection Activity

Detects invisible players who are holding a revealing item.

Entry ID: invisible_player_detection_activity

Field	Type	Default	Description
`material`	`Material`	`GLOW_BERRIES`	Item the player must hold to be detected.
`radius`	`Double`	`10.0`	Detection range.
`detectionRadius`	`Double`	`30.0`	Origin return radius.
`triggers`	`List<Ref<TriggerableEntry>>`	`[]`	Actions to trigger when detected.
`criteria`	`List<Criteria>`	`[]`	Conditions for detection.

Common Features​

Hearing Activity​

Smell Activity​

Equipment Detection Activity​

Health Detection Activity​

Invisible Player Detection Activity​