Class Entity

packages/core/src/ECS/Entity.ts:61–872

 * ```
 */
export class Entity {
    /**
     * @zh Entity专用日志器
     * @en Entity logger
     */
    private static _logger = createLogger('Entity');

    /**
     * @zh 实体名称
     * @en Entity name
     */
    public name: string;

    /**
     * @zh 实体唯一标识符（运行时ID），用于快速查找
     * @en Unique entity identifier (runtime ID) for fast lookups
     */
    public readonly id: number;

    /**
     * @zh 持久化唯一标识符（GUID）
     * @en Persistent unique identifier (GUID)
     *
     * @zh 用于序列化/反序列化时保持实体引用一致性，在场景保存和加载时保持不变
     * @en Used to maintain entity reference consistency during serialization/deserialization, remains stable across save/load cycles
     */
    public readonly persistentId: string;

    /**
     * @zh 轻量级实体句柄
     * @en Lightweight entity handle
     *
     * @zh 数值类型的实体标识符，包含索引和代数信息。
     * 用于高性能场景下替代对象引用，支持 Archetype 存储等优化。
     * @en Numeric identifier containing index and generation.
     * Used for high-performance scenarios instead of object references,
     * supports Archetype storage optimizations.
     */
    private _handle: EntityHandle = NULL_HANDLE;

    /**
     * @zh 所属场景引用
     * @en Reference to the owning scene
     */
    public scene: IScene | null = null;

    /**
     * @zh 销毁状态标志
     * @en Destroyed state flag
     */
    private _isDestroyed: boolean = false;

    /**
     * @zh 激活状态
     * @en Active state
     */
    private _active: boolean = true;