Class World

constructor

• new World(): World

  Returns World

frame

entityCount

• get entityCount(): number

  Get total entity count 获取实体总数

  Returns number

_enterIteration

• _enterIteration(): void

  Enter iteration period (called by Query.forEach internally) 进入遍历期（Query.forEach内部调用）

  Returns void

_leaveIteration

• _leaveIteration(): void

  Leave iteration period (called by Query.forEach internally) 离开遍历期（Query.forEach内部调用）

  Returns void

add

• add<T extends Component>(
      e: number,
      ctor: ComponentCtor<T>,
      data?: Partial<T>,
  ): void

  Convenience method: add component by constructor 便捷方法：通过构造函数添加组件

  Type Parameters

  • T extends Component

  Parameters

  • e: number
  • ctor: ComponentCtor<T>
  • Optionaldata: Partial<T>

  Returns void

addComponent

• addComponent<T>(e: number, ctor: ComponentCtor<T>, data?: Partial<T>): void

  Add component to entity (convenience method) 向实体添加组件（便捷方法）

  Type Parameters

  • T

  Parameters

  • e: number
  • ctor: ComponentCtor<T>
  • Optionaldata: Partial<T>

  Returns void

addComponentToEntity

• addComponentToEntity<T>(e: number, type: ComponentType<T>, c: T): void

  Add component to entity 向实体添加组件

  Type Parameters

  • T

  Parameters

  • e: number
  • type: ComponentType<T>
  • c: T

  Returns void

addTag

• addTag(e: number, name: string): void

  Add tag to entity 为实体添加标签

  Parameters

  • e: number
  • name: string

  Returns void

aliveCount

• aliveCount(): number

  Get number of alive entities 获取存活实体数量

  Returns number

beginFrame

• beginFrame(): void

  Begin new frame (call at start of main loop) 开始新帧（在主循环开始时调用）

  Returns void

clearEntityTags

• clearEntityTags(e: number): void

  Remove all tags from entity 移除实体的所有标签

  Parameters

  • e: number

  Returns void

cmd

• cmd(): CommandBuffer

  Create command buffer for deferred operations 创建命令缓冲区用于延迟操作

  Returns CommandBuffer

createEntity

• createEntity(enabled?: boolean): number

  Create new entity 创建新实体

  Parameters

  • enabled: boolean = true

  Returns number

createTagMask

• createTagMask(tagNames: string[]): TagBitSet

  Create tag mask for multiple tag names 为多个标签名称创建掩码

  Parameters

  • tagNames: string[]

  Returns TagBitSet

debugListStores

• debugListStores(): { size: number; typeId: number }[]

  Debug method: list all component stores with their sizes 调试方法：列出所有组件存储及其大小

  Returns { size: number; typeId: number }[]

destroyEntity

• destroyEntity(e: number): void

  Destroy entity and remove all its components 销毁实体并移除其所有组件

  Parameters

  • e: number

  Returns void

entityHasComponent

• entityHasComponent<T>(e: number, type: ComponentType<T>): boolean

  Check if entity has component 检查实体是否拥有组件

  Type Parameters

  • T

  Parameters

  • e: number
  • type: ComponentType<T>

  Returns boolean

epoch

• epoch(): number

  Get current epoch/frame number for change tracking 获取当前时代/帧号用于变更追踪

  Returns number

flush

• flush(cmd: CommandBuffer): void

  Apply command buffer immediately 立即应用命令缓冲

  Parameters

  • cmd: CommandBuffer

  Returns void

getActiveComponentTypes

• getActiveComponentTypes(): number[]

  Get all component type IDs that have active stores 获取所有有活动存储的组件类型ID

  Returns number[]

getAddedChannel

• getAddedChannel(): EventChannel<Added>

  Get event channel for Added events 获取Added事件通道

  Returns EventChannel<Added>

getAllAliveEntities

• getAllAliveEntities(): number[]

  Get all alive entities 获取所有存活的实体

  Returns number[]

getArchetypeIndex

• getArchetypeIndex(): ArchetypeIndex

  Get archetype index for query optimization 获取原型索引用于查询优化

  Returns ArchetypeIndex

getComponent

• getComponent<T>(e: number, ctor: ComponentCtor<T>): undefined | T

  Get component from entity (convenience method) 从实体获取组件（便捷方法）

  Type Parameters

  • T

  Parameters

  • e: number
  • ctor: ComponentCtor<T>

  Returns undefined | T

getEntitiesWithTag

• getEntitiesWithTag(name: string): number[]

  Get entities that have specific tag 获取具有特定标签的实体

  Parameters

  • name: string

  Returns number[]

getEntityComponent

• getEntityComponent<T>(e: number, type: ComponentType<T>): undefined | T

  Get component from entity 从实体获取组件

  Type Parameters

  • T

  Parameters

  • e: number
  • type: ComponentType<T>

  Returns undefined | T

getEntityComponents

• getEntityComponents(e: number): Component[]

  Get all components of entity 获取实体的所有组件

  Parameters

  • e: number

  Returns Component[]

getEntityComponentsWithTypeIds

• getEntityComponentsWithTypeIds(
      e: number,
  ): { component: unknown; typeId: number }[]

  Get all components with their type IDs for an entity 获取实体的所有组件及其类型ID

  Parameters

  • e: number

  Returns { component: unknown; typeId: number }[]

getEntityTagBits

• getEntityTagBits(e: number): undefined | TagBitSet

  Get entity's tag bit set 获取实体的标签位集

  Parameters

  • e: number

  Returns undefined | TagBitSet

getEntityTags

• getEntityTags(e: number): string[]

  Get all tag names for an entity 获取实体的所有标签名称

  Parameters

  • e: number

  Returns string[]

getRemovedChannel

• getRemovedChannel(): EventChannel<Removed>

  Get event channel for Removed events 获取Removed事件通道

  Returns EventChannel<Removed>

getResource

• getResource<T>(key: new (...args: any[]) => T): undefined | T

  Get a resource by key 通过键获取资源

  Type Parameters

  • T

  Parameters

  • key: new (...args: any[]) => T

  Returns undefined | T

getSignature

• getSignature(e: number): Bitset

  Get entity signature (component bitset) 获取实体签名（组件位集）

  Parameters

  • e: number

  Returns Bitset

getStore

• getStore<T>(type: ComponentType<T>): undefined | IComponentStore<T>

  Get component store for type (used by Query) 获取类型的组件存储（供Query使用）

  Type Parameters

  • T

  Parameters

  • type: ComponentType<T>

  Returns undefined | IComponentStore<T>

getTagMaskManager

• getTagMaskManager(): TagMaskManager

  Get tag mask manager for bit operations 获取标签掩码管理器用于位操作

  Returns TagMaskManager

hasComponent

• hasComponent<T>(e: number, ctor: ComponentCtor<T>): boolean

  Check if entity has component (convenience method) 检查实体是否有组件（便捷方法）

  Type Parameters

  • T

  Parameters

  • e: number
  • ctor: ComponentCtor<T>

  Returns boolean

hasTag

• hasTag(e: number, name: string): boolean

  Check if entity has tag 检查实体是否具有标签

  Parameters

  • e: number
  • name: string

  Returns boolean

isAlive

• isAlive(entity: number): boolean

  Check if entity is alive 检查实体是否存活

  Parameters

  • entity: number

  Returns boolean

isEnabled

• isEnabled(entity: number): boolean

  Check if entity is enabled 检查实体是否启用

  Parameters

  • entity: number

  Returns boolean

markChanged

• markChanged<T>(e: number, ctor: ComponentCtor<T>): void

  Manually mark component as changed - call after modifying component fields in systems 手动标记某组件"已被修改"——在系统里改了字段后调用

  Type Parameters

  • T

  Parameters

  • e: number
  • ctor: ComponentCtor<T>

  Returns void

query

• query<T1>(c1: ComponentCtor<T1>): Query<[T1]>

  Create query for required components 为必需组件创建查询

  Type Parameters

  • T1

  Parameters

  • c1: ComponentCtor<T1>

  Returns Query<[T1]>

• query<T1, T2>(c1: ComponentCtor<T1>, c2: ComponentCtor<T2>): Query<[T1, T2]>

  Create query for required components 为必需组件创建查询

  Type Parameters

  • T1
  • T2

  Parameters

  • c1: ComponentCtor<T1>
  • c2: ComponentCtor<T2>

  Returns Query<[T1, T2]>

• query<T1, T2, T3>(
      c1: ComponentCtor<T1>,
      c2: ComponentCtor<T2>,
      c3: ComponentCtor<T3>,
  ): Query<[T1, T2, T3]>

  Create query for required components 为必需组件创建查询

  Type Parameters

  • T1
  • T2
  • T3

  Parameters

  • c1: ComponentCtor<T1>
  • c2: ComponentCtor<T2>
  • c3: ComponentCtor<T3>

  Returns Query<[T1, T2, T3]>

registerQueryForDelta

• registerQueryForDelta(query: Query<unknown[]>): void

  Register query for delta notifications 注册查询以接收增量通知

  Parameters

  • query: Query<unknown[]>

  Returns void

removeComponent

• removeComponent<T>(e: number, ctor: ComponentCtor<T>): void

  Remove component from entity (convenience method) 从实体移除组件（便捷方法）

  Type Parameters

  • T

  Parameters

  • e: number
  • ctor: ComponentCtor<T>

  Returns void

removeComponentFromEntity

• removeComponentFromEntity<T>(e: number, type: ComponentType<T>): void

  Remove component from entity 从实体移除组件

  Type Parameters

  • T

  Parameters

  • e: number
  • type: ComponentType<T>

  Returns void

removeTag

• removeTag(e: number, name: string): void

  Remove tag from entity 从实体移除标签

  Parameters

  • e: number
  • name: string

  Returns void

setComponent

• setComponent<T>(e: number, ctor: ComponentCtor<T>, data: T): void

  Set component data for entity (convenience method) 为实体设置组件数据（便捷方法）

  Type Parameters

  • T

  Parameters

  • e: number
  • ctor: ComponentCtor<T>
  • data: T

  Returns void

setEnabled

• setEnabled(entity: number, enabled: boolean): void

  Set entity enabled state 设置实体启用状态

  Parameters

  • entity: number
  • enabled: boolean

  Returns void

setResource

• setResource<T>(key: new (...args: any[]) => T, val: T): void

  Set a resource by key 通过键设置资源

  Type Parameters

  • T

  Parameters

  • key: new (...args: any[]) => T
  • val: T

  Returns void

unregisterQueryForDelta

• unregisterQueryForDelta(query: Query<unknown[]>): void

  Unregister query from delta notifications 取消注册查询的增量通知

  Parameters

  • query: Query<unknown[]>

  Returns void