Skip to main content
The shader.yml file controls visual effects for HUD elements.

​
File Structure

Shader configuration is located at:
  • plugins/BetterHud/shader.yml

​
Configuration Options

shader.yml
bar-color: yellow
disable-level-text: false
​
bar-color
string
default:"yellow"
Default boss bar color. Options:
  • pink
  • blue
  • red
  • green
  • yellow
  • purple
  • white
​
disable-level-text
boolean
default:"false"
Hide experience level text on the hotbar

​
Boss Bar Colors

Customize the boss bar appearance: 
# Green health bar style
bar-color: green

# Red warning style
bar-color: red

# Blue mana bar style
bar-color: blue

​
Level Text

Control experience level display: 
# Show level text (default)
disable-level-text: false

# Hide level text for custom HUDs
disable-level-text: true
Disabling level text is useful when creating custom experience displays.

​
Visual Effects

Boss bars support various visual styles:

Pink

Romantic style

Blue

Mana/water style

Red

Health/danger style

Green

Nature/poison style

Yellow

Default/energy style

Purple

Magic/enchantment style

White

Neutral style

​
Examples

​
Health Bar Theme

health-theme.yml
bar-color: red
disable-level-text: false

​
Mana Bar Theme

mana-theme.yml
bar-color: blue
disable-level-text: true

​
Custom Experience Display

custom-exp.yml
bar-color: purple
disable-level-text: true

​
API Control

You can also control bar color via the API: 
HudPlayer player = BetterHud.getInstance()
    .getPlayerManager()
    .getHudPlayer(uuid);

if (player != null) {
    player.setBarColor(BossBar.Color.RED);
}

​
See Also

Main Config

Configure boss bar lines

HUDs

Create custom HUD elements

API Reference

Control shaders programmatically

Resource Packs

How shaders are applied

Build docs developers (and LLMs) love

Get started for freeTalk to us