Files
netease-modsdk-wiki/docs/wiki/concepts/contents.md
2025-03-20 11:52:46 +08:00

2.1 KiB

title, mentions
title mentions
contents.json
MedicalJewel105
Osaxely
SirLich
solvedDev
Joelant05
Jorginhor
TheItsNameless

contents.json

contents.json 是游戏用于更高效处理资源包文件的配置文件。该文件 可能 主要为市场内容创作者和 Mojang 设计,资源包即使不包含此文件仍可正常运行。

以下是关于该文件使用方式的说明。

文件结构

contents.json 位于附加包目录的根路径,包含资源包内所有文件的路径列表。示例:

::: code-group

{
	"content": [
		{
			"path": "texts/en_US.lang"
		},
		{
			"path": "contents.json"
		},
		{
			"path": "manifest.json"
		},
		{
			"path": "animations/my_animation.animation.json"
		},
		{
			"path": "animation_controllers/my_ac.ac.json"
		},
		{
			"path": "entity/my_entity.entity.json"
		},
		{
			"path": "textures/textures_list.json"
		},
		{
			"path": "textures/blocks/my_block.png"
		}
	]
}

:::

<FolderView :paths="[ 'RP/texts/en_US.lang', 'RP/manifest.json', 'RP/contents.json', 'RP/animations/my_animation.animation.json', 'RP/animation_controllers/my_ac.ac.json', 'RP/entity/my_entity.entity.json', 'RP/textures/texture_list.json', 'RP/textures/blocks/my_block.png' ]"

自动化生成

contents.json 可通过游戏自动生成,这种方式能有效减少手动配置错误。首先需要在附加包根目录创建空文件并添加空对象:

::: code-group

{}

:::

游戏会在下次启动时自动填充该文件内容。

补充说明

  • 自动生成功能适用于任意位置的资源包(开发文件夹或普通文件夹均可)
  • 不需要为子包单独创建多个 contents.json,根目录文件已足够
  • 该文件并非附加包运行的必要条件