Skip to content

Mentions and messages

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"
  • format is how a mention looks. <name> is the player’s name as they spell it.
  • sound is 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.
  • @everyone pings everyone who can see the message, for players with everyone-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.

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.

/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.