📄 layouts.yml

Layouts are the blueprints for your health bars. They define what lines of text or components are displayed and how they are arranged in 3D space.

Purpose

In a layout file, you create a list of layout-lines, where each line is a separate TextDisplay entity that hovers over the mob.

Example

layout-lines:
  - line: '&f%sunshine_mob_name%'
    x-offset: 0
    y-offset: 0.25
    z-offset: 0
    scale: 1.0

  - line: '%component_health_bar%'
    x-offset: 0
    y-offset: 0
    z-offset: 0
    scale: 0.8

  - line: '%component_level_display%'
    x-offset: 0.525
    y-offset: -0.25
    z-offset: 0
    scale: 0.8

Line Options Explained

• line: (Required)

  • The text content for this line. You can use any text, color codes, and placeholders here.

• x-offset: (Optional, default: 0)

  • Moves the line left (negative numbers) or right (positive numbers).

• y-offset: (Optional, default: 0)

  • Moves the line down (negative numbers) or up (positive numbers) relative to the main vertical-offset.

• z-offset: (Optional, default: 0)

  • Moves the line forward (positive numbers) or backward (negative numbers).

• scale: (Optional, default: 1.0)

  • Changes the size of the text. 1.0 is normal size, 0.5 is half size, 2.0 is double size.

• shadow: (Optional, default: false)

  • Set to true to give the text a subtle shadow, making it easier to read against bright backgrounds.