Color Permissions
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>
- Editing a sign with
/editsign
:essentials.editsign.<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 |
rgb | &#RRGGBB | 2.18.0+ |
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.
Nicknames
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.