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

# HUD

> Sidebar scoreboard, built-in tablist, and TAB deferral.

Smply can show a right-side sidebar and a built-in player-list header/footer. Both live in `hud.yml`. Players can toggle the sidebar from profile settings.

<Frame>
  <img src="https://mintcdn.com/mbcz/rS3T1Jj6YIDtgdo5/images/smply/thumb-hud.png?fit=max&auto=format&n=rS3T1Jj6YIDtgdo5&q=85&s=b515210123a6ccee76914c5a021a7c8d" alt="Player HUD gallery card" width="1280" height="720" data-path="images/smply/thumb-hud.png" />
</Frame>

## Sidebar

The HUD module must be enabled (Vanilla+, Lifesteal, and Economy presets turn it on).

* Lifesteal blueprint: hearts-first lines, no `$`
* Economy blueprint: balance-first, farm → sell → shop
* Vanilla+: mint `{server_name}`, no hearts

Tokens in `hud.yml` lines include `{player}`, `{server_name}`, `{hearts}`, `{balance}`, `{bounty}`, `{daily_streak}`, `{kills}`, `{deaths}`, `{playtime_minutes}`, `{preset}`.

Set `hud.use_placeholderapi: true` to mix `%placeholders%` after those tokens. Lines that mention `{hearts}`, `{bounty}`, or `{balance}` are omitted when that module or economy is off.

Vanilla score numbers on the sidebar are hidden. Body labels use `<gray>` so they stay readable on the dark sidebar.

Do not enable TAB's own scoreboard if you want this sidebar.

## Tablist

Without TAB, Smply draws MiniMessage header/footer from `hud.yml` → `tablist:`.

With **TAB** installed, leave `tablist.defer_to_tab: true` (default). Smply skips its header/footer and you wire `%smply_*%` in TAB instead.

Example footer line:

```text theme={null}
%smply_tab_stats%
```

Use TAB's `%player%` for the viewer name. See [Placeholders](/smply/placeholders).

## Profile toggles

`/profile` (permission `smply.profile.settings`) lets each player turn the sidebar off, and can disable teleport titles/bossbar when `teleport.yml` `allow_player_disable` is true.