Gameplay components

Every field below is derived from the engine’s own component registry — the same one the editor’s Details panel reads — so the types and defaults here are the values you get when you add the component, and they cannot drift from the code. The prose that explains how to use each one lives in the guides linked per entry.

AudioListenerAudioSourceBehaviorTreeAgentEventBindingNavAgentNetGhostPerceiverPerceptionPerceptionTargetReplicatedStateMachineAgent

AudioListener

The ear spatial audio is mixed relative to — usually the camera or the player.

Explained in assets/audio.

Field	Type	Default	Notes
enabled	boolean	true

AudioSource

Declarative playback attached to an entity, attenuated by distance when spatial.

Explained in assets/audio.

Field	Type	Default	Notes
clip	Asset<audio>	none
bus	string	"sfx"
volume	number	1
pitch	number	1
loop	boolean	false
playOnAwake	boolean	false
spatial	boolean	false
minDistance	number	100
maxDistance	number	1000
attenuationModel	number	1
rolloff	number	1
priority	number	0
enabled	boolean	true

BehaviorTreeAgent

Ticks a behavior tree asset against a blackboard, calling registry actions at its leaves.

Explained in gameplay/ai/behavior-trees.

Field	Type	Default	Notes
bt	Asset<behaviortree>	none
status	string	empty	Last root status (runtime, read-only).

EventBinding

Wires an event on this entity to named actions — gameplay authored in the inspector, with no script.

Explained in scripting/events.

Field	Type	Default	Notes
rows	array	empty

NavAgent

Steers an entity along a path found on the navigation grid.

Explained in gameplay/ai/navigation.

Field	Type	Default	Notes
speed	number	120	Range ≥ 0.
radius	number	0	Range ≥ 0.
arriveRadius	number	6	Range ≥ 0.
repathInterval	number	0.5	Replan cadence while moving; 0 = only when the target changes. Range ≥ 0.
hasTarget	boolean	false
targetX	number	0
targetY	number	0
arrived	boolean	false

NetGhost

Tag: this entity is a client-side proxy of one the server owns.

Explained in scripting/networking.

A tag — it carries no fields.

Perceiver

Senses nearby perception targets within a sight cone and range.

Explained in gameplay/ai/perception.

Field	Type	Default	Notes
range	number	220	Range ≥ 0.
fovDegrees	number	360	Range 0–360.

Perceptiontransient

What a perceiver currently sees — written each frame for the entity's own logic to read.

Explained in gameplay/ai/perception.

Field	Type	Default	Notes
visible	boolean	false	A target is seen (runtime, read-only).
distance	number	0
targetX	number	0
targetY	number	0
dirX	number	0
dirY	number	0

PerceptionTarget

Tag: perceivers can see this entity.

Explained in gameplay/ai/perception.

A tag — it carries no fields.

Replicated

Marks an entity the server replicates to every client.

Explained in scripting/networking.

Field	Type	Default	Notes
netId	number	0
owner	number	0

StateMachineAgent

Runs a gameplay state machine asset, calling registry actions as states enter, update and exit.

Explained in gameplay/ai/state-machines.

Field	Type	Default	Notes
fsm	Asset<statemachine>	none
current	string	empty	Active state (runtime, read-only).