> ## Documentation Index
> Fetch the complete documentation index at: https://mbcz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lifesteal

> Hearts, withdraw, send, revive, and Heart Core.

The heart module is the Lifesteal loop: kill players to gain hearts, die to lose them, withdraw hearts as items, send them, and revive banned players.

Apply the blueprint first:

```text theme={null}
/smply preset lifesteal
```

Then `/heart` must open Heart Core (after reload if you only flipped the module in Settings).

<Frame>
  <img src="https://mintcdn.com/mbcz/rS3T1Jj6YIDtgdo5/images/smply/hearts-core.gif?s=fc5c74c263d59fa2313e3dfa93755dfe" alt="Heart Core GUI" width="600" height="246" data-path="images/smply/hearts-core.gif" />
</Frame>

## Players

| Command                         | What it does                                                             |
| ------------------------------- | ------------------------------------------------------------------------ |
| `/heart`                        | Open Heart Core.                                                         |
| `/heart withdraw <amount>`      | Take hearts out as items (default `RED_DYE`).                            |
| `/heart send <player> <amount>` | Send hearts to another player.                                           |
| `/heart top`                    | Chat ranks. The Hearts menu Heart Top tile opens the hearts leaderboard. |

Permission: `smply.heart.withdraw` (default true).

## Defaults after the Lifesteal preset

```yaml title="heart.yml (excerpt)" theme={null}
heart:
  starting_hearts: 10
  min_hearts: 1
  max_hearts: 20
  gain_on_player_kill: 1
  lose_on_death: 1
  death_ban:
    enabled: false
    duration_minutes: 1440
  withdraw:
    enabled: true
  send:
    enabled: true
  revive:
    enabled: true
    cost_hearts: 2
    restore_hearts: 8
```

Hardcore variant: max 10 hearts, death ban on. Casual: shorter combat tag, logout-kill off. See [Presets](/smply/presets).

## Staff

```text theme={null}
/heart revive <player>
```

Permission: `smply.heart.admin`. Clears a death ban and restores hearts. Also available from the admin desk.

## HUD

The Lifesteal blueprint is hearts-first (no `$` on the sidebar). Tokens: `{hearts}` in `hud.yml`, `%smply_hearts%` for TAB. Lines that mention hearts hide when the module is off.

## Leaderboards

`/leaderboards` includes a hearts category when the module is on. Empty boards show a named plaque plus Back, not a blank barrier chest.