# Configuration
Barrier uses a single `config.yml` file located in the plugin's data folder. The configuration controls storm behavior including knockback, totem interactions, absorption heart handling, and visual phases.
---
## Config Version
The `version` key tracks the internal config schema version. Barrier automatically migrates older configurations to the latest version on startup. Do not modify this value manually.
**Current version:** `4`
---
## Settings Reference
| Key | Type | Default | Description |
|---|---|---|---|
| `version` | Integer | `6` | Internal config version. Do not edit manually. |
| `should_knockback` | Boolean | `false` | If enabled, players inside the storm receive knockback. This should remain disabled unless you want to further punish players caught in the storm. |
| `should_allow_totems` | Boolean | `true` | If enabled, the storm accounts for totems of undying when dealing lethal damage. Players holding a totem can survive a killing blow from the storm. |
| `should_subtract_absorption` | Boolean | `true` | If enabled, the storm subtracts absorption hearts (golden hearts) before dealing damage to the player's actual health bar. |
| `storm_colors` | Section | — | Border color per storm state (`idle`, `moving`, `shrinking`, `growing`, `moving_while_growing`, `moving_while_shrinking`), as hex colors (e.g. `"#FF0000"`). Empty = use the border's default color. A color set via command or API always overrides these. Defaults: idle blue, every other state red. |
---
## Default Config
```yaml
version: 6
# If enabled, players stuck in storm will experience knockback
# TIP: This should be disabled unless you want to punish players more while inside storms
should_knockback: false
# Should the storm account for totems of undying
should_allow_totems: true
# Should the storm account for absorption hearts
should_subtract_absorption: true
# Border color per storm state, as a hex color (e.g. "#FF0000").
# Empty = use the border's default color.
# NOTE: A color set via command or API always overrides these.
storm_colors:
idle: "#2FF4FF"
moving: "#FF0000"
shrinking: "#FF0000"
growing: "#FF0000"
moving_while_growing: "#FF0000"
moving_while_shrinking: "#FF0000"
```
---
## Reloading
The configuration can be reloaded at runtime using the `/worldborder reload` command. This re-reads `config.yml` from disk without requiring a server restart.
---
## Related Pages
- [[Barrier/Server Owners/Overview]] — plugin overview and feature list
- [[Barrier/Server Owners/Commands]] — complete command reference