我的世界中国版 Wiki

主题

纹理动画 ​

本页面镜像自
BedrockWiki

根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。

通过本文你将了解：

  • 如何为方块应用翻页书贴图
  • RP/textures/flipbook_textures.json 中可用的参数及其作用

应用翻页书贴图 ​

翻页书贴图即动态纹理。火焰、水、岩浆和岩浆块等方块都使用此类贴图。你也可以为自己创建的方块添加动态纹理！

首先以原版岩浆的动效贴图为例。只需在材质实例组件中将 texture 值设为 Vanilla RP/textures/terrain_texture.json 中定义的纹理名称即可：

json
"magma": {
  "textures": "textures/blocks/magma"
}
json
{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:flipbook_block",
      "menu_category": {
        "category": "construction"
      }
    },
    "components": {
      "minecraft:unit_cube": {},
      "minecraft:material_instances": {
        "*": {
          "texture": "magma" // 将纹理名称填在此处
        }
      }
    }
  }
}

现在你的方块已经拥有动态纹理了！

定义翻页书贴图 ​

在为方块添加动态纹理后，我们需要了解其工作原理。

  1. 游戏会根据 terrain_texture.json 中定义的纹理名称（如 magma）读取对应贴图路径
json
{
  "texture_name": "atlas.terrain",
  "resource_pack_name": "wiki",     // 资源包ID
  "padding": 8,                     // 防止贴图边缘像素溢出
  "num_mip_levels": 4,              // 控制远视角和倾斜视角下的材质质量
  "texture_data": {
    "magma": {
      "textures": "textures/blocks/magma"
    }
  }
}
  1. 游戏会根据上述名称（magma）在 flipbook_textures.json 中查找对应的动画参数
json
[
  {
    "atlas_tile": "magma",
    "flipbook_texture": "textures/blocks/magma",
    "ticks_per_frame": 10
  }
]

"atlas_tile" 表示将动画参数绑定到 terrain_texture.json 中定义的 magma 纹理名称。

  1. 所有使用 magma 作为纹理的方块都将应用此动态纹理

翻页书贴图参数配置 ​

在查阅官方示例时，你可能会发现一些额外的配置参数：

参数名类型描述
flipbook_texturestring纹理文件路径
atlas_tilestring在terrain_textures.json中定义的短名称
atlas_indexinteger短名称对应的纹理数组中目标纹理的索引
atlas_tile_variantinteger短名称对应的方块变体数组中纹理的变化索引
ticks_per_frameinteger帧切换速度（单位：ticks，20 ticks = 1秒）
framesarray 或 integer帧索引数组；或表示总帧数的整数值
replicateinteger像素倍数（仅允许2的幂次值），默认：1
blend_framesboolean是否启用帧过渡平滑效果，默认：true

atlas_index ​

用于指定需要添加动画效果的纹理在数组中的索引位置

json
"dirt": {
  "textures": [
    "textures/blocks/dirt",
    "textures/blocks/coarse_dirt" // 假设此纹理需要添加动效
  ]
}

由于要设置第二个纹理（索引为1）的动效，需要在对应配置中设置 "atlas_index": 1

atlas_tile_variant ​

用于指定需要添加动画效果的方块变体（需在 variations 数组中定义）索引

json
"dirt": {
  "textures": [
    {
      "variations": [
        { "path": "textures/blocks/dirt_va" }, // 假设此变体需要添加动效
        { "path": "textures/blocks/dirt0" },
        { "path": "textures/blocks/dirt1" }
      ]
    }
  ]
}

若需要设置索引1的变体动画，需在参数中添加 "atlas_tile_variant": 1

replicate ​

控制贴图像素显示倍数。仅允许使用2的幂次数值，当原帧分辨率较小时可实现像素扩展效果

参数值效果说明
< 0动画失效
0动画失效且贴图不显示
2每像素扩展为4格（尺寸缩小1/2）
x每像素扩展为x²格（尺寸缩小1/x）

效果展示 ​

现在你可以开始修改原版动效贴图或创作属于你的动态纹理了！