本来按照惯例，此版本应该叫 1.2.1 的，但是会造成很大的混淆，故直接把版本号定为 2.2.1

功能更新与修复

• 全面换用新的模型文件结构，添加模型清单文件 ysm.json 统一管理：

  • 支持设置默认材质和材质文件的展示顺序；
  • 支持设置预览动画，在模型选择界面播放（旧版统一为 idle）；
  • 支持自定义 Extra 动画的数量、顺序、名称（不再限制为 extra+数字）；
  • 支持读取模型目录内的子目录文件。
  • 支持插入作者信息，并分配头像、角色、简介、联系方式
  • 支持插入主页和捐赠网页信息
  • 支持 PBR 材质指定

    具体内容请看 ysm.json 说明文件

• 解除模型和材质的文件名限制，现在能够支持任意字符了（包括中文）；

• 默认模型格式全部修改为新版类型

• 现在套多层子文件夹（最大 16 层）也能够智能读取其下的所有模型了，无论是文件夹形式、ysm 格式或者是 zip 格式的。

• 支持读取版本高于 1.12.0 的基岩版模型；

• 小幅提高读取模型的性能；

• 支持读取更多形式的关键帧，修复了部分旧模型读取失败的问题；

• 修复 molang 作用域定界表达式的求值异常问题

• 修复部分情况下意外播放 Extra 动画的问题；

• 添加模型统计信息；

• 模型切换界面可以保留页数记录（不用每次都翻页了）；

• 添加模型详情界面，显示作者列表，捐赠和主页网址跳转按钮；

• 修复动画预览时头部的异常旋转问题；

• 以——开头名称的注释动画不显示；

• 没有语言文件的动画按钮文本直接显示动画名，而不是显示语言文件 key

• 【Forge】修复了仅客户端模式下无法中止 Extra 动画的问题；

• 【Forge】修复了某些情况下进入游戏时报错空指针的问题；

• 【Fabric】重构网络系统，与 Forge 端统一（现在两个端可以互通）；

模组兼容

• 【Forge】 添加对拔刀剑：重锋模组的兼容
• 【Forge】 添加 TACZ 的兼容，几乎和旧版本对 TAC 的效果一致，并且也支持枪械 ID 形式的动画。其中 1.18.2 同时添加了对 TAC 和 TACZ 的兼容。
• 【Forge】 适配 oculus 1.7.0；并添加对 Oculus PBR 的支持。
• 【Forge】 适配时装工坊的盔甲和鞘翅插槽；

动画与 molang

• 修正酒狐模型，并添加对 1.21 重锤的动画支持

• 更新默认模型；

• 【Forge 1.20】修复了 ysm.relative_block_name 结果不正确的问题；

• 现在轮盘动画支持任意多个额外动画，使用滚轮翻页。按下 Z 键也能关闭界面

• 修正 q.body_y_rotation 不正确的问题

• 添加默认支持的爬梯动画，分为三个：ladder_up、ladder_stillness、ladder_down

• 添加爬梯相关 molang 变量：

  1. ysm.on_ladder，布尔值，用来判断实体是否在梯子上
  2. ysm.ladder_facing 梯子朝向，输出数字 0-3，分别对应：南-西-北-东

• 添加对原版鹦鹉的渲染支持（通过定位组 LeftShoulderLocator，RightShoulderLocator）

• 添加了原版鹦鹉相关 molang 变量：

  1. has_left_shoulder_parrot, has_right_shoulder_parrot
  2. left_shoulder_parrot_variant，right_shoulder_parrot_variant：鹦鹉颜色变种

• 添加骑乘和被骑乘的动画设计，可以放在任意动画文件中

  • vehicle 表示载具，后面输入实体 ID。比如玩家骑在史莱姆上，那么动画名就是vehicle$minecraft:slime
  • passenger 表示乘客，也就是骑在玩家头上的实体，后面输入实体 ID。比如一只狐狸骑在玩家头上，那么动画名就是passenger$minecraft:fox

• q.max_durability和q.remaining_durability，需要输入一个槽位字符串参数

  • 举例：q.max_durability('mainhand')：返回主手手持物品的最大耐久

  • 参数有 Mainhand Offhand Feet Legs Chest Head

• ysm.rendering_in_inventory：无参，返回布尔值，判断玩家是否正在GUI中渲染，可以用来做一些仅在 GUI 中显示的动画；

• ysm.eye_in_water：眼部是否在水下，用来判断玩家是否完全浸入水中

• ysm.frozen_ticks：细雪中增加此数值到 140

• ysm.air_supply：空气值，最大 300

• ysm.arrow_count：玩家插在身上的箭的数量

• ysm.stinger_count：玩家插在身上的蜜蜂的毒刺的数量

• 以下全是实体相关 Attributes 属性：

  • ysm.attack_damage
  • ysm.attack_speed
  • ysm.attack_knockback
  • ysm.movement_speed
  • ysm.knockback_resistance
  • ysm.luck
  • ysm.block_reach
  • ysm.entity_reach
  • ysm.swim_speed
  • ysm.entity_gravity
  • ysm.step_height_addition
  • ysm.nametag_distance