Popups

Popups are collections of elements (positioned assets) that are displayed together. These are different from layouts because they only last for the time that is specified in ticks.

Require Unique

This option is either true or false. If true, the popup will only display is there is not already an element displayed with the same arguments. This is useful for preventing duplicate messages.

Element

An element is a positioned asset on a popup.

Alignment

You can choose if the element should align on the right, left, or center. The default if not specified is right.
align: center

Offset

If you would like to move a element around by pixels you would set the offset. Offset works through pixel perfect adjustments.

Position

The position of an element depends on the ScreenSize of the player. It works by percents so 50 = 50%. If you set x = 50 and y = 50 the element would be in the center of the screen. The percentages are precise to a single decimal space.

Example Element

1
slot-1:
2
asset: action-bar
3
position:
4
x: 50.0
5
y: 0.0
6
offset:
7
x: 0
8
y: 85

Example Popup

1
death-message:
2
elements:
3
kill-1:
4
asset: death-message
5
align: left
6
position:
7
x: 100.0
8
y: 100.0
9
offset:
10
x: -20
11
y: -20
12
kill-2:
13
asset: death-message
14
align: left
15
position:
16
x: 100.0
17
y: 100.0
18
offset:
19
x: -20
20
y: -40
21
kill-3:
22
asset: death-message
23
align: left
24
position:
25
x: 100.0
26
y: 100.0
27
offset:
28
x: -20
29
y: -60
30
kill-4:
31
asset: death-message
32
align: left
33
position:
34
x: 100.0
35
y: 100.0
36
offset:
37
x: -20
38
y: -80
39
kill-5:
40
asset: death-message
41
align: left
42
position:
43
x: 100.0
44
y: 100.0
45
offset:
46
x: -20
47
y: -100

Example Popup Asset

1
death-message:
2
layers:
3
icon:
4
texture:
5
scale: 0.5
6
path: assets/death-message/icon.png
7
offset:
8
x: 86
9
y: -2
10
killer:
11
text: "%arg-1%"
12
font: "default"
13
outlined: true
14
align: left
15
offset:
16
x: 80
17
y: -2
18
victim:
19
text: "%arg-2%"
20
font: "default"
21
outlined: true
22
align: right
23
offset:
24
x: 100
25
y: -2
26
outline:
27
texture:
28
path: assets/death-message/outline.png

Sending a Popup

Sending a popup is as easy as sending a command.

Command Syntax

/happyhud popup <player> <popup> <ticks> <args separated by '|'>

Example Command

/happyhud popup Notch action-bar 60 Hello There Notch!