ArcartXEntityManager:实体管理器
实体管理器API
ArcartXEntityManager
- 实体管理器负责管理所有 ArcartX 实体对象和玩家对象的生命周期。
- 通过
ArcartXAPI.getEntityManager()获取。 - 实体缓存会按照配置的间隔自动清理已失效的实体，无需手动管理。
getPlayer(player)
- 获取玩家对应的ArcartX玩家管理对象，如果玩家是NPC则返回null
- 参数：
player: Player — Bukkit玩家对象 - 返回值：
ArcartXPlayer?— 玩家管理对象，可能为null - 调用示例
removePlayer(player)
- 移除玩家的ArcartX管理对象，同时会清除该玩家在其他玩家客户端上的控制器设置
- 参数：
player: Player — Bukkit玩家对象 - 返回值：无
- 调用示例
通常您不需要手动调用此方法，ArcartX会在玩家退出时自动处理。
getOrCreateEntity(entity)
- 获取或创建实体对应的ArcartX实体对象。如果传入的是玩家（非NPC），会自动返回ArcartXPlayer对象
- 参数：
entity: Entity — Bukkit实体对象 - 返回值：
ArcartXEntity?— 实体管理对象，可能为null - 调用示例
getEntity(uuid)
- 通过UUID获取已缓存的ArcartX实体对象，会优先查找玩家缓存
- 参数：
uuid: UUID — 实体UUID - 返回值：
ArcartXEntity?— 实体管理对象，可能为null - 调用示例
removeEntity(entity)
- 移除实体的ArcartX管理对象。如果传入的是玩家则不会执行任何操作
- 参数：
entity: Entity — Bukkit实体对象 - 返回值：无
- 调用示例