Flipbook Textures

intermediate

What this page covers

From this page you will learn:

How to apply flipbook textures to a block.
Which values you can apply in flipbook_textures.json and what they do.

Beginning

Flipbook textures are animated textures. Blocks like fire, water, lava and magma use them. You can use animated texture for your blocks too! For the first time let's use magma's animated texture. You can simply apply animated magma's texture to your block by changing texture value to one, defined in Vanilla_RP/textures/terrain_texture.json:

json

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

1
2
3

BP/blocks/flipbook_block.jsonCopy

json

{
	"format_version": "1.17.20",
	"minecraft:block": {
		"description": {
			"identifier": "wiki:flipbook_block"
		},
		"components": {
			"minecraft:destroy_time": 7,
			"minecraft:unit_cube": {},
			"minecraft:block_light_absorption": 15,
			"minecraft:block_light_emission": 0,
			"minecraft:creative_category": {
				"category": "construction",
				"group": "itemGroup.name.construction"
			},
			"minecraft:material_instances": {
				"*": {
					"texture": "magma", // Add it here.
					"render_method": "opaque"
				}
			}
		}
	}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

Now it has animated texture!

How it works

After making block have animated texture, it is time to figure out how it all works.

Minecraft takes name and path to texture defined in terrain_texture.json

RP/textures/terrain_texture.jsonCopy

json

{
    "num_mip_levels" : 4,
    "padding" : 8,
    "resource_pack_name" : "vanilla",
    "texture_data" : {
        "magma": {
            "textures": "textures/blocks/magma"
        }
    }
}

1
2
3
4
5
6
7
8
9
10

Minecraft searches looks into flipbook_textures.json aiming to find animation parameters for this name (magma)

RP/textures/flipbook_textures.jsonCopy

json

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

1
2
3
4
5
6
7

"atlas_tile" here adds animation parameters to magma name, defined in terrain_texture file.

Minecraft uses this animated texture for blocks who have magma as texture.

This is the way how it works.

What are the components?

While looking up for something in vanilla flipbook texture file, you can notice some components.

Here is explanation for them:

Component	Value	Meaning
flipbook_texture	string	Path to texture.
atlas_tile	string	The shortname defined in the terrain_textures.json.
atlas_index	integer	The index of the texture array inside the definition of that shortname.*
atlas_tile_variant	integer	The variant of the block's texture array inside the shortname's block variation.
ticks_per_frame	integer	How fast frames should be changed. 20 ticks = 1 second.
frames	list	List with numbers of frames which defines their order.
replicate	integer	Sets the size of pixels. Default: 1.**
blend_frames	boolean	Defines should frames transition be smooth or not. Default: true.

* atlas_index

A component where you'll define the value of the block index to animate.

Example:

RP/textures/terrain_texture.json#texture_dataCopy

json

"dirt" : {
    "textures" : [
        "textures/blocks/dirt",
        "textures/blocks/coarse_dirt" //imagine if this is the path you wanted to animate
    ]
}

1
2
3
4
5
6

Since path 2 has an animated texture, therefore you'll put "atlas_index": 1" on the Dirt block's flipbook texture.

* atlas_tile_variant

A component where you'll define the value of the block variant (which is registered to the Variations array) to animate.

Example:

RP/textures/terrain_texture.json#texture_dataCopy

json

"dirt" : {
    "textures" : [
           {
       "variations": [
           { "path": "textures/blocks/dirt_va" }, //imagine if this is the block variation you wanted to animate
           { "path": "textures/blocks/dirt0" },
           { "path": "textures/blocks/dirt1" }
           ]
        }
    ]
}