Private Messages
Player-to-player messages with automatic reply tracking, plus a broadcast command for server-wide announcements. For public chat see Chat Format.
Commands #
| Command | Syntax | Permission | Default | Description |
|---|---|---|---|---|
/msg (alias /tell, /whisper, /w, /pm, /dm, /message) | /msg <player> <message> | msg. | true | Sends a private message |
/reply (alias /r) | /reply <message> | msg. | true | Replies to the last sender |
/broadcast (alias /bc) | /broadcast <message> | msg. | op | Server-wide announcement to all players and the console |
Additional permissions #
| Permission | Default | Description |
|---|---|---|
msg. | false | Private messages despite a mute (also needs mod., see Moderation) |
Note: Messages to yourself, to offline players and to vanished players (without the see permission) are blocked. Click and hover effects are stripped from every message, the rest of the text arrives exactly as typed (< and \ included). The claim module's ignore list and soft mute apply to /msg and /r as well: someone ignoring you gets no message (you are told); a soft-muted player sees their own line, the recipient nothing. The moderation module's word filter applies here too. Admins with /socialspy can read private messages (see Moderation).
Tip: A small /msg cooldown (2 to 3 seconds) curbs spam without disturbing conversations. /reply is not affected.
Configuration (modules/messaging.yml) #
# Enables or disables private messages and broadcast.
enabled: true
messaging:
# Display for the sender. Placeholders: <target>, <message>
sender-format: "<gray>[<green>You <gray>-> <green><target><gray>] <white><message>"
# Display for the receiver. Placeholders: <sender>, <message>
receiver-format: "<gray>[<green><sender> <gray>-> <green>You<gray>] <white><message>"
# Maximum message length for /msg and /reply.
max-length: 256
cooldown:
commands:
# Seconds between two /msg of the same player. 0 = no cooldown.
# Applies to /msg only, not /reply.
msg: 0The broadcast uses the messaging. from messages. and parses MiniMessage fully (only admins may use it).
Complete example config #
enabled: true
messaging:
sender-format: "<dark_gray>[<aqua>You <dark_gray>-> <aqua><target><dark_gray>] <white><message>"
receiver-format: "<dark_gray>[<aqua><sender> <dark_gray>-> <aqua>You<dark_gray>] <white><message>"
max-length: 200
cooldown:
commands:
msg: 3