动画配置
设置图标和标题的帧列表、播放模式与停留时间。
图标动画
图标的 frames 每项填写变化的显示属性，未填写的属性沿用默认外观：
# 一个图标的动画片段
material: PAPER
name: '&f状态'
frames-prop:
mode: LOOP
period: 20
frames:
- name: '&a开启'
glow: true
delay: 40
- name: '&7等待'
glow: false第一帧停留 40 tick，第二帧使用默认 20 tick。action 配置在图标层，与 frames 同级。
| 字段 | 类型 | 必填 | 默认行为 | 说明 |
|---|---|---|---|---|
frames | 显示属性对象列表 | 否 | 无动画 | 写在图标下，每项是一帧 |
frames-prop（framesProperties、frames-properties、prop） | 动画设置对象 | 否 | 间隔 20 tick，模式 LOOP | 与 frames 同级，统一设置间隔和模式 |
写在 frames-prop 中：
| 字段 | 类型 | 必填 | 默认行为 | 说明 |
|---|---|---|---|---|
delay（period、default-delay、last） | 整数 | 否 | 20 tick | 默认帧停留时间 |
mode（type） | 文字 | 否 | LOOP | 播放模式，见下文 |
写在 frames 的每一项中：
| 字段 | 类型 | 必填 | 默认行为 | 说明 |
|---|---|---|---|---|
delay（last） | 整数 | 否 | 使用 frames-prop.delay，未设置时为 20 tick | 当前帧停留时间，覆盖统一间隔 |
其他帧字段使用物品属性的写法；未填写的属性沿用图标默认外观。
上例 period 与 delay 是同一字段的不同名称，只填写一种。
标题动画
统一间隔使用 menu.title.values 与 period：
menu:
rows: 1
title:
type: LOOP
period: 40
values:
- '&8功能菜单'
- '&8选择一个功能'逐帧间隔使用 menu.title.frames：
menu:
title:
type: LOOP
frames:
- value: '&8状态菜单'
delay: 20
- value: '&a欢迎回来'
delay: 40| 字段 | 类型 | 必填 | 默认行为 | 说明 |
|---|---|---|---|---|
values | 文字列表 | 与 frames 二选一 | — | 按统一间隔切换的标题列表 |
frames | 标题帧对象列表 | 与 values 二选一 | — | 每帧单独填写标题文字与停留时间 |
period | 整数 | 否 | 20 tick | 默认帧间隔 |
type（mode） | 文字 | 否 | LOOP | 播放模式 |
pre-generate | 布尔值 | 否 | true | 打开时预先计算帧文字；false 在每次切换时计算 |
以上字段写在 menu.title 中。使用 frames 时，每一项的字段如下：
| 字段 | 类型 | 必填 | 默认行为 | 说明 |
|---|---|---|---|---|
value（title） | 文字 | 是 | — | 当前帧标题，支持颜色与占位符 |
delay（last） | 整数 | 否 | 使用 period，未设置时为 20 tick | 当前帧停留时间 |
动态变量需要随循环更新时设置 pre-generate: false；主动更新使用 menu title update。只有一帧时显示静态标题，不循环播放。
播放模式
| 模式 | 行为 |
|---|---|
LOOP | 循环播放 |
ONE_WAY | 单向播放 |
REVERSIBLE | 往返播放 |
RANDOM | 随机选择 |
标题控制
menu title pause
menu title resume以上语句暂停或恢复标题动画。20 TPS 时，20 tick 约一秒。完整菜单见动画示例。
最后更新于