forked from Upstream/Velocitab
49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
Velocitab supports the full range of modern color formatting, including RGB colors and gradients. Both MiniMessage (_default_), MineDown and Legacy formatting are supported. To change which formatter is being used, change the `formatter` value in `config.yml` to `MINEDOWN`, `MINIMESSAGE` or `LEGACY` respectively.
|
|
|
|
Formatting is applied on header, footer and player text for each server group, and is applied after [[Placeholders]] have been inserted.
|
|
|
|
|
|
## MiniMessage syntax reference
|
|
MiniMessage is the default formatter type, enabled by setting `formatter` to `MINIMESSAGE` in `config.yml`. See the [MiniMessage Syntax Reference](https://docs.advntr.dev/minimessage/format.html) on the Adventure Docs for how to format text with it. Using MiniMessage as the formatter also allows compatibility for using MiniPlaceholders in text.
|
|
|
|
## MineDown syntax reference
|
|
MineDown formatting can be enabled by setting `formatter` to `MINEDOWN` in `config.yml`. See the [MineDown Syntax Reference](https://github.com/WiIIiam278/MineDown) on GitHub for the specification of how to format text with it.
|
|
|
|
|
|
## Legacy formatting
|
|
> **Warning:** The option for legacy formatting is provided only for backwards compatibility with other plugins. Please consider using the MineDown or MiniMessage options instead!
|
|
|
|
Legacy formatting can be enabled by setting `formatter` to `LEGACY` in `config.yml`. Legacy formatter supports Mojang color and formatting codes (e.g. `&d`, `&l`), Adventure-styled RGB color codes (e.g. `&#a25981`), as well as BungeeCord RGB color codes (e.g. `&x&a&2&5&9&8&1`). See the [LegacyComponentSerializer Syntax Reference](https://docs.advntr.dev/serializer/legacy.html) on the Adventure Docs for more technical details.
|
|
|
|
## Multi-line strings
|
|
In order to have a multi-line string in YAML, you can use the `|-` or `|` syntax. The `|-` syntax will remove last newline character, while the `|` syntax will keep it.
|
|
You can also use `\n` to add a newline character in a string.
|
|
|
|
### Example 1
|
|
```yaml
|
|
foo: |-
|
|
bar 1
|
|
bar 2
|
|
bar 3
|
|
```
|
|
|
|
is equivalent to
|
|
|
|
```yaml
|
|
foo: "bar 1\nbar 2\nbar 3"
|
|
```
|
|
|
|
### Example 2
|
|
|
|
```yaml
|
|
foo: |
|
|
bar 1
|
|
bar 2
|
|
bar 3
|
|
```
|
|
|
|
is equivalent to
|
|
|
|
```yaml
|
|
foo: "bar 1\nbar 2\nbar 3\n"
|
|
``` |