Mentions and messages
Mentions
Section titled “Mentions”Writing a player’s name in chat, with or without @, highlights it for everyone and plays a ping to that player.
mentions: enabled: true format: "<highlight>@<name></highlight>" sound: "entity.experience_orb.pickup 0.5 1.2" everyone-permission: "zchat.mention.everyone"formatis how a mention looks.<name>is the player’s name as they spell it.soundis a Minecraft sound name, then optionally a volume (0 to 10) and pitch (0.5 to 2). It plays in the player’s Players volume, so they can turn it down. Blank for none.@everyonepings everyone who can see the message, for players witheveryone-permission(operators by default).
Players aren’t pinged by their own name, by someone who can’t see them (so vanished staff stay hidden), or while they’ve hidden chat.
Private messages
Section titled “Private messages”| Command | Aliases | Permission |
|---|---|---|
/msg <player> <message> |
tell, w, whisper, m, pm |
zchat.command.msg (everyone) |
/reply <message> |
r |
zchat.command.reply (everyone) |
/socialspy |
spy |
zchat.command.socialspy |
/msg replaces Minecraft’s /msg, /tell and /w, and gives them back if you turn it off. Like Minecraft’s, it takes selectors such as @p or @a[distance=..10] from anyone with Minecraft’s minecraft.command.selector permission (operators, the console and command blocks by default), on Paper; Folia can’t safely look across regions for them. For everyone else, @a is just a name, so a player can’t message the whole server at once. /reply answers whoever you last messaged, or who last messaged you, the console included. Command blocks can send private messages but can’t be replied to.
private-messages: msg: format-sent: "<highlight>You → <player></highlight><gray>:</gray> <white><message>" format-received: "<highlight><player> → You</highlight><gray>:</gray> <white><message>" sound: "entity.experience_orb.pickup 0.5 1.2"<player> is the other player and <message> what was said. sound plays to whoever receives a message.
The filter applies to private messages. The chat mute, cooldown and anti-repeat don’t, and players who’ve hidden chat still get them. Players with the colour permission can use colours in them, as in chat. Players you can’t see, such as vanished staff, count as offline.
Social spy
Section titled “Social spy”/socialspy shows a player every private message between other players:
socialspy: remember: true log-to-console: true format: "<dark_gray>[Spy]</dark_gray> <gray><sender> → <receiver>: <message>"With remember: true, it stays on when they rejoin, as long as they still have the permission. With log-to-console: true, every private message is also written to the console log, for moderation.