视觉机制
视觉机制提供 BossBar、ActionBar 和 Title 三种消息展示方式，以及统一的消息队列系统。
BossBar 管理
你可以创建和管理 BossBar，按玩家独立控制显示/隐藏。
BossBar 字段
| 字段 | 默认值 | 说明 |
|---|---|---|
id | - | BossBar ID |
title | - | 显示标题 |
progress | 1.0 | 进度条（0.0 到 1.0） |
color | WHITE | 颜色 |
style | SOLID | 样式 |
操作
| 操作 | 说明 |
|---|---|
create | 创建一个 BossBar |
show | 向指定玩家显示 BossBar |
hide | 对指定玩家隐藏 BossBar |
update | 更新标题、进度、颜色等属性 |
ActionBar 消息
向玩家发送显示在物品栏上方的 ActionBar 消息。
| 参数 | 默认值 | 说明 |
|---|---|---|
playerId | - | 目标玩家 |
message | - | 消息内容 |
durationTicks | 40 | 显示时长（tick） |
Title 消息
向玩家发送屏幕中央的大标题和副标题。
| 参数 | 默认值 | 说明 |
|---|---|---|
playerId | - | 目标玩家 |
title | - | 主标题 |
subtitle | - | 副标题 |
fadeIn | 10 | 淡入时间（tick） |
stay | 40 | 停留时间（tick） |
fadeOut | 10 | 淡出时间（tick） |
消息队列
当多条消息同时需要展示时，消息队列会按优先级和时长依次显示，避免消息互相覆盖。
QueuedMessage 字段
| 字段 | 说明 |
|---|---|
type | 消息类型 |
priority | 优先级（数值越大越优先） |
duration | 显示时长 |
消息类型
| 类型 | 说明 |
|---|---|
ACTION_BAR | ActionBar 消息 |
TITLE | 主标题 |
SUBTITLE | 副标题 |
提示
消息队列会自动管理消息的显示顺序。高优先级的消息会优先展示，同优先级的消息按入队顺序依次显示。