> For the complete documentation index, see [llms.txt](https://vitalo.gitbook.io/vitalo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vitalo.gitbook.io/vitalo/customization/hearts.md).

# Hearts

How to configure and change heart textures.

## Configuring Config

Configuring hearts is very similar to configuring the health bars. However with hearts, there are not as many moving pieces. To replace the textures for a heart, go into the `default.json` file and change the `file` value, or change the image directly. If you adjust the sizing, remember to change the height and ascent values appropriately, as well as the spacing.

Here is the current config for hearts.

{% code title="config.yml" %}

```yaml
hearts:
  height: 0.5
  height-with-nametag: 1.2
  
  absorption-height: 0.5
  absorption-height-with-nametag: 0.9
  
  bubbles:
    height: 0.1
    absorption-height: 0.25
```

{% endcode %}

* <mark style="color:red;">**height:**</mark> The height of the hearts above the entities head
* <mark style="color:red;">**height-with-nametag:**</mark> The height of the heights when the entity's nametag is showing
* <mark style="color:red;">**absorption-height**</mark> The height of the absorption hearts.&#x20;
* <mark style="color:red;">**absorption-height-with-nametag:**</mark> The height of the absorption hearts when the entity's nametag is showing
* <mark style="color:red;">**bubbles:**</mark>
  * <mark style="color:red;">**height:**</mark> The height of the bubble hearts
  * <mark style="color:red;">**absorption-height:**</mark> The additional height to add to the bubbles when absorption hearts are active.

## Bubbles

Within the heart system are bubbles, or aspiration. It shows how much air players have left. Just like on your hotbar, it is animated. You can adjust the bubbles in the same way you adjust the other heart textures. Bubbles only show for players.&#x20;