# Private Messages

Player-to-player messages with automatic reply tracking, plus a broadcast command for server-wide announcements. For public chat see [Chat Format](chat.html).

## Commands

| Command | Syntax | Permission | Default | Description |
|---|---|---|---|---|
| `/msg` (alias `/tell`, `/whisper`, `/w`, `/pm`, `/dm`, `/message`) | `/msg <player> <message>` | `msg.send` | `true` | Sends a private message |
| `/reply` (alias `/r`) | `/reply <message>` | `msg.reply` | `true` | Replies to the last sender |
| `/broadcast` (alias `/bc`) | `/broadcast <message>` | `msg.broadcast` | `false` | Server-wide announcement to all players and the console |

## Additional permissions

| Permission | Default | Description |
|---|---|---|
| `msg.bypass.mute` | `false` | Private messages despite a mute (also needs `mod.bypass.mute`, see [Moderation](moderation.html#mutes)) |

> **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. Admins with `/socialspy` can read private messages (see [Moderation](moderation.html#socialspy)).

> **Tip:** A small `/msg` cooldown (2 to 3 seconds) curbs spam without disturbing conversations. `/reply` is not affected.

## Configuration (modules/messaging.yml)

```yaml
# 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: 0
```

The broadcast uses the `messaging.broadcast-format` from `messages.yml` and parses MiniMessage fully (only admins may use it).

## Complete example config

```yaml
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
```