Holograms

To use holograms, you need to install DecentHolograms.

There are 4 hologram types:

STATIC
ANIMATED
ITEM_DISPLAY
BLOCK_DISPLAY

---

Static Hologram

Example

hologram:
  type: static
  text: This is a static hologram
  update: 3
  offset: { x: 0, y: 0, z: 0 }

---

Options

text

• Description: The text displayed in the hologram. Supports color codes and placeholders.

• Example:

  text: '&aThis is a static hologram'

update

• Description: The update timer in ticks. Used to update placeholders.

• Example:

  text: '{generator_timer_seconds} seconds left...'
  update: 3

offset

• Description: The hologram’s offset relative to the spawn position. Supports x, y, and z.

• Example:

  offset: { x: 0, y: 0, z: 0 }

---

Animated Hologram

Example

hologram:
  type: animated
  frames:
    - H
    - He
    - Hel
    - Hell
    - Hello
    - Hell
    - Hel
    - He
    - H
  update: 3

---

Options

frames

• Description: The frames displayed in the hologram. Supports color codes and placeholders.

• Example:

  frames:
    - This or
    - That

update

• Description: The update timer in ticks. Acts as the delay between switching frames.

• Example:

  update: 20

offset

• Description: Optional offset relative to spawn.

• Example:

  offset: { x: 0, y: 0, z: 0 }

---

Item Display Hologram

Example

hologram:
  type: item_display
  item: iron_pickaxe

---

Options

item

• Description: The item displayed in the hologram.

• Example:

  item: iron_sword

offset

• Description: Optional offset relative to spawn.

• Example:

  offset: { x: 0, y: 0.25, z: 0 }

---

Block Display Hologram

Example

hologram:
  type: block_display
  block: diamond_ore

---

Options

block

• Description: The block displayed in the hologram.

• Example:

  block: dirt

offset

• Description: Optional offset relative to spawn.

• Example:

  offset: { x: 0, y: 0.25, z: 0 }

---

Multi-line Holograms

A multi-line hologram is composed of multiple holograms (static, animated, etc.). Use the offset x y z to prevent overlapping and create visually appealing interfaces.

Example

hologram:
  - type: static
    text: This is a title
    offset.y: 1   # X and Z offsets can also be used

  - type: animated
    frames:
      - This is a subtitle
      - This is not a subtitle
    update: 40
    offset.y: 0.75

• Note: The default line height of a hologram is 0.25 blocks.

---