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.