popups

There are several ways to run a popup.

1. run it as a command
2. register it in config.yml as a default-popup to display the popup when a condition is met. (in this case, you should not set a duration.)
3. can use a trigger

triggers

group

create multiple popups as a group.

default: none

ex. group: skill

queue

whether to save out-of-queue popups

default: false

By default, when set to move.duration: 4, popups can only be displayed for a maximum of four,

and any further requests for popups will be ignored due to lack of space.

when you use queue: true, it works like this

for example, after sending a total of 6 popups in 1 tick increments, after 1 tick, we see the following structure

will still see up to four popups, but will start to see a fifth popup after the first one ends.

waiting popups will also have a reduced duration. to prevent this, the following options are used

always-check-condition

whether popups outside of the queue should also have animated ticks.

default: true

always-check-condition: false, waiting popups will not decrease in duration.

sort

options for how you want to arrange the popups.

default: last

sort: first is performed in a stack fashion,

sort: last is performed using queue fashion.

duration

determine the duration of the popup.

the unit is tick and will last indefinitely if not entered.

default: 0 (infinite)

key-mapping

mapping popups with a specific key as the unique key.

this is needed, for example, to display the health bar of an entity or another player.

default: false

x,y coord

in the same way as the hud, you define where to divide the player screen into percentages.

move

set rules for placing popups when displaying multiple popups.

duration

maximum number of popups you want to display on the screen.

pixel

define how it should be moved pixel by pixel in the same way as layout.

it has a very close relationship with the operations documentation

for example, if you simply want to offset to the right by 20 pixels, you can do something like x-equation: 20t

To do something like this photo

buff_absorption:
  group: buff
  layouts:
    1:
      name: buff_absorption
      x: 90
      y: 10
  conditions:
    1:
      first: potion_effect_duration:absorption
      second: 0
      operation: ">"
  move:
    duration: 33
    pixel:
      x-equation: -floor((t - 1) / 8) * 40
      y-equation: (((t - 1) % 8) + 1) * 40

in this way, some math knowledge is required.