子包

什么是子包？ ​

子包功能允许您在不同附加包"配置"之间进行选择。

该功能最初设计用于根据设备内存容量加载不同分辨率的纹理，但也可用于创建行为包和资源包的文件变体。用户可通过点击齿轮图标并调整滑块来选择这些变体。

子包工作原理 ​

当选定了某个子包时，放置在子包文件夹中的文件将覆盖主附加包文件夹中的同名文件。例如，若您的附加包同时包含RP/textures/entities/ghost.png和RP/subpacks/pack_1/textures/ghost.png两个文件，当选择pack_1子包时，第二个图像文件将替换第一个。

关于文件覆盖机制的更多信息，请参阅我们的覆盖原版资源页面。

创建子包 ​

• 首先需要在BP/RP根目录下创建subpacks文件夹
• 然后在subpacks文件夹内为每个子包创建单独文件夹 例如：

• 在每个子包文件夹内可添加相应内容 这些内容可以是行为包或资源包中的任何常规文件 例如：

清单文件配置 ​

要在清单文件中注册子包，需要添加包含子包数组的subpacks字段。

示例：

{
	"format_version": 2,
	"header": {
		"name": "包名称",
		"description": "包描述",
		"uuid": "2fc2dd6f-86cb-4370-af70-21490a1ae471",
		"version": [1, 0, 0],
		"min_engine_version": [1, 13, 0]
	},
	"modules": [
		{
			"type": "resources",
			"uuid": "f6821b4a-1854-44fc-a8a4-0c2847ffda46",
			"version": [1, 0, 0]
		}
	],
	"subpacks": [
		{
			"folder_name": "subpack_1",
			"name": "第一个子包",
			"memory_tier": 0
		},
		{
			"folder_name": "subpack_2",
			"name": "第二个子包",
			"memory_tier": 1
		}
	]
}

• name - 选择子包时显示的名称

• memory_tier- 启用该子包所需的设备内存容量。1个内存层级 = 0.25GB

• folder_name - 该子包使用的文件夹名称，例如上例中的subpack_1或subpack_2

注意事项 ​

若仅添加一个子包，在子包选择界面会显示2个选项，但第二个选项（实际无子包）不会使根目录内容覆盖子包内容。