Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Chat format · Tags · Chat and name colors · Private messages · TPA · Chat games · Discord bridge · AutoMod
Sentials is a chat plugin for Paper. It handles your chat format, tags, chat and name colors, private messages, TPA, chat games and a Discord bridge. Since 2.1 it can also moderate chat by itself.
It's one jar and doesn't need any other plugin. If PlaceholderAPI, Vault or LuckPerms are installed, it uses them.

|
Each line shows the name, the tag (if the player has one) and the message. Names can be one color, a hex color or a gradient, like Alice's red-to-blue one.
|

|
New in 2.1. AutoMod blocks a message before anyone else sees it.
Strikes: the player gets a warning and a strike. After 3 strikes they're muted for 10 minutes, and strikes wear off after 30 minutes. YouTube links are allowed by default, and you can add more domains. Staff alerts: staff get one line per blocked message. Hover it to see what was actually typed. In the screenshot, that's Bob trying to post an IP. The same alert can go to a Discord log channel. AutoMod checks |

|
Type a color after the command:
The name color also shows in the tab list, as you can see at the top of the screenshot. |
|
Without a color, Colors you don't have permission for show as locked. You'll also find the name color in |

|
Players can make their own tag with With
|

|
Almost everything can be changed from this menu, so you rarely need to open the config.
The menus can't be robbed with shift-click, number keys or dragging. |

Which file
Download the file that matches your server and use only one.
| Server version | Java needed |
|---|---|
| Paper 1.21.11 | Java 21 or newer |
| Paper 26.1, 26.2 or 26.3 | Java 25 |
Updating from GyxerChat
- Stop the server.
- Delete the old
GyxerChatjar. - Put the Sentials jar in
plugins/. - Start the server again.
Sentials copies plugins/GyxerChat to plugins/Sentials, including your config, mutes, ignores, tags, nicknames and colors. The old folder stays where it is so you can check everything before you delete it. Old gyxerchat.* permissions keep working.

Sentials is one jar and does not need any other plugin. The three plugins below are optional. If they are on your server, Sentials uses them.

How to set up an optional plugin
- Download the plugin's
.jarfrom its official page (links below). - Put the jar in your server's
plugins/folder. - Restart the server. A plugin loaded with
/reloadcan cause problems, so restart instead. - Run
/pluginsand check that the plugin is green.
| Plugin | What Sentials uses it for | Notes |
|---|---|---|
| Vault | Money rewards from chat games | Vault only connects plugins. To pay money you also need an economy plugin that supports Vault, such as EssentialsX. Without Vault, set a reward command instead. |
| PlaceholderAPI | Placeholder support when installed | No Sentials setup is needed. Install it and restart. |
| LuckPerms | Managing the Sentials permissions | See the LuckPerms commands in the Permissions section for giving everyone custom colors and tags. |
Download links are the official pages at the time of writing.

| Permission | Default | What it does |
|---|---|---|
sentials.nick |
op | /nick |
sentials.nick.colors |
op | colors in /nick |
sentials.chat.colors |
everyone | & color codes in chat |
sentials.chatcolor.<color> |
op | one menu color |
sentials.chatcolor.custom |
op | any hex color and any gradient |
sentials.namecolor.<color> |
op | one name color |
sentials.namecolor.custom |
op | any name color and any gradient |
sentials.tags.custom |
op | /tags create |
sentials.tags.custom.colors |
op | colors in your own tag |
sentials.automod.bypass |
nobody | AutoMod skips you |
everlynx.chat.admin |
op | admin commands and /chatadmin |
everlynx.chat.staff |
op | staff chat and AutoMod alerts |
everlynx.spy |
op | /socialspy |
To give everyone custom colors and tags with LuckPerms:
/lp group default permission set sentials.chatcolor.custom true
/lp group default permission set sentials.namecolor.custom true
/lp group default permission set sentials.tags.custom true

- Make a bot in the Discord Developer Portal and turn on Message Content Intent.
- In
config.yml, setdiscord.enabled: true, paste thebot-tokenand fill in the channel IDs. - Run
/chatreload.
Console commands from Discord are off by default. When you turn them on, only the user IDs you list can run them.



