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

# Extra Heart

Extra heart item configuration.

## Template

```yaml
heartItem:
  enabled: true/false
  name: "Your Extra Heart Item Name"
  material: "PAPER"
  lore:
    - "Line 1"
    - "Line 2"
  loseChance: number between 0-100
  addLimit: number
  withdraw-enabled: true/false
```

## `enabled`

Determines **if the extra heart** item **is usable**.

## `name`

You can put **any name** here that **Minecraft allows**. Of course **colors** are **supported**.

## `material`

This is **where you define** what extra heart **item should be**. You have to **take name** of the "material" from [**spigot documentation**](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html). ***Please note that the names are case sensitive.***

## `lore`

Here you can **add** a **description** to the **item extra heart** the way **Minecraft allows**. **Colors** are **supported**.

## `loseChance`

When using an **extra heart**, you may **face a case where you fail to use it**. This setting **defines** the **chance of losing a heart** when you **fail to use the extra heart item**.

## `addLimit`

**Sets** the **limit** of **hearts** that can be **obtained** using the **extra heart item**.

## `withdraw-enabled`

**Determines** if the **withdrawal system** is **enabled**.

## `mode`

There are **3** modes.

`always` - Heart will **always drop out of a killed player**, it will **not** be **added immediately** to killer's maximum life.

`limit_exceeded` - Heart **will be immediately added to killer's maximum health**, **except** if killer **exceeds heart limit**, then, **heart drops out of killed player**.

`never` - Heart **will immediately be added to killer's maximum life**, but if killer **exceeds limit**, heart from killed player is **gone**.