Appearance
The one colour setting, and the tokens language files may use.
ZyAuctions has exactly one colour knob. You pick a primary colour; everything else is a fixed semantic token.
appearance:
primary: "#5B8DEF"That is not a limitation to work around — it is what keeps the plugin readable. Success is always the same green, errors are always the same red, and a player who has learned what those mean on one server has learned it everywhere.
What primary affects
- The chat prefix —
[Auctions] - Menu titles
- Button names
- Headings in
/ah info
It must be #RRGGBB with the leading #. Anything else logs a warning and falls back to
#5B8DEF:
[ZyAuctions] appearance.primary is 'blue', which is not a #RRGGBB colour.
Using the default #5B8DEF.A second colour, primary_dim, is derived from yours at about 65% lightness. You do not
configure it; it exists so gradients and secondary accents stay in your palette
automatically.
Tokens for language files
Language files use these tags. They are the only way to write a colour — <red> and
<#FF0000> are not tokens and will show up as literal text.
| Token | What it is for |
|---|---|
<primary> | Your colour. Plugin identity: prefix, titles, headings. |
<primary_dim> | Your colour, dimmed. Secondary accents. |
<text> | Default body text. A light grey, readable on both dark and light chat backgrounds. |
<emphasis> | White. Values, names and numbers inside a sentence. |
<muted> | Brackets, separators, hints, footnotes. |
<disabled> | Options that are not available. |
<success> | Something worked. |
<warning> | A recoverable problem, or a confirmation. |
<error> | A failure or a refusal. |
<info> | A neutral notice or tip. |
<link> | Clickable text. Pair with <underlined>. |
<separator> | Rules and dividers. |
And a rarity scale, if you want it for your own wording:
| Token | |
|---|---|
<common> <uncommon> <rare> <epic> <legendary> <mythic> | Fixed six-tier scale, deliberately reusing the semantic colours where they line up. |
Plus one that is not a colour:
| Token | |
|---|---|
<prefix> | Expands to the zyauctions.prefix key in the reader's language. Chat lines only. |
Accessibility
Roughly one player in twelve has some form of colour-vision deficiency, so nothing in this plugin uses colour as its only signal:
- Messages carry a marker as well as a colour:
✔success,❌error,⚠warning,ℹinfo. - The active category and sort order in the menus are marked with an enchantment glint, not just a different colour.
- Listings you cannot afford say so in words as well as greying out.
If you rewrite the language file, please keep the markers. If you change primary, pick
something with reasonable contrast against both dark and light chat backgrounds — deep
navy and pale yellow both fail one of them.
Sounds
Not colour, but the same idea: one small deliberate set rather than per-feature choices.
Turn them down or off in config.yml:
sounds:
enabled: true
volume: 1.0Every cue is played to one player only — nobody standing nearby hears somebody else's menu
— and all of them obey the Master volume slider. volume: 0.4 keeps the feedback without
the presence.