Skip to main content
Text elements display dynamic text content in HUDs and popups. They’re configured in YAML files in the texts/ directory.

​
File Structure

Text configuration files are located at:
  • plugins/BetterHud/texts/

​
Basic Text Structure

entity-font.yml
entity_font:
  merge-default-bitmap: true
  use-unifont: true
  include: []

​
Configuration Options

​
merge-default-bitmap
boolean
default:"true"
Merge with default font bitmap
​
use-unifont
boolean
default:"true"
Use Unifont for Unicode character support
​
include
array
default:"[]"
List of additional font files to include
​
text
string
Static text content to display
​
placeholder
string
Placeholder to resolve for dynamic text
​
color
string
Text color in hex format (e.g., #FFFFFF)

​
Examples

​
Static Text

static-text.yml
welcome_text:
  text: "Welcome to the Server!"
  color: "#00FF00"
  merge-default-bitmap: true
  use-unifont: true

​
Dynamic Text with Placeholder

dynamic-text.yml
player_health_text:
  placeholder: "<health>"
  color: "#FF0000"
  merge-default-bitmap: true
  use-unifont: true

​
Formatted Text

formatted-text.yml
player_info:
  placeholder: "<player_name> - Level <player_level>"
  color: "#FFAA00"
  merge-default-bitmap: true

​
Text Formatting

Text supports placeholders and formatting: 
formatted_display:
  placeholder: "Health: <red><health></red> | Mana: <blue><mana></blue>"

​
Font Files

Custom fonts can be added to:
  • plugins/BetterHud/fonts/
Supported formats:
  • TrueType Font (.ttf)
  • Unifont (.hex)

​
See Also

Fonts

Configure font settings

Placeholders

Use dynamic placeholders

Layouts

Position text in layouts

Colors

Text color formatting

Build docs developers (and LLMs) love

Get started for freeTalk to us