跳转到内容

模型格式说明

Yes Steve Model 模组以 geckolib 为核心,因此它支持与 geckolib 兼容的基岩版 1.12.0 及以上版本的模型文件,以及基岩版 1.8.0版本的动画文件。

从 2.3.0 版本开始,该模组还支持基岩版动画控制器和动画音频。

模型文件具备三种格式,将它们放置在指定目录下,游戏均能识别并加载:

  • 文件夹格式:这是模型设计者最为推荐的格式,便于对内容进行修改,还能在游戏内快速进行重载测试。
  • 压缩包格式:它是文件夹格式的直接打包,方便与他人分享。
  • ysm 格式:这是文件夹格式的加密打包,在方便分享给他人的同时,还能防止模型文件被修改盗用。

所有自定义模型文件都应放置在游戏主目录下的 config/yes_steve_model 文件夹中。yes_steve_model 文件夹下会自动生成四个子文件夹:

  • auth 文件夹:用于存放自定义模型,该位置的自定义模型必须经过授权才可使用。
  • cache 文件夹:这是系统自动从服务端获取的加密模型文件的缓存文件夹。
  • custom 文件夹:同样用于存放自定义模型,该位置的自定义模型无需授权即可使用。
  • export 文件夹:当在游戏内使用 /ysm export 指令后,生成的 ysm 专属格式的模型文件就存放在此。

你可以选择将自定义模型文件直接放置在 auth 或者 custom 文件夹中。

  • ysm 格式的加密模型无法再转换为普通模型文件,==也无法进行二次修改!==
  • ysm 格式遵循向下兼容原则,因此如果使用高版本模组导出的 ysm 格式文件,在低版本模组中将无法加载。
  • 在游戏内输入 /ysm export <model_id> 指令,即可将某个文件夹格式的模型导出为 ysm 专属模型格式。
  • 从 2.2.2 版本开始,该指令还支持 /ysm export <model_id> [extra_info] 形式,你可以在 extra_info 处添加自定义的文本信息,这样导出的 ysm 文件中也会附带该信息。
记事本打开 YSM 模型文件后的样子

记事本打开 YSM 模型文件后的样子

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