玩法组件

下面每个字段都由引擎自身的组件注册表推导而来——就是编辑器 Details 面板读的那一份—— 所以这里的类型和默认值就是你添加组件时真正拿到的值，且不可能与代码脱节。讲怎么用的正文在 每条目所链接的指南里。字段说明取自 C++ ES_PROPERTY 处的原文，因此为英文。

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).