Text Syntax

Configuration syntax in Citizens is simple. Nodes within arrow brackets -- <> -- will be parsed and replaced if possible. Below are the available nodes that you can use.

Chat Colors

Use the Chat Color characters the same as any other plugin. For example, &a would give you green.

Color Reference
0 -- BLACK
1 -- DARK BLUE
2 -- DARK GREEN
3 -- CYAN
4 -- DARK RED
5 -- PURPLE
6 -- GOLD
7 -- LIGHT GRAY
8 -- GRAY
9 -- BLUE
a -- GREEN
b -- AQUA
c -- ROSE RED
d -- LIGHT PURPLE
e -- YELLOW
f -- WHITE

Format Reference
k -- Obfuscated
l -- Bold
m -- Strikethrough
n -- Underline
o -- Italic
r -- Reset

Alternate color/format reference page

You can also use hexadecimal colors in Minecraft 1.16+, using Spigot's syntax - &x&f&f&0&0&e&e or Essentials' syntax - &#ff00ee (both examples produce the same pink/magenta color).

Other

There are also other nodes that you can use in configuration files. Some of these do not apply to certain configuration settings, so use with care. More will be added in the future as the need arises.

NPC Nodes

<npc> -- NPC's name
<id> -- NPC's ID
<owner> -- NPC's owner

Player Nodes

<player> -- Player's name
<world> -- Player's world
<nearest_player> -- Name of the player closest to the NPC

Extra Nodes

<random_player> -- Random online player name
<random_npc> -- Random NPC name
<random_npc_id> -- Random NPC ID

External Placeholders

If you have PlaceholderAPI installed on your server, you can use any PAPI Placeholders the same as you would use them elsewhere.