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

# HUDs

> Text and glyphs that stay on screen, above the hotbar.

A HUD is a line of text drawn on the action bar, above the hotbar, and redrawn again and again so it stays up.

```yaml items/hud/coins.yml theme={null}
coins_hud:
  type: hud
  text: "<shift:60><glyph:coin> <gold>%vault_eco_balance%"
  interval: 10t        # how often it is redrawn (default 10t)
  default: true        # on until the player turns it off (default true)
  permission: myserver.hud.coins
```

* `text` takes [MiniMessage](https://items.lodemc.net/basics.md#text-formatting), [glyphs](https://items.lodemc.net/glyphs.md) and, with [PlaceholderAPI](https://items.lodemc.net/integrations.md#placeholderapi), `%placeholders%`.
* `<shift:N>` moves what follows N pixels right, or left with a negative number. Use it to place a HUD away from the centre.
* `permission` hides the HUD from players without it.

## Turning HUDs on and off

Players use `/hud`:

| Command | Does |
| - | - |
| `/hud` | Lists your HUDs and whether each is on. Click one to switch it. |
| `/hud <id>` | Switches that HUD on or off. |
| `/hud <id> on` / `off` | Turns it on or off. |

Each player's choice is saved on the player.

> [!NOTE]
>
> HUDs use the action bar, so other action bar messages (from LodeItems or other plugins) take its place for a moment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.