# Extra Heart

## 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**.


---

# 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://devprzemus.gitbook.io/lifesteal/configuration/extra-heart.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.