萌芽引擎资源文件

什么是资源文件？

Tips：本文使用单个资源文件这一名词来特别指代未被打包进压缩包内的资源文件

资源文件（Resource）是一种可以更改游戏中方块、物品、生物和界面外表等的文件，例如贴图、模型、gif等。这是萌芽引擎在使用过程中不可缺少的一环。萌芽引擎的功能都需要读取资源文件来展现。资源文件可以位于 resourcepacks文件夹中的资源包内 或 GermResourcepacks文件夹中的资源包内 或 GermCache文件夹 中。单个资源文件只可以放置于 GermCache文件夹 中。

Warning：任何位置的资源文件都不能用大写字母进行命名，否则资源文件将无法被读取

什么是资源包？

资源包（Resource Pack）是一个可以更改游戏中方块、物品、生物和界面外表等单个资源文件的集合，它是由许多资源文件组成的一个压缩包。资源包可以位于 resourcepacks文件夹 或 GermResourcepacks文件夹中。

资源包的格式

资源包的压缩格式可以选用zip格式或7z格式，其中zip格式压缩的文件名后缀可以是.zip和.gip，7z格式压缩的文件名后缀只可以是.7z

Tips：.gip后缀名是为了和原版的资源包进行区分，压缩时使用zip格式进行压缩，压缩完成后右键压缩文件，重命名文件名后缀为.gip即可

资源包的文件结构

萌芽资源包的文件结构与原版有些许不同，所以我们为您提供了空白资源包作为模板

请严格按照下文所示的资源包层级关系，向空白资源包内添加您的资源文件吧！！！

Warning：您需要注意的是，资源包内的文件名称与文件夹名称不可以使用大写英文字母来命名！！

Tips：如需使用中文名称命名资源包内的资源文件，请在打包压缩资源包时的压缩文件格式内选择UTF-8编码！

(资源包名称).zip
└── assets
    └── germmod
        ├── effect
        │   ├── (图片特效).png
        │   └── particles
        │       └── (粒子特效).json
        ├── font
        │   └── (字体).ttf
        ├── models
        │   ├── bedrock_item
        │   │   ├── (基岩版物品模型材质).json
        │   │   └── (基岩版物品模型动画).json
        │   ├── entity
        │   │   ├── (实体模型材质).json
        │   │   └── (实体模型行为).json
        │   └── item
        │       └── (Java版物品模型).json
        ├── skin
        │   └── (时装工坊模型文件).armour
        ├── sounds
        │   ├── (音效文件).ogg
        │   └── (音效配置).json
        └── textures
            ├── bedrock_item
            │   └── (基岩版物品模型材质).png
            ├── entity
            │   └── (实体模型材质).png
            ├── font
            │   └── (字体替换材质).png
            ├── gui
            │   └── (GUI材质).png
            ├── item
            │   ├── (Java版物品模型材质).png
            │   ├── (物品图标材质).png
            │   └── armor
            │       ├── (盔甲贴图材质).png
            │       └── icon
            │           └── (盔甲图标材质).png
            └── misc
                └── (杂项材质).png

资源包加密

因为萌芽引擎独有的资源包加密功能，使得您的资源包的防盗性能极速提升。您只需使用zip压缩软件(例如:WinRAR)，在创建资源包时为您的资源包添加密码，并将您的资源包名称与密码一并填入Config.yml中的对应位置即可。在这里我们建议您使用包含特殊字符的16位及以上位数的随机密码作为资源包密码。

Tips：点击这里快速生成随机密码

获得付费版萌芽后可以在萌芽引擎平台中CDK编辑界面看到7z密码。7z加密压缩可以保护文件目录，更安全，但目前仅支持所有图片、GIF、基岩模型等的加密压缩。

资源文件的存放位置

GermCache文件夹中存放的一般是在测试时临时存放我们需要随时调整的单个资源文件。其中存放的单个资源文件可以在游戏运行过程中按下 右侧ALT+P 键 进行重载。

GermResourcepacks文件夹中只能存放的.zip格式和.7z格式资源包。玩家无法自主取消资源包，允许读取带有密码的资源包。

resourcepacks文件夹中可以存放.zip格式和.gip格式和.7z格式资源包，玩家可以自主控制资源包的更换。

Tips：这里我推荐稳定使用的资源包放在GermResourcepacks文件夹，需要玩家自行选择的资源包放在 resourcepacks文件夹中，调试资源文件时放在GermCache文件夹中

资源文件的读取路径

在萌芽引擎的配置文件中，我们需要为配置文件填写资源文件的路径，资源路径关系如下：

在GermCache文件夹中的资源文件的读取路径是与资源包内的读取路径有着共通之处的，在填写的读取路径中GermCache就等同于assets/germmod，

例如：我们在.minecraft/GermCache/textures/gui内储存了一张名为123.png的图片，我们此时在配置文件内填写的读取路径应为

path: 'local<->textures/gui/123.png'

在资源包中的的资源的读取路径是与GermCache文件夹内的资源文件的读取路径有着共通之处的，在填写的读取路径中assets/germmod就等同于GermCache，

例如：我们在default.zip/assets/germmod/textures/gui内储存了一张名为123.png的图片，我们此时在配置文件内填写的读取路径则应为

path: 'local<->textures/gui/123.png'