Text Display

Show floating text above any custom block or furniture. Supports MiniMessage and PlaceholderAPI.

Attaches one or more floating text displays to a custom block or furniture. Supports MiniMessage formatting, PlaceholderAPI placeholders, and ItemsAdder font images.

Works on blocks, furniture, and complex furniture.

Basic configuration

behaviours:
  text_display:
    text: "<yellow>Hello!"

Multi-line text (one line per list entry):

behaviours:
  text_display:
    text:
      - "<bold>Storage"
      - "<gray>Right-click to open"

Multiple displays

Use the displays section to attach more than one text display to the same item. Each entry is independently positioned and styled.

behaviours:
  text_display:
    displays:
      label:
        text: "<gold><bold>My Chest"
        offset: "0, 0.5, 0"
      hint:
        text: "<gray><i>Right-click to open"
        offset: "0, 0.25, 0"

Options

Key	Type	Default	Description
`text`	string or list	(required)	The text to display. Supports MiniMessage, PlaceholderAPI, and `:icon:` font images.
`offset`	`"x, y, z"` or list	`"0, 0.25, 0"`	Position offset relative to the block or furniture center.
`billboard`	`FIXED` \| `VERTICAL` \| `HORIZONTAL` \| `CENTER`	`VERTICAL`	How the display rotates to face players.
`alignment`	`LEFT` \| `CENTER` \| `RIGHT`	`CENTER`	Text alignment within the display.
`text_shadow`	boolean	`true`	Whether text has a drop shadow.
`see_through`	boolean	`false`	Whether text is visible through blocks.
`line_width`	integer ≥ 1	`1403`	Maximum line width in pixels before wrapping.
`background`	`#RRGGBB`, `#RRGGBBAA`, `false`, or `null`	`null`	Background color. `null` or `false` uses the vanilla default dark background.
`text_opacity`	float 0.0-1.0	(omit for default)	Text opacity. `0.0` is fully transparent, `1.0` is fully opaque. Omit the key entirely for the vanilla default (fully opaque).
`scale`	float > 0, `"x, y, z"`, or list	`1.0`	Text size multiplier. A single value applies uniformly; use `"x, y, z"` or a 3-element list for non-uniform scaling.
`view_range`	float > 0	`16.0`	Distance in blocks at which the display becomes visible.
`refresh_interval`	integer ≥ 0	`0`	How often (in ticks) the text is refreshed per player. `0` disables auto-refresh. Set to a positive value when using PlaceholderAPI placeholders that change over time.
`brightness`	integer 0-15, `[block, sky]`, or section	(omit for world lighting)	Override the light level. A single integer sets both block and sky light equally. Use a two-element list `[block, sky]` or a section with `block:` and `sky:` keys to set them separately. Omit to inherit from world lighting.
`shadow_radius`	float ≥ 0	`0.0`	Radius of the drop shadow behind the text.
`shadow_strength`	float ≥ 0	`1.0`	Strength (opacity) of the drop shadow.
`yaw`	float	`0.0`	Horizontal rotation of the display in degrees. Only meaningful when `billboard` is `FIXED`.
`pitch`	float	`0.0`	Vertical rotation of the display in degrees. Only meaningful when `billboard` is `FIXED`.

Full example

behaviours:
  text_display:
    text:
      - "<aqua><player_name>"
      - "<gray>Score: <gold>%vault_eco_balance%"
    offset: "0, 0.6, 0"
    billboard: VERTICAL
    alignment: CENTER
    text_shadow: true
    see_through: false
    line_width: 1403
    background: "#00000080"
    scale: 1.0
    view_range: 16.0
    refresh_interval: 20

Notes

Text supports MiniMessage formatting tags.
PlaceholderAPI placeholders are resolved per-player if PlaceholderAPI is installed.
ItemsAdder font images (:my_icon:) are supported.
When using placeholders that update over time, set refresh_interval to a positive value (e.g. 20 for once per second).

Basic configuration

Multiple displays

Options

Full example

Notes

On this page