update_boss_bar
Updates the properties of an existing boss bar created by create_boss_bar.
Categories: visual
Required arguments
| Key(s) | Description | Type |
|---|
id | The ID of the boss bar to update. | STRING |
Optional arguments
| Key(s) | Description | Type | Default |
|---|
progress | The new progress value (0–100). Supports expressions. | EXPRESSION | |
name | The new display name of the boss bar. Supports placeholders. | STRING | |
color | The new color of the boss bar (e.g. BLUE, RED). | STRING | |
style | The new overlay style of the boss bar (e.g. PROGRESS, NOTCHED_10). | STRING | |
Example
effects:
- id: update_boss_bar
args:
id: boss_%player_name%
progress: <expression> # ← Optional
name: %player_name%'s Boss # ← Optional
color: RED # ← Optional
style: NOTCHED_10 # ← Optional
Behaviour
| Setting | Value |
|---|
| Run order | NORMAL |
| Supports delay | true |
| Reloads on plugin reload | true |
| Permanent | false |