选择界面动画

自 2.2.2 版本起，我们为模型选择界面添加了动画支持，当鼠标在模型界面悬停、移出或选中模型按钮时，相应动画即可播放。

你可以将这些动画放置在 main.animation.json 文件中。

默认播放动画

默认情况下，选择界面的播放动画没有固定名称，你可以随意创建一个动画名称（例如我们命名为 gui），然后修改 ysm.json 文件中的 preview_animation 字段，将其改为这个动画名称（如下所示）。

{
  "properties": {
    // 在模型选择界面播放的预览动画
    "preview_animation": "gui"
  }
}

如果你使用的是 BlockBench 插件，只需修改此处即可：

其他动画

具体使用方法可参考模组自带的 wine_fox_jk 模型的 main.animation.json 文件。

名称	作用	备注
hover	当鼠标悬浮在该模型按钮上时播放	-
hover_fadeout	当鼠标移出该模型按钮时播放	用于实现移出效果
focus	当选中该模型按钮时播放，仅限 1.20 以上版本适用	-

动画的角度问题

在 2.2.2 及以前版本中，若要使选择界面动画贴合角度，需要为人物设置一个非常奇怪的旋转角度。

自 2.3.0 版本起，只需在 ysm.json 文件的 properties 下新增此字段，即可取消这个奇怪的旋转角度。

{
  "properties": {
    // 设置为 true 禁用模型选择界面角度
    "disable_preview_rotation": true
  }
}

此时，模型的正视图和游戏内 GUI 选择界面的角度完全一致！