Creating a new hud
New hud
Display
Permission
Toggle command
Toggle actions
Hud content
Create new hud by adding new section to the section "huds" inside config.yml
1
configuration:
2
hud-refresh:
3
period: 1 #IN SECONDS
4
5
huds:
6
example-hud: #I've just added the section for the new hud
Copied!
You can create unlimited number of huds, but only one hud can be active at one time
Now choose what display method you want to use. There only 2 options: ACTIONBAR and BOSSBAR
1
configuration:
2
hud-refresh:
3
period: 1 #IN SECONDS
4
5
huds:
6
example-hud:
7
display: ACTIONBAR
8
Copied!
Actionbar is recommended, because it's responsive to the client's resolution settings
If you want, you can set permission condition for this hud. Players without this permission won't see this hud. (This is optional)
1
configuration:
2
hud-refresh:
3
period: 1 #IN SECONDS
4
5
huds:
6
example-hud:
7
display: ACTIONBAR
8
permission: "betterhud.hud.example" #This is an example, you can change the whole text
Copied!
You can also create a new toggle command for the hud. This is optional as well.
1
configuration:
2
hud-refresh:
3
period: 1 #IN SECONDS
4
5
huds:
6
example-hud:
7
display: ACTIONBAR
8
permission: "betterhud.hud.example" #This is an example, you can change the whole text
9
toggle-command: "/examplehud" #This will take effect after restarting the server
Copied!
If you want to display the hud, when certain event is called, you can set toggle-actions

Available toggle actions:

1
on-gamemode-change-to: "SURVIVAL" #Valid values: SURVIVAL, ADVENTURE, CREATIVE, SPECTATOR
2
on-join: true
3
underwater: true
4
on-damage-by-entity: true
5
on-damage-by-player: true
Copied!

Example (we want to show this hud, only when player is under water):

1
configuration:
2
hud-refresh:
3
period: 1 #IN SECONDS
4
5
huds:
6
example-hud:
7
display: ACTIONBAR
8
permission: "betterhud.hud.example" #This is an example, you can change the whole text
9
toggle-command: "/examplehud" #This will take effect after restarting the server
10
toggle-actions:
11
underwater: true
Copied!
Copy link