# textures

Textures are an important section in Minecraft and can be both overwritten and new textures can be added from Fonts or Models, the main path is

```
📦resource_pack.zip
  └── 📁assets
       └── 📁minecraft
           └── 📁textures
               ├── 📁block
               │    └── 🎨amethyst_cluster.png
               ├── 📁colormap
               ├── 📁effect
               ├── 📁entity
               ├── 📁environment
               ├── 📁font
               ├── 📁gui
               ├── 📁item
               │    └── 🎨axolotl_bucket.png
               ├── 📁map
               ├── 📁misc
               ├── 📁mob_effect
               ├── 📁painting
               ├── 📁particle
               └── 📁trims
```

{% hint style="warning" %}
Try to use textures in multiples of 16x, otherwise the texture may be distorted.
{% endhint %}

{% hint style="success" %}
The best way to obtain Minecraft assets is to go directly to [mcasset.cloud](https://mcasset.cloud/)
{% endhint %}

## MCMeta & Animated Textures

To make animated textures you need to multiply the size of the texture vertically, for example to add only one frame instead of `16x16` it is now `16x32` and has no limit, and so on with each frame you want to add.

| Parameter   | Description                                                                                                                                                                                                                                                     |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| interpolate | The font type, in this case, is bit-map for image-based chars. If true, *Minecraft* generates additional frames between frames with a frame time greater than 1 between them                                                                                    |
| height      | The height of the sprite, in pixels. This is also unused in vanilla, but can be used by resource packs to have frames that are not perfect squares. Defaults to the image's height if "width" is defined, and the smaller of the image's dimensions if it's not |
| frametime   | Sets the default time for each frame in increments of one game tick. Defaults to                                                                                                                                                                                |
| frames      | Contains a list of frames. Defaults to displaying all the frames from top to bottom.                                                                                                                                                                            |

#### Command Block Animated Example

{% file src="<https://4146076988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDlPwSxiLGZoSIhAE04w%2Fuploads%2FtIPzW2A3TXAMs5yssh3s%2Fcommand_block_back.png?alt=media&token=9bd24268-1c3a-4f93-b46f-b08c792c913f>" %}

`command_block_back.png.mcmeta`

```json
{
  "animation": {
    "interpolate": true,
    "frametime": 10
  }
}
```

#### Fire Animated Example

{% file src="<https://4146076988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDlPwSxiLGZoSIhAE04w%2Fuploads%2FzZACrZmEspXdqflWk08G%2Ffire_0.png?alt=media&token=e834dd83-137b-4b09-bec4-6b44cff39f41>" %}
fire\_0.png
{% endfile %}

`fire_0.png.mcmeta`

```json
{
  "animation": {
    "frames": [
      16,
      17,
      18,
      19,
      20,
      21,
      22,
      23,
      24,
      25,
      26,
      27,
      28,
      29,
      30,
      31,
      0,
      1,
      2,
      3,
      4,
      5,
      6,
      7,
      8,
      9,
      10,
      11,
      12,
      13,
      14,
      15
    ]
  }
}

```

#### An example of a Flash animation

{% file src="<https://4146076988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDlPwSxiLGZoSIhAE04w%2Fuploads%2FXk2ZCGxbf5O96Gw0VHBa%2Freflection_animated_texture.png?alt=media&token=166f7156-9b23-421e-bb41-e1e6ad28b45b>" %}

`reflection_animated_texture.png.pmcmeta`

```json
{
    "animation": {
        "frametime": 2.5,
        "width": 100,
        "height": 100,
        "interpolate": true,
        "frames": [
            {
                "index": 0,"time": 70
            },
            0,
            {
                "index": 1,"time": 1
            },
            1,
            {
                "index": 2,"time": 1
            },
            2,
            {
                "index": 3,"time": 1
            },
            3,
            {
                "index": 4,"time": 1
            },
            4,
            {
                "index": 5,"time": 1
            },
            5,
            {
                "index": 6,"time": 1
            },
            6,
            {
                "index": 7,"time": 1
            }
        ]
    }
}
```

### Scaling Options in MCMeta & Custom Tooltip Example

Minecraft allows to add new tooltips through the tooltip\_style component, for example you need to create two textures with a prefix similar to `<name>_background` and `<name>_frame`

```
📦resource_pack.zip
  └── 📁assets
       └── 📁minecraft
           └── 📁textures
               └── 📁gui
                    └── 📁sprites
                         └── 📁tooltip
                              ├── 🎨awesome_background.png
                              ├── 📝awesome_background.png.mcmeta
                              ├── 🎨awesome_frame.png
                              └── 📝awesome_frame.png.mcmeta
                         
```

Existing types of scaling

| Parameter   | Description                                                                                                      |
| ----------- | ---------------------------------------------------------------------------------------------------------------- |
| stretch     | default method                                                                                                   |
| tile        | the sprite is repeated across the desired space, starting from the top-left.                                     |
| nine\_slice | the sprite is sliced into *4 corners*, *4 edges*, and *1 center slice*, which is tiled across the desired space. |

More scaling options

| Parameter      | Description                                                                                                                         |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| width          | The width of the sprite, in pixels.                                                                                                 |
| height         | The height of the sprite, in pixels.                                                                                                |
| border         | The size in pixels that the border slices should cover on-screen. Required if \[String] type is set to `nine_slice`.                |
| stretch\_inner | the `stretch_inner` option means whether the texture will be stretched or not, to avoid mixels or something like that deactivate it |

border have more options

| Parameter | Description                            |
| --------- | -------------------------------------- |
| left      | Number of pixels of the left border.   |
| top       | Number of pixels of the top border.    |
| right     | Number of pixels of the right border.  |
| bottom    | Number of pixels of the bottom border. |

```json
{
    "gui": {
        "scaling": {
            "border": {
                "left": 10,
                "right": 10,
                "top": 10,
                "bottom": 10
             }
        }
    }
}
```

{% file src="<https://4146076988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDlPwSxiLGZoSIhAE04w%2Fuploads%2FNOXb9Gk7XRfBkruBrNr1%2Fbackground.png?alt=media&token=96464203-0148-4dc5-8912-5142c0ea6e39>" %}
awesome\_background.png
{% endfile %}

`awesome_background.png.mcmeta`

```json
{
    "gui": {
        "scaling": {
            "type": "nine_slice",
            "width": 100,
            "height": 100,
            "border": 9
        }
    }
}
```

{% file src="<https://4146076988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDlPwSxiLGZoSIhAE04w%2Fuploads%2FDW0jFaCC1JugJBDgw90Y%2Fframe.png?alt=media&token=c273d993-1d67-48c3-ac95-2bbfb94e3e46>" %}
awesome\_frame.png
{% endfile %}

`awesome_frame.png.mcmeta`

```json
{
    "gui": {
        "scaling": {
            "type": "nine_slice",
            "width": 100,
            "height": 100,
            "border": 10,
            "stretch_inner": true
        }
    }
}
```

#### Give Custom Tooltip Command

`/give @p diamond[tooltip_style='minecraft:awesome'] 1`

## GUI Routes

{% hint style="warning" %}
Examples made in 1.21.4
{% endhint %}

```
📦resource_pack.zip
  └── 📁assets
       └── 📁minecraft
           └── 📁textures
               └── 📁gui
                   ├── 📁advancements
                   │    ├── 📁backgrounds
                   │    │    └── 🎨<textures>
                   │    └── 🎨<textures>
                   ├── 📁container
                   │    ├── 📁creative_inventory
                   │    │    └── 🎨<textures>
                   │    └── 🎨<textures>
                   ├── 📁hanging_signs
                   │    └── 🎨<textures>
                   ├── 📁presets
                   │    └── 🎨<textures>
                   ├── 📁realms
                   │    └── 🎨<textures>
                   ├── 📁sprites
                   │    ├── 📁advancements
                   │    │    └── 🎨<textures>
                   │    ├── 📁boss_bar
                   │    │    └── 🎨<textures>
                   │    ├── 📁container
                   │    │    ├── 📁anvil
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁beacon
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁blast_furnace
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁brewing_stand
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁bundle
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁cartography_table
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁crafter
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁creative_inventory
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁enchanting_table
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁furnace
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁grindstone
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁horse
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁inventory
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁loom
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁slot
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁smithing
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁smoker
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁stonecutter
                   │    │    │    └── 🎨<textures>
                   │    │    ├── 📁villager
                   │    │    │    └── 🎨<textures>
                   │    │    └── 🎨<textures>
                   │    ├── 📁gamemode_switcher
                   │    │    └── 🎨<textures>
                   │    ├── 📁hud
                   │    │    ├── 📁heart
                   │    │    │     └── 🎨<textures>
                   │    │    └── 🎨<textures>
                   │    ├── 📁icon
                   │    │    └── 🎨<textures>
                   │    ├── 📁notification
                   │    │    └── 🎨<textures>
                   │    ├── 📁pending_invite
                   │    │    └── 🎨<textures>
                   │    ├── 📁player_list
                   │    │    └── 🎨<textures>
                   │    ├── 📁popup
                   │    │    └── 🎨<textures>
                   │    ├── 📁realm_status
                   │    │    └── 🎨<textures>
                   │    ├── 📁recipe_book
                   │    │    └── 🎨<textures>
                   │    ├── 📁server_list
                   │    │    └── 🎨<textures>
                   │    ├── 📁social_interactions
                   │    │    └── 🎨<textures>
                   │    ├── 📁spectator
                   │    │    └── 🎨<textures>
                   │    ├── 📁statistics
                   │    │    └── 🎨<textures>
                   │    ├── 📁toast
                   │    │    └── 🎨<textures>
                   │    ├── 📁tooltip
                   │    │    └── 🎨<textures>
                   │    ├── 📁transferable_list
                   │    │    └── 🎨<textures>
                   │    ├── 📁widget
                   │    │    └── 🎨<textures>
                   │    └── 📁world_list
                   │         └── 🎨<textures>
                   ├── 📁title
                   │    ├── 📁background
                   │    │    └── 🎨<textures>
                   │    └── 🎨<textures>
                   └── 🎨<textures>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.elitefantasy.net/resourcepack-guide/beginning/textures.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.