方块纹理动画

intermediate

应用翻页书纹理
定义翻页书纹理
翻页书纹理参数
效果展示

通过本页您将学习：

如何为方块应用翻页书纹理
可在RP/textures/flipbook_textures.json中配置的参数及其作用

应用翻页书纹理

翻页书纹理即动画纹理。火焰、水、熔岩和岩浆等方块都使用这种纹理。您也可以为自己的方块添加动画纹理！首次尝试时，让我们使用岩浆的动画纹理。只需将texture值改为Vanilla RP/textures/terrain_texture.json中定义的纹理即可为您的方块应用岩浆动画纹理：

json

"magma": {
    "textures": "textures/blocks/magma"
}

BP/blocks/flipbook_block.json

json

{
    "format_version": "1.21.70",
    "minecraft:block": {
        "description": {
            "identifier": "wiki:flipbook_block",
            "menu_category": {
                "category": "construction"
            }
        },
        "components": {
            "minecraft:geometry": "minecraft:geometry.full_block",
            "minecraft:material_instances": {
                "*": {
                    "texture": "magma" // 在此处添加
                }
            }
        }
    }
}

现在您的方块就拥有动画纹理了！

定义翻页书纹理

为方块添加动画纹理后，让我们了解其工作原理。

Minecraft会读取terrain_texture.json中定义的纹理名称和路径

RP/textures/terrain_texture.json

json

{
    "resource_pack_name": "wiki",
    "texture_name": "atlas.terrain",
    "texture_data": {
        "magma": {
            "textures": "textures/blocks/magma"
        }
    }
}

Minecraft会在flipbook_textures.json中查找该名称（magma）对应的动画参数

RP/textures/flipbook_textures.json

json

[
    {
        "atlas_tile": "magma",
        "flipbook_texture": "textures/blocks/magma",
        "ticks_per_frame": 10
    }
]

此处的"atlas_tile"为地形纹理文件中定义的magma名称添加动画参数。

Minecraft会将此动画纹理应用于所有使用magma作为纹理的方块。

翻页书纹理参数

查看原版翻页书纹理文件时，您可能会注意到一些额外参数：

参数	类型	说明
flipbook_texture	字符串	纹理路径
atlas_tile	字符串	在`terrain_texture.json`文件中定义的简称
atlas_index	整数	该简称定义中纹理数组的索引
atlas_tile_variant	整数	该简称的方块变体中纹理数组的变体索引
ticks_per_frame	整数	帧切换速度。20 tick = 1秒
frames	数组或整数	每帧使用的帧索引列表，或按顺序重复的总帧数
replicate	整数	设置像素大小。默认值：1
blend_frames	布尔值	定义帧过渡是否平滑。默认值：true

`atlas_index`

用于定义要动画化的方块纹理索引。

RP/textures/terrain_texture.json#texture_data

json

"dirt": {
    "textures": [
        "textures/blocks/dirt",
        "textures/blocks/coarse_dirt" // 假设这是您要动画化的路径
    ]
}

由于路径2有动画纹理，因此您需要在泥土方块的翻页书纹理中添加"atlas_index": 1。

`atlas_tile_variant`

用于定义要动画化的方块变体（注册到variations数组中的变体）。

RP/textures/terrain_texture.json#texture_data

json

"dirt": {
    "textures": [
        {
            "variations": [
                { "path": "textures/blocks/dirt_va" }, // 假设这是您要动画化的方块变体
                { "path": "textures/blocks/dirt0" },
                { "path": "textures/blocks/dirt1" }
            ]
        }
    ]
}