Progress

Evaluate the output of an asset layer's listener.

Attributes


Attribute Aliases Description
layer lay, l The asset layer with the listener to evaluate.
value val, v The value to compare the layer progress against - can be a percent. For range operators, use lower..upper (e.g. 20..80 or 20%..80%).
operation oper, o Logical Operator to compare with.

When using a range operator, the value must be lower..upper. Appending % to either bound (or both) switches to percent-based evaluation.

Example


Hides the Asset in its HUD layout if the air listener used in the fill asset layer is ever less than 100% (so air is in use):

vanilla-air:
  conditions:  #Hide if the fill layer is empty.
    - progress{l=fill;o=<;v=100%} true hide
  # Color red when health fill is between 0% and 25% (inclusive).
  # - progress{l=fill;o=..;v=0%..25%} true color red
  layers:
    icon:
      texture:
        path: assets/vanilla/air.png
      offset:
        x: -5
        y: 2
    fill:
      texture:
        path: assets/vanilla/exp_bar_short_fill.png
      color: "#525aff"
      offset:
        x: 0
        y: 0
      function:
        listener: air
        increment: 13
        orientation: horizontal
Updated Aug 19, 2026