Xerr API/com.hiusers.xerr.api.container/BossbarHudRenderer

BossbarHudRenderer

object BossbarHudRenderer : BaseContainer<HudLayoutBinding> (source)

为每个玩家管理布局 BossBar 与刷新任务。 Manages layout BossBars and refresh tasks for each player.

Functions

addPlayer

fun addPlayer(player: Player)

让玩家开始显示布局 BossBar。 / Starts layout BossBar rendering for a player.

appendLayout

fun appendLayout(player: Player, layoutId: String, variables: Map<String, String> = mapOf())

为玩家追加并立即渲染一个布局。 / Appends and renders a layout for a player.

appendLayoutRaw

fun appendLayoutRaw(player: Player, layoutId: String, raw: String)

追加原始文本组件，适合已有编码内容。 / Appends an already encoded raw component.

clear

@Synchronized

fun clear()

清空当前容器。 / Clears this registry.

clearBossBars

fun clearBossBars()

取消任务并清除所有玩家的 BossBar。 / Cancels the task and clears all player BossBars.

get

@Synchronized

fun get(key: String): HudLayoutBinding?

按 ID 查找实体；不存在时返回 null。 / Looks up an entity by ID, or returns null.

getAll

@Synchronized

fun getAll(): Map<String, HudLayoutBinding>

返回 ID 到实体的映射快照。 / Returns a snapshot of the ID-to-entity map.

getBossbarContext

fun getBossbarContext(player: Player): BossbarHudContext

获取或创建玩家的 BossBar 上下文。 / Gets or creates a player’s BossBar context.

keys

@Synchronized

fun keys(): Set<String>

返回已注册 ID 的快照。 / Returns a snapshot of registered IDs.

put

@Synchronized

fun put(key: String, value: HudLayoutBinding)

按 ID 注册或替换实体。 / Registers or replaces an entity by ID.

removeLayout

fun removeLayout(player: Player, layoutId: String)

从玩家的 BossBar 内容中移除布局。 / Removes a layout from a player’s BossBar content.

removePlayer

fun removePlayer(playerUid: UUID)

移除玩家的 BossBar 并取消未完成的刷新。 / Removes the player’s BossBar and invalidates pending refreshes.

runTask

fun runTask()

启动 BossBar 的周期刷新任务；一般由 Xerr 加载器调用。 Starts periodic BossBar refresh; normally invoked by Xerr’s loader.

values

@Synchronized

fun values(): Collection<HudLayoutBinding>

返回实体列表快照。 / Returns a snapshot of the entities.