图集定义文件

图集定义文件（Atlas Definition File）用于定义一个图集，位于资源包的textures文件夹内，共有两个文件，分别定义物品图集和地形图集，文件名分别硬编码为item_texture.json和terrain_texture.json。

• rp 资源包
  • textures
    • item_texture.json
    • terrain_texture.json

模式

两个图集定义文件共享同一种文件模式。

object
{
    int "padding" : opt // 该图集中所有纹理在合成整张图像时所具有的内边距，默认为`0`
    int "num_mip_levels" : opt // 该图集的MIP级别的数目，默认为`0`
    string "default_leather_color" : opt // 该图集的默认皮革颜色，格式为`#RGBA`
    string "default_horse_leather_color" : opt // 该图集的默认马匹皮革颜色，格式为`#RGBA`
    string "texture_name" : opt // 图集页的资源名称，对于`item_texture.json`文件，请填写`atlas.item`，对于`terrain_texture.json`文件，请填写`atlas.terrain`，接受其他名称，但这将导致创建一个新的图集页，文件无法与原版的该图集定义合并，一些硬编码逻辑亦将失效，默认为`atlas.terrain`
    object "texture_data" // 该图集的纹理数据
    {
        object "<texture reference name>" // 该图集中一个定义的纹理图块及其名称
        {
            bool "quad" : opt // 默认为`false`
            element_collection "textures" // 该纹理的路径的合集
            float "mip_fade_amount" : opt // MIP淡入淡出量，默认为`0`
            color "mip_fade_color" : opt // MIP淡入淡出颜色，默认为`[0, 0, 0, 0]`
            bool "additive" : opt // 是否可叠加，默认为`false`
        }
    }
}

element_collection

element // 一个纹理变种的路径
array
{
    element "<any array element>" // 一个纹理变种的路径
}
object
{
    array "variations"
    {
        element "<any array element>" // 一个纹理变种的路径
    }
}

element

string // 一个纹理文件相对于资源包根目录的不具有扩展名的路径
object
{
    string "path" // 一个纹理文件相对于资源包根目录的不具有扩展名的路径
    string "tint_map_path" : opt // 染色贴图的路径
    string "overlay_color" : opt // 覆盖层颜色，格式为`#RGBA`
    float "mip_fade_amount" : opt // 该变种的MIP淡入淡出量，默认为`0`
    color "mip_fade_color" : opt // 该变种的MIP淡入淡出颜色，默认为`[0, 0, 0, 0]`
    object "tint_base_color" : opt // 该变种的多通道染色基色
    {
        color "r_color" : opt // R通道
        color "g_color" : opt // G通道
        color "b_color" : opt // B通道
        color "a_color" : opt // A通道
    }
    string "tint_color" : opt // 该变种的单通道染色颜色，格式为`#RGBA`
    object "tint_color" : opt // 该变种的多通道染色颜色
    {
        color "r_color" : opt // R通道
        color "g_color" : opt // G通道
        color "b_color" : opt // B通道
        color "a_color" : opt // A通道
    }
    float "weight" // 该变种的权重
    texture_isotropic "isotropic" // 该变种的迷向性
}

color

string // 格式为`#RGBA`
array
{
    int "[0..0]" // R通道
    int "[1..1]" // G通道
    int "[2..2]" // B通道
    int "[3..3]" // A通道
}

texture_isotropic

bool // 为各面开启迷向面，默认为`false`
object // 三面式解析
{
    bool "up" : opt // 为上面开启迷向面，默认为`false`
    bool "down" : opt // 为下面开启迷向面，默认为`false`
    bool "side" // 为四个侧面开启迷向面，默认为`false`，如不存在该字段则按照六面式解析
}
object // 六面式解析
{
    bool "up" : opt // 为上面开启迷向面，默认为`false`
    bool "down" : opt // 为下面开启迷向面，默认为`false`
    bool "north" : opt // 为北面开启迷向面，默认为`false`
    bool "south" : opt // 为南面开启迷向面，默认为`false`
    bool "west" : opt // 为西面开启迷向面，默认为`false`
    bool "east" : opt // 为东面开启迷向面，默认为`false`
}

原版用例

图集页的资源名称	描述
atlas.item	物品图集，由数据驱动定义，具有一些硬编码逻辑，主要用于UI中的物品图标显示和手持物品纹理渲染
atlas.terrain	地形图集，由数据驱动定义，具有一些硬编码逻辑，主要用于方块纹理渲染
atlas.banner	旗帜图集，由硬编码定义

外部链接

• Block Texture Variation - Bedrock Wiki