附加包教程第二期——manifest清单目录文件

7***

manifest清单目录文件

一、清单目录文件的作用
清单目录是一个json文件，用于在我的世界识别附加包，每个包都有一个清单目录文件，一个格式正确的清单目录文件的部分内容将显示在我的世界中。

二、清单目录的基本语法
路径：行为包或资源包
              |_manifest.json

1. {
   
2.     "format_version": 2,
   
3.     "header": {
   
4.         "name": "pack.name",
   
5.         "description": "pack.description",
   
6.         "uuid": "...",
   
7.         "version": [1, 0, 0],
   
8.         "min_engine_version": [1, 16, 0]
   
9.     },
   
10.     "modules": [
    
11.         {
    
12.             "type": "data或resources",
    
13.             "uuid": "...",
    
14.             "version": [1, 0, 0]
    
15.         }
    
16.     ]
    
17. }
    

复制代码

三、manifest文件的语法详解

• “format_version”定义了清单目录文件语法的版本。版本2是最新的稳定版本，一般使用它。
• “name”是行为包的名称。“description”将在游戏中显示在它下面。我们现在以“语言代码形式”定义这些文件，以便我们稍后可以将其翻译成其他语言。
• “uuid”字段非常重要，下文将更详细地讨论。
• “version”定义了附加包的版本。当你在安装了附加包的旧版本的设备上导入带有较新版本的附加包时，较新的版本将覆盖旧版本。
• “min_engine_version”定义了能够读取附加包的最低我的世界客户端版本。
• 在“modules”中，“type”可以被定义为“data或resources”。这使得此包成为行为包（data）或资源包（resources）。
  

重要知识点：UUID
UUID（通用唯一识别码,Universally Unique Identifier）可以标识附加包包，供其他程序（在本例中为我的世界）识别。UUID看起来是这样的：1ce8eeae-f1d6-4330-bda1-e9fd427406cd
永远不要重复使用UUID。你可以在这里生成UUID。
为了确保附加包正常工作，你应该生成两个新的UUID，你把每个UUID粘贴到清单目录文件中的“...”。完成后，它应该看起来像这样："uuid": "1ce8eeae-f1d6-4330-bda1-e9fd427406cd"

四、清单目录文件的其他语法
1.依赖包
语法：

1. 
   
2. ...
   
3.     "dependencies": [
   
4.        {
   
5.             "uuid": "...",
   
6.             "version": [0, 0, 1]//依赖包版本号
   
7.           }
   
8.     ]
   
9. ...
   

复制代码

这一部分可以添加依赖包，在启用时自动启用依赖包，若找不到依赖包则弹出提示
“uuid”:依赖包的UUID
“version”:依赖包的版本号

2.其他功能
语法：

1. 
   
2. ...
   
3.     "capabilities": [
   
4.         "chemistry",
   
5.         "experimental_custom_ui",
   
6.         "raytraced"
   
7.     ]
   
8. ...
   

复制代码

这一部分可以启用其他功能，具体有：
“chemistry”:启用化学功能，让附加包可以控制教育版化学功能
“experimental_custom_ui”:启用实验性自定义UI，允许包中的HTML文件用于自定义UI，允许包中的脚本调用和操作自定义UI
“raytraced”:启用光线追踪功能

3.附加包信息
语法：

1. 
   
2. ...
   
3.     "metadata": {
   
4.         "authors": ["作者1", "作者2", ...],
   
5.         "license": "附加包的许可协议",
   
6.         "url": "附加包的链接"
   
7.     }
   
8. ...
   

复制代码

用于给包添加附加信息
语法过于简单，不作详细解释

预告：下一期会给大家介绍附加包的主要结构

附加包教程系列导航
上一期  下一期

挽***

厉害，期待第3期（能不能在今天出〔不是〕）

穆雪***

你是哪怕是维基百科找的吧

7***

Spring_Maple 发表于 2022-4-24 18:32
你是哪怕是维基百科找的吧

有的是，大部分不是

wiki没有这么多东西

一只***

为了太美工艺，我来查教程了

鴒***

请问，这是哪里出错了？我找到他包里有的清单，之后用UUID生成器生成了一个复制粘贴替换了他原本的（除此之外没动任何地方）。之前没找到的时候尝试自己对照您的加一个清单，他导入失败，但反馈检查不出任何毛病。