> For the complete documentation index, see [llms.txt](https://lethium.gitbook.io/origin-smp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lethium.gitbook.io/origin-smp/stackmaster/display.md).

# Display

The nametag above mob stacks, the label above item piles, the hologram above spawner stacks, and the colour codes and placeholders they use.

StackMaster shows a stack's size in three places. Each has its own settings.

| What           | Where it shows                             | Config                           |
| -------------- | ------------------------------------------ | -------------------------------- |
| Mob stacks     | The mob's own nametag                      | `stacking-entities.display`      |
| Item piles     | The item's own name label (off by default) | `stacking-items.entity`          |
| Spawner stacks | A floating text above the block            | `stacking-spawners.display`      |
| Spawner info   | Action bar on right-click                  | `stacking-spawners.display.info` |

## Mob nametags

```yaml
stacking-entities:
  display:
    enabled: true
    name-format: "&f{entity} &8×&b{size}"
    show-stack-size: true
    hide-size-when-one: true
    update-interval-ticks: 10
    packet-threshold: 1
```

| Key                  | Default                  | What it does                                                                                                          |
| -------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| `enabled`            | `true`                   | Nametags on stacks. With `false`, a nametag StackMaster set earlier is removed the next time that stack changes size. |
| `name-format`        | `&f{entity} &8×&b{size}` | Nametag text. `{entity}` is the mob name, `{size}` the stack size.                                                    |
| `hide-size-when-one` | `true`                   | A stack that is down to one mob shows only the mob name.                                                              |

`show-stack-size`, `update-interval-ticks` and `packet-threshold` are in the file but have no effect. The nametag is updated whenever the size changes, and only when its text really changed.

`{entity}` is the mob type in plain words: `ZOMBIE` becomes `Zombie`, `CAVE_SPIDER` becomes `Cave Spider`.

Format examples:

| `name-format`               | Shows        |
| --------------------------- | ------------ |
| `&f{entity} &8×&b{size}`    | Zombie ×10   |
| `{entity} &8×{size}`        | Zombie ×10   |
| `&f{entity} &8[&b{size}&8]` | Zombie \[10] |

**Names from players and other plugins are never touched.** StackMaster remembers the exact text it put on a mob (persistent data `stackmaster:display_name`). A mob that has another name, from a name tag or a custom mob plugin, keeps that name and gets no size nametag. This also means a stack's own nametag never counts as a "custom name" when mobs are matched.

Display settings can be changed per mob type and per world like every other `stacking-entities` key. See [Mob stacking](/origin-smp/stackmaster/entity-stacking.md#per-mob-and-per-world-overrides).

## Item labels

| Key                                        | Default     | What it does                                  |
| ------------------------------------------ | ----------- | --------------------------------------------- |
| `stacking-items.entity.display-stack-size` | `false`     | Show a label with the count above piles.      |
| `stacking-items.entity.display-format`     | `&b×{size}` | Label text. `{size}` is the total item count. |

## Spawner holograms

```yaml
stacking-spawners:
  display:
    enabled: true
    name-format: "&e{entity} Spawner &8×&f{size}"
    name-format-single: "&e{entity} Spawner"
    show-stack-size: true
    hide-size-when-one: true
    update-interval-ticks: 10
    info:
      actionbar: "&e{entity} Spawner &8×&f{size} &8| &7Next spawn: &f{next}"
```

| Key                  | Default                                                      | What it does                                                                                                                |
| -------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `enabled`            | `true`                                                       | The hologram above each spawner stack.                                                                                      |
| `name-format`        | `&e{entity} Spawner &8×&f{size}`                             | Hologram text. `{entity}`, `{size}`.                                                                                        |
| `name-format-single` | `&e{entity} Spawner`                                         | Used for a stack of one when `hide-size-when-one` is `true`.                                                                |
| `hide-size-when-one` | `true`                                                       | Use `name-format-single` for a stack of one.                                                                                |
| `info.actionbar`     | `&e{entity} Spawner &8×&f{size} &8\| &7Next spawn: &f{next}` | Shown when a player right-clicks a stack with an empty hand. Placeholders `{entity}` `{size}` `{next}` `{delay}` `{range}`. |

The hologram is a text display entity just above the block. It faces the player, is not visible through walls, has no background box, and can be read from about 24 blocks. It is not saved with the world: StackMaster creates it again when the spawner's chunk loads.

In the action bar, `{next}` is the time to the next spawn (`12s`), `{delay}` the delay range (`10s - 40s`) and `{range}` the spawn range in blocks.

`show-stack-size` and `update-interval-ticks` are in the file but have no effect.

## Colours

Every text in `config.yml` (nametags, holograms, spawner items, menu, messages) uses:

* `&` colour and format codes: `&a`, `&l`, `&8` ...
* Hex colours: `&#RRGGBB`, for example `&#E5B95F`.

Spawner item names and lore are never shown in italics.

## Spawner items and menu

The look of spawner items is under `stacking-spawners.item`, the menu under `stacking-spawners.gui`. Both are on the [Spawners](/origin-smp/stackmaster/spawners.md) page.

## Messages

Chat and action bar messages are in the `messages` section. See [config.yml](/origin-smp/stackmaster/config-yml.md#messages).