# Configuration
Everything lives in `plugins/Barrier/config.yml`. Edit it, then run `/worldborder reload` to apply it without restarting.
There's a `version` at the top. Leave it alone, it's how Barrier updates your file when you upgrade.
## How the storm treats players
| Setting | Default | What it does |
|---|---|---|
| `should_knockback` | `false` | Whether the storm shoves players around as it damages them |
| `should_allow_totems` | `true` | Whether a totem of undying can save someone from a killing blow |
| `should_subtract_absorption` | `true` | Whether golden hearts soak the damage before real health does |
Knockback is off by default on purpose. It makes the storm considerably more punishing, since it can push a player further out while they're trying to run in. Turn it on only if that's the experience you want.
## Border colours
The border can change colour depending on what it's doing, so players can tell at a glance whether it's closing in:
```yaml
storm_colors:
idle: "#2FF4FF"
moving: "#FF0000"
shrinking: "#FF0000"
growing: "#FF0000"
moving_while_growing: "#FF0000"
moving_while_shrinking: "#FF0000"
```
Out of the box it's blue when still and red whenever it's doing anything. Leave a value empty to use the border's own colour for that state instead.
A colour set with `/worldborder color` always wins over these.
## The command layout
| Setting | Default | What it does |
|---|---|---|
| `legacy_commands` | `false` | Brings back the older `/worldborder set` behaviour |
This decides how `/worldborder set` works:
| | `/worldborder set <value>` | Setting the height |
|---|---|---|
| `false`, new installs | Width and length | `/worldborder set height <value>` |
| `true`, upgraded configs | Width, length and height together | The `-h` flag on `set` |
**If you upgraded an existing Barrier, this was switched on for you** the first time you started up after updating, so your existing macros and datapacks carry on working unchanged.
To move to the new layout, set it to `false` and run `/worldborder reload`. Check anything that calls `/worldborder set` first, since it'll stop touching the height.
## A full example
```yaml
version: 7
legacy_commands: false
should_knockback: false
should_allow_totems: true
should_subtract_absorption: true
storm_colors:
idle: "#2FF4FF"
moving: "#FF0000"
shrinking: "#FF0000"
growing: "#FF0000"
moving_while_growing: "#FF0000"
moving_while_shrinking: "#FF0000"
```
## Related Pages
- [[Barrier/Server Owners/Overview]], what Barrier does
- [[Barrier/Server Owners/Commands]], every command with examples