Skip to main content
The font.yml file controls how text is rendered in the resource pack.

​
File Structure

Font configuration is located at:
  • plugins/BetterHud/font.yml

​
Configuration Options

font.yml
scale: 16
height: 8
ascent: 7
merge-default-bitmap: true
use-unifont: true
​
scale
integer
default:"16"
Font scale multiplier for all text
​
height
integer
default:"8"
Character height in pixels
​
ascent
integer
default:"7"
Baseline offset for character alignment
​
merge-default-bitmap
boolean
default:"true"
Merge with Minecraft’s default font bitmap
​
use-unifont
boolean
default:"true"
Enable Unifont for Unicode character support (Chinese, Japanese, Korean, etc.)

​
Font Scale

The scale affects how large text appears: 
# Small text
scale: 12
height: 6
ascent: 5

# Normal text (default)
scale: 16
height: 8
ascent: 7

# Large text
scale: 24
height: 12
ascent: 10

​
Custom Fonts

Add custom TrueType fonts to:
  • plugins/BetterHud/fonts/
Then reference them in config.yml:
config.yml
default-font-name: "custom_font.ttf"

​
Unicode Support

Enable use-unifont for full Unicode support: 
use-unifont: true
This enables:
  • Chinese characters (中文)
  • Japanese characters (日本語)
  • Korean characters (한국어)
  • Cyrillic alphabet (Русский)
  • Arabic script (العربية)

​
Font Quality

For high-quality text rendering: 
scale: 32
height: 16
ascent: 14
merge-default-bitmap: true
use-unifont: true
Higher scale values produce sharper text but increase resource pack size.

​
Troubleshooting

Increase the scale value for sharper rendering:
scale: 24  # or higher
Enable Unifont for Unicode support:
use-unifont: true
Adjust the ascent value to change baseline position:
ascent: 7  # Try different values

​
See Also

Text Configuration

Configure text elements

Resource Packs

How fonts are generated

Main Config

Set default font name

Placeholders

Use dynamic text

Build docs developers (and LLMs) love

Get started for freeTalk to us