EssentialsX includes permissions that let you control the individual formatting codes players can use in some commands.
This works for the following:
- Sending a PM with
/msg:essentials.msg.<suffix> - Sending mails with
/mail:essentials.mail.<suffix> - Setting your own nickname with
/nick:essentials.nick.<suffix> - Sending chat messages (requires EssentialsX Chat):
essentials.chat.<suffix> - Colors on signs (requires color signs to be enabled):
essentials.signs.<suffix>
Below is a list of valid permissions suffixes. Note that some codes are only available on EssentialsX 2.16.1.169 and above:
| Suffix | Color codes | EssentialsX version |
|---|---|---|
color (group) |
&0 &1 &2 &3 &4 &5 &6 &7 &8 &9 &a &b &c &d &e &f |
All versions |
format (group) |
&l &m &n &o &r |
All versions |
magic (group) |
&k |
All versions |
black |
&0 |
2.16.1.169+ |
dark_blue |
&1 |
2.16.1.169+ |
dark_green |
&2 |
2.16.1.169+ |
dark_aqua |
&3 |
2.16.1.169+ |
dark_red |
&4 |
2.16.1.169+ |
dark_purple |
&5 |
2.16.1.169+ |
gold |
&6 |
2.16.1.169+ |
gray |
&7 |
2.16.1.169+ |
dark_gray |
&8 |
2.16.1.169+ |
blue |
&9 |
2.16.1.169+ |
green |
&a |
2.16.1.169+ |
aqua |
&b |
2.16.1.169+ |
red |
&c |
2.16.1.169+ |
light_purple |
&d |
2.16.1.169+ |
yellow |
&e |
2.16.1.169+ |
white |
&f |
2.16.1.169+ |
bold |
&l |
2.16.1.169+ |
strikethrough |
&m |
2.16.1.169+ |
underline |
&n |
2.16.1.169+ |
italic |
&o |
2.16.1.169+ |
reset |
&r |
2.16.1.169+ |
The individual permissions take priority over the "group" permissions. For example, if you set essentials.nick.color
to true then set essentials.nick.black to false, players will be able to set their nicknames to any color
except black.
If you want players to be able to change the color of their nickname but not the text itself, set the permission
essentials.nick.changecolors to true. This will let them use color codes in their nickname, but the text will still
have to match their own username.