summaryrefslogtreecommitdiff
path: root/website/src/docs/features/direct-message.md
blob: f3d39e45345785240f0d0539d160e8d168478501 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
---
layout: doc
---

# Direct Message

Send and receive private 1-on-1 messages between players.

## Basic Usage

### Sending a Message

```
/tell <player> <message>
```

Aliases: `/t`, `/msg`, `/m`, `/w`, `/whisper`

Sends a direct message to the specified player. Clicking on a received message will auto-fill the reply command to the sender.

### Quick Reply

```
/reply <message>
```

Alias: `/r`

Replies to the last player who sent you a message. If there is no such player, the message is sent to the last player you messaged.

To use quick reply, `features.quickReplies.enabled` must be `true` (default) in `config.yml`.

## Cross-Server Direct Messages <Badge type="tip" text="v1.3.0~" />

> [!NOTE]
>
> To use this feature, set `features.velocityIntegration.crossServerDirectMessage` to `true` in `config.yml`.

To message a player on another server, specify the player argument as `playerName@serverName`.

```
/tell <player>@<server> <message>
```

`serverName` is the `features.velocityIntegration.serverName` configured on the **destination** server, not the name Velocity uses internally. A server left at the default `"Unknown"` cannot be addressed meaningfully, so give every server a name before enabling this.

Delivery can fail in two ways, and the sender is told which:

| Reason | Meaning |
|--------|---------|
| `SERVER_NOT_FOUND` | No server behind the proxy reports that `serverName` |
| `TARGET_OFFLINE` | The server was found, but that player is not online on it |

## Notification Settings

Players can individually control the sound notification when receiving direct messages.

```
/lc settings notice on     # Enable notifications
/lc settings notice off    # Disable notifications
```

## Integration with Japanese Conversion

When [Japanese Conversion](/docs/features/japanese-conversion) is enabled, direct message content is also automatically converted to Japanese. Conversion follows each player's `japanese` setting.

## Spy Feature

Players with the `lunaticchat.spy` permission (default: op) can view all direct messages on the server. Spy players see the original message before conversion.

## Message Format

The display format for direct messages can be customized via `messageFormat.directMessageFormat` in `config.yml`. See [Message Format](/docs/reference/message-format) for details.