give_health
Heals the player by the specified amount, capped at their maximum health.
Categories: player
Required arguments
| Key(s) | Description | Type |
|---|
amount | The amount of health points to restore. Supports expressions. | EXPRESSION |
Optional arguments
| Key(s) | Description | Type | Default |
|---|
trigger_heal | If true, fires an EntityRegainHealthEvent and respects cancellation (e.g. for Mending). Defaults to false. | BOOLEAN | false |
Trigger parameters required
Example
effects:
- id: give_health
args:
amount: %level% * 2
trigger_heal: true # ← Optional
Behaviour
| Setting | Value |
|---|
| Run order | NORMAL |
| Supports delay | true |
| Reloads on plugin reload | true |