Conditions

This is an old version of this page. You can view the most recent version or browse the history.

Conditions allow for bars or their modules to be hidden if they do not meet the criteria that is set. This feature was added in version 1.5.2. Previous versions had a system which used bar options to hide bars which is now removed. Old removed options will be automatically converted to the new conditions format.

Config Examples

In this example the entire bar will be hidden if the condition is not met. The condition will hide the bar if the player is in creative or spectator mode.

health:
  bar:
    width: 40
    function: 'health'
  conditions:
    - 'gamemode{gm=creative,spectator;m=false}'

In this example the number display will be hidden if the condition is not met. The condition will only hide the specific part if not met. In addition to the displays, individual modules may also have conditions.

health:
  bar:
    width: 40
    function: 'health'
  displays:
    icon:
      enabled: true
      type: 'prefix'
      offset: 0
      text: '\uF000'
    number-display:
      enabled: true
      type: 'bar'
      conditions:
        - 'bar-progress{v=1;oper=less;m=true}'
      alignment:
        type: 'center'
      offset: 2
      text: '<white>%value%<gray>/<white>%max%'

Useful Conditions

Conditions	Description
`gamemode{gm=creative,spectator;m=false}`	This condition will be false when a player is in either creative or spectator mode.
`bar-progress{v=0;oper=greater;m=true}`	This condition will be false when the bar is empty.
`bar-progress{v=1;oper=less;m=true}`	This condition will be false when the bar is full.
`mounted{m=false}`	This condition will be false when the player is mounted.
`bar-inactive{m=true}`	This condition will be false when the bar is inactive.

Conditions

Conditions	Description
(bar-inactive)[Bar-Inactive-Condition]	Used for bar inactivity.
bar-progress	Used for detecting the progress of the bar.
effect	Used for detecting potion effects on the player.
mounted	Used for detecting if a player is mounted on a living entity.
placeholder	Used for making custom conditions.