AT-PinataParty

Colors and formatting

Every way to color text in AT-PinataParty, from plain codes to gradients, rainbows and the named palette.

Every piece of text the plugin shows goes through the same color engine. That means anything on this page works in your language file, in hologram lines, in the piñata's name, and in broadcast prefixes.

Each color format written out on the left with the coloured result it produces on the right

Quick reference

FormatExampleWhat you get
Legacy codes&aGreen &lBoldThe classic Minecraft codes
Hex&#FF8800OrangeOne exact color
Hex, tag form#{FF8800}OrangeThe same, when a bare # is awkward
Hex, solid tag<SOLID:FF8800>OrangeThe same again
Hex, angle form<#FF8800>OrangeThe same again, for configs copied from elsewhere
Gradient<gradient:#FF0000:#0000FF>fade</gradient>A smooth fade between two colors
Gradient, second style<GRADIENT:FF0000>fade</GRADIENT:0000FF>Same result, colors split across both tags
Rainbow<RAINBOW>party time</RAINBOW>Every color of the spectrum across the text
Named palette&t7CoralOne of 125 named colors

Tags are not case sensitive, and the # in front of a hex value is optional everywhere. <gradient:#aaaaaa:#bbbbbb> and <GRADIENT:aaaaaa> are both fine.

Legacy codes

The codes you already know. An & followed by one character.

CodeColorCodeColor
&0Black&8Dark Gray
&1Dark Blue&9Blue
&2Dark Green&aGreen
&3Dark Aqua&bAqua
&4Dark Red&cRed
&5Dark Purple&dLight Purple
&6Gold&eYellow
&7Gray&fWhite

And the format codes:

CodeEffect
&lBold
&oItalic
&nUnderline
&mStrikethrough
&kObfuscated, the scrambling one
&rReset everything back to normal

Hex colors

Any color you like, written as six hex digits. Five spellings, all the same result:

pinata-hit: "&#FF8800You hit the Pinata!"
pinata-hit: "#FF8800You hit the Pinata!"
pinata-hit: "#{FF8800}You hit the Pinata!"
pinata-hit: "<SOLID:FF8800>You hit the Pinata!"
pinata-hit: "<#FF8800>You hit the Pinata!"

Pick whichever reads best to you. &#FF8800 and the bare #FF8800 are the oldest forms and still work everywhere they used to.

Gradients

A gradient fades between two colors across the text. There are two ways to write one, and they do the same thing.

Both colors live in the opening tag. This is the style used in the shipped files.

prefix: "<gradient:#005bff:#00fbff>&lPinata</gradient> &7»"

Format codes inside a gradient carry through, so &l keeps the whole thing bold. A plain color code inside a gradient is ignored, because the gradient is deciding the color. &r clears the formatting from that point on.

Rainbow

pinata-death:
  title: "<RAINBOW>Pinata Party Over!</RAINBOW>"

The color walks the whole spectrum across the visible characters. Format codes behave the same as in a gradient.

Two rainbows on one line already work, and each one starts its spectrum over:

chat: "<RAINBOW>Winner</RAINBOW> &7- <RAINBOW>congratulations</RAINBOW>"

A number on the opening tag, like <RAINBOW1>, is accepted and ignored. It exists so configs written for other plugins still render. You do not need it.

The named palette

125 colors with short codes, for when you want something specific without looking up a hex value.

summon-success: "%prefix% &t7A Pinata has been summoned at &u0%location%&t7."

These use the same & prefix as legacy codes but are always a letter followed by a digit, like &t7. A code that is not in the list below is left alone, so &a1 still renders as green followed by the character 1.

Where you can use all this

Tips

  • Test a line in game before committing to it. /pp reload picks up language changes without a restart.
  • Gradients look best on short text. Across a long sentence the two ends are so close together that the fade is hard to see.
  • Rainbow on a whole chat line is a lot. It works well on a title or a single word.
  • If a color is not showing, check you used & and not §, and that the value is wrapped in quotes in the YAML file.

On this page