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