06. Chat System

Chat formatting, private messaging, and join/leave messages.

Config file: rpessentials-chat.toml.

Chat formatting

Option	Default	Description
`enableChatFormat`	`true`	Master switch. If disabled, vanilla chat will be used.
`playerNameFormat`	`$prefix $name $suffix`	Name format, supports `$name`, `$nick`, `$real`, `$nick_real`, `$prefix`, `$suffix`.
`chatMessageFormat`	`[$time] $name: $msg`	Full message template.
`chatMessageColor`	`WHITE`	Global message color, one of the 16 Minecraft colors.
`enableTimestamp`	`true`	Prefix messages with a timestamp.
`timestampFormat`	`HH:mm`	Java `SimpleDateFormat` pattern.
`markdownEnabled`	`true`	Enables `bold`, `italic`, `__underline__`, `~~strikethrough~~`.
`enableColorsCommand`	`true`	Enables `/colors`.
`showRealNameInChat`	`false`	Auto appends `(RealName)` after a nickname everywhere, see Identity System.

Option	Default	Description
`enableProximityChat`	`false`	Chat only reaches players within range.
`proximityChatDistance`	`32`	Radius in blocks.
`proximityChatBypassPrefix`	`!`	Prefix that forces a global message.
`enableProximitySpy`	`true`	Staff outside range see a spy log of messages.
`proximityChatFormat` / `globalChatFormat`	see config	Separate formats for local and global messages.

Staff can toggle their own proximity spy log with /rpessentials staff proximityspy true|false.

Fully custom /msg system, replacing vanilla messaging.

/msg <player> <message>, aliases /tell, /w, /whisper.
/r <message> replies to the last person who messaged you.
Messages use nicknames, LuckPerms prefix/suffix and color codes.
A clickable "Click to reply" component is included in received messages.
Console can message a player, and receives a confirmation echo. (Player can't message console)
Set logPrivateMessages = true to log private messages to console. Even if this option can be enabled, I recommend to let it disabled for the privacy of your players, and if you still want to enable it, please inform your players about that.

Option	Default	Description
`enableCustomJoinLeave`	`true`	Master switch.
`joinMessage`	`§e{player} §7woke up`	Supports `{player}`, `{nickname}`, `{nick}`, `{real}`, `{nick_real}`. Set to `none` to disable.
`leaveMessage`	`§e{player} §7went to sleep`	Same placeholders.

/colors shows every available color code and formatting code with a live preview, plus the list of chat variables.

See Identity System for the full placeholder reference shared across chat, private messages and RP commands.