> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edmortars/mortars/hologram.md).

# Hologram

A plain-text status display floats above every mortar. It shows one of three line lists: `locked`, `ready` or `cooldown` (while reloading, with a live countdown).

```yaml
hologram:
  enabled: true
  offset: 3.2                 # modelengine look only (height at model scale 1.0); the vanilla look uses models.vanilla.hologram-height
  background: '#00000000'     # '#AARRGGBB' behind the text, '' = Minecraft's grey box
  text-shadow: true
  locked:
    - '{mortar}'
    - '&8&m        &r &c&lLOCKED &8&m        '
    - '&7Unlock it to fire while you mine'
    - '&3[ʀɪɢʜᴛ-ᴄʟɪᴄᴋ ᴛᴏ ᴜɴʟᴏᴄᴋ]'
  ready: [ ... ]
  cooldown: [ ... ]
```

Tokens: `{mortar}`, `{player}` (the owner), `{cooldown}`, `{reload}`, `{shells}`, `{chance}`, `{multiplier}`, `{radius}`, `{<upgrade>-level}`, `{<upgrade>-max-level}`, `{<upgrade>-name}`. PlaceholderAPI placeholders are read for the mine owner.

It refreshes every `hologram-update-ticks` (config.yml), only for mortars someone is looking at, and only sends a packet when the text changed.