Colors and Styles¶

How to color any text in the plugin, and how to save your own named colors so you do not retype gradients.

Color tags work in every message, scoreboard line, boss bar, action bar, tab line, and menu label.

Color tag formats¶

Format	Example	Result
Classic codes	`&a`, `&c`, `&e`	Standard colors. `&l` bold, `&o` italic, `&r` reset.
Single hex	`&#FF8800`	One hex color.
Solid tag	`<SOLID:FF8800>`	One hex color, tag form.
Gradient	`<GRADIENT:FFD700>text</GRADIENT:FFAA00>`	A fade from the first color to the second.
Rainbow	`<RAINBOW:1.0>text</RAINBOW>`	A rainbow across the text. The number (0.0 to 1.0) sets the strength.
Named style	`<style:NAME>`	A reusable color you defined in `styles.yml`.

Hex colors are six characters (RRGGBB). On older clients they are matched to the nearest standard color.

A gradient title

title: "<GRADIENT:FFD700>zFrostBoats</GRADIENT:FFAA00>"

This fades the text from gold to orange.

Named styles¶

If you reuse the same gradient or color in many places, save it once in styles.yml and refer to it by name. Change it in one place and it updates everywhere.

The file is at plugins/zFrostBoats/styles.yml:

styles-version: 1
styles:
  brand-open: "<GRADIENT:ffd700>"
  brand-close: "</GRADIENT:ffaa00>"
  warn: "&e&l"
  danger: "<SOLID:FF5555>"
  accent: "&#5AC8FA"

Then use any name with the <style:NAME> tag in your messages:

join:
  success: "<style:brand-open>zFrostBoats<style:brand-close> <style:accent>Welcome!"

Styles are just shortcuts

A style stands in for whatever text you set. You can store a full opening or closing gradient tag, a color code, or any mix. If a name is not found, the tag is left as plain text so nothing breaks.

Do not edit styles-version

The styles-version line is managed by the plugin for safe updates. Leave it alone.

Applying changes¶

After editing styles.yml or a language file, run:

/zfb admin reload

Your colors and styles update without a restart.