Skip to content

v2_resourcepack

Handle edited this page Jun 10, 2020 · 5 revisions

创建资源包(Resource Pack)

2.x 版本的 雀魂 Plus 中,加入了资源包的设定,以取代原本的模组。资源包是原本模组的实质意义,并且在 1.x 模组的基础上增加了一些功能,以更方便素材的更改。

下面将简单介绍资源包的格式与规范,进阶的概念和内容请参考进阶篇

资源路径(resource domain)

每个资源包都需要有一个唯一的资源路径。类似雀魂官方的 v0.5.1.w。在实际寻找资源时,雀魂 Plus 会替换原有的资源路径,以达到替换素材的目的。

目录格式

雀魂 Plus 资源包的目录格式如下所示:

- resource_pack_name
  - resourcepack.json
  - assets
    - folderA
      - fileBinFolderA.png
    - fileA.png

其中,resource_pack.json 负责描述该资源包的信息,而 assets 目录下负责存储该资源包对应资源路径的实际内容。

resource_pack.json

下面给出一个资源包的 resource_pack.json 的样例:

{
  // 以下为 metadata
  "id": "sample", // 必填项
  "version": "1.0.0", // 必填项
  "name": "sample_pack", // 选填项
  "author": "Majsoul Plus Team", // 选填项
  "description": "This is a sample resource pack.", // 选填项
  "preview": "preview.png", // 选填项

  // 以下为资源包特有
  "dependencies": {
    "majsoul_plus": "^2.0.0" // 不建议使用,尚未完善
  },
  "replace": [
    "audio/sound/zeniya/fan_dora10.mp3",
    "scene/Assets/Resource/mjpai/en/mjp_default_0/8p.png",
    {
      "from": [
        "audio/sound/qianzhi/lobby_normal1.mp3",
        "audio/sound/qianzhi/lobby_normal2.mp3",
        "audio/sound/qianzhi/lobby_normal3.mp3",
        "audio/sound/qianzhi/lobby_normal4.mp3",
        "audio/sound/qianzhi/lobby_normal5.mp3"
      ],
      "to": "audio/quack.mp3"
    }
  ]
}

可以执行的脚本呢?

由于功能调整,雀魂 Plus 中的资源包目前只能起到替换资源的作用。想要实现更强大的功能,请参考扩展