模型格式说明
Yes Steve Model 模组以 geckolib
为核心,因此它支持与 geckolib
兼容的基岩版 1.12.0 及以上
版本的模型文件,以及基岩版 1.8.0
版本的动画文件。
从 2.3.0 版本开始,该模组还支持基岩版动画控制器和动画音频。
模型文件具备三种格式,将它们放置在指定目录下,游戏均能识别并加载:
- 文件夹格式:这是模型设计者最为推荐的格式,便于对内容进行修改,还能在游戏内快速进行重载测试。
- 压缩包格式:它是文件夹格式的直接打包,方便与他人分享。
- ysm 格式:这是文件夹格式的加密打包,在方便分享给他人的同时,还能防止模型文件被修改盗用。
模型文件放置位置
Section titled “模型文件放置位置”所有自定义模型文件都应放置在游戏主目录下的 config/yes_steve_model
文件夹中。yes_steve_model
文件夹下会自动生成四个子文件夹:
auth
文件夹:用于存放自定义模型,该位置的自定义模型必须经过授权才可使用。cache
文件夹:这是系统自动从服务端获取的加密模型文件的缓存文件夹。custom
文件夹:同样用于存放自定义模型,该位置的自定义模型无需授权即可使用。export
文件夹:当在游戏内使用/ysm export
指令后,生成的ysm
专属格式的模型文件就存放在此。
你可以选择将自定义模型文件直接放置在 auth
或者 custom
文件夹中。
加密格式说明
Section titled “加密格式说明”- ysm 格式的加密模型无法再转换为普通模型文件,==也无法进行二次修改!==
- ysm 格式遵循向下兼容原则,因此如果使用高版本模组导出的 ysm 格式文件,在低版本模组中将无法加载。
- 在游戏内输入
/ysm export <model_id>
指令,即可将某个文件夹格式的模型导出为 ysm 专属模型格式。 - 从 2.2.2 版本开始,该指令还支持
/ysm export <model_id> [extra_info]
形式,你可以在extra_info
处添加自定义的文本信息,这样导出的 ysm 文件中也会附带该信息。

记事本打开 YSM 模型文件后的样子
当你使用原版记事本打开新版本模组(1.2.0 及以后版本)导出的 ysm 文件时,你会看到图中的信息。这些信息无法被修改,若强行修改,模组将拒绝加载此文件。