Chat & Messaging
Private messaging, ignore, broadcast, chat formatting, and Discord integration.
Overview
EssentialsC manages player chat with support for private messaging, an ignore system, server broadcasting, and advanced chat formatting via LuckPerms. The chat system supports MiniMessage formatting, legacy color codes, slow mode, caps filtering, link whitelisting, and player mentions.
Private Messaging
| Command | Description |
|---|---|
/msg <player> <message> |
Send a private message to a player. |
/reply <message> |
Reply to the last player who messaged you. |
/socialspy [player] |
Toggle social spy to read private messages of other players (admin). |
Private messages support hover and click events. The message format is configurable, and social spy lets admins monitor all private conversations without the participants knowing.
Ignore
| Command | Description |
|---|---|
/ignore [player] |
Toggle ignoring a player. Blocks their private messages and chat mentions. |
Ignored players are stored persistently. Players on your ignore list cannot send you private messages. The ignore list applies across sessions.
Broadcast
| Command | Description |
|---|---|
/broadcast <message> |
Broadcast a message to all players, or to a specific world with --world=<name>. |
/discord |
Show the Discord invite link to the player. |
Broadcast messages use a configurable prefix from config.yml and support MiniMessage formatting. The /discord command simply sends a configurable URL to the player.
Chat Formatting
EssentialsC formats public chat messages based on the player's LuckPerms group. The format is configured per-group in config.yml under chat.formats.
chat: formats: default: "<gray>[<white>%luckperms_prefix%<gray>]<white> %player_name%<gray>:<white> %message%" admin: "<red>[<gold>%luckperms_prefix%<red>]<gold> %player_name%<gray>:<white> %message%" vip: "<gradient:#55FF55:#00AA00>[%luckperms_prefix%] %player_name%<gray>:<white> %message%"
Chat Features
| Feature | Description |
|---|---|
| Slow Mode | Configurable delay between chat messages. Players with bypass permission are exempt. |
| Caps Filter | Block or warn messages that exceed a configurable caps threshold (e.g. 75% uppercase). |
| Link Filtering | Block all links except those on a configurable whitelist. Includes a bypass permission. |
| Player Mentions | Typing @playername highlights the mention for the targeted player with sound and visual effects. |
Configuration
Chat settings live under the chat section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
chat.slow-mode |
Seconds | 0 |
Delay required between chat messages. 0 disables slow mode. |
chat.caps-lock-threshold |
Double | 0.75 |
Fraction of uppercase letters allowed before filtering. 0 disables. |
chat.link-whitelist |
List | [wiki.godlycow.org] |
Domains allowed in chat messages. |
chat.mention.enabled |
Boolean | true |
Enable @playername mentions. |
chat.mention.sound |
String | block.note_block.pling |
Sound played to the mentioned player. |
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.msg |
Send private messages. | Everyone |
essentialsc.reply |
Reply to private messages. | Everyone |
essentialsc.ignore |
Ignore other players. | Everyone |
essentialsc.broadcast |
Broadcast messages to all players. | Operators |
essentialsc.discord |
Use /discord. | Everyone |
essentialsc.socialspy |
Read other players' private messages. | Operators |
essentialsc.chat.slowmode.bypass |
Bypass slow-mode delays. | Operators |
essentialsc.chat.links.bypass |
Post links without restriction. | Operators |
essentialsc.chat.caps.bypass |
Bypass the caps filter. | Operators |