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

ActionbarHudRenderer

object ActionbarHudRenderer : BaseContainer<HudLayoutBinding> (source)

按玩家维护 ActionBar 布局；允许外部文本在短时间内占用显示。 Maintains per-player ActionBar layouts and supports temporary external text.

Functions

addPlayer

fun addPlayer(player: Player)

为玩家创建 ActionBar 布局上下文。 / Creates an ActionBar layout context for a player.

appendLayout

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

渲染并追加一个已注册布局。 / Renders and appends a registered layout.

appendLayoutRaw

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

追加已编码的原始文本组件。 / Appends an already encoded raw component.

clear

@Synchronized

fun clear()

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

clearAll

fun clearAll()

停止 ActionBar 更新并清空全部玩家上下文。 Stops ActionBar updates and clears every player context.

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.

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.

receiveExternalActionbar

fun receiveExternalActionbar(player: Player, text: String, ttlMillis: Long = 2000)

暂时接收外部 ActionBar 文本；到期后不再合入布局变量 @actionbar。 Temporarily accepts external ActionBar text for the @actionbar variable.

removeLayout

fun removeLayout(player: Player, layoutId: String)

按布局 ID 移除玩家的内容。 / Removes a player’s content by layout ID.

removePlayer

fun removePlayer(playerUid: UUID)

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

runTask

fun runTask()

values

@Synchronized

fun values(): Collection<HudLayoutBinding>

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