箭矢动画

自 1.2.0 版本起，我们新增了箭矢自定义功能，允许玩家修改箭矢模型及其动画。

在 2.2.1 版本之后，若要制作自定义箭矢，需在 ysm.json 中声明相关文件，否则所做更改将无法生效。

使用 YSM 插件

在插件的模型信息页面，点击侧边栏的 箭相关文件 选项：

在右侧点击如图所示的按钮，导入对应的文件：

填写完成并确认信息无误后，点击下方的确认按钮保存：

手动填写

首先，打开你模型的 ysm.json 文件，找到 files 字段，在其中新建一个名为 arrow 的字段，然后按照以下格式填写：

"files": {
    "player": {
        // 玩家模型部分
    },
    // 在这之后添加箭矢模型和动画
    "arrow": {
        // 箭矢模型
        "model": "models/arrow.json",
        // 箭矢动画
        "animation": "animations/arrow.animation.json",
        // 箭矢材质
        "texture": "textures/arrow.png"
    }
}

若你的箭矢贴图使用 PBR 材质，texture 字段需按如下方式填写：

"arrow": {
    "model": "models/arrow.json",
    "animation": "animations/arrow.animation.json",
    // 如果您要使用 PBR ，请按如下格式修改
    "texture": {
        // uv 字段必选，以下两种 PBR 材质为可选，都不填则按照正常贴图处理
        "uv": "textures/arrow.png",
        // Oculus 和 Iris PBR 支持
        "normal": "textures/arrow_n.png",
        "specular": "textures/arrow_s.png"
    }
}

注意

若你要制作自定义箭矢，务必填写此处内容。若自定义箭矢无法正常生效，请先检查此处是否已声明相关文件。

动画清单

以下是可自定义的箭矢动画，默认模型的箭矢动画文件为 arrow.animation.json：

名称	作用
water	箭矢在水中的动画，优先度高，可被并行动画覆盖
fire	箭矢着火的动画，优先度高，可被并行动画覆盖
ground	箭矢落地时的动画，优先度低，会被其他动画覆盖
air	箭矢在空中飞行时的动画，优先度低，会被其他动画覆盖
parallel0 parallel1 … parallel7	并行动画，优先度高，不可被覆盖