> For the complete documentation index, see [llms.txt](https://docs.ragnasync.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ragnasync.com/getting-started/channel-messages.md).

# Message Sync

Bridges in-game chat channels to Discord channels

Bridges in-game chat channels to Discord - players can chat across both platforms seamlessly.

## What It Does

* In-game messages appear in Discord with character name and avatar
* Discord messages appear in-game (bi-directional)
* Works with any channel: #main, #trade, #support, etc.

## Configuration

Add `discord_channel_id` to any channel in `channels.conf`:

```
{
    name: "#main"
    alias: "[Main]"
    color: "Green"
    discord_channel_id: "1234567890123456789"
}
```

For full configuration options, see [Channels Config](/getting-started/channels-conf.md).

## Message Format

Messages appear in Discord with:

* Character name as the webhook username
* Character head sprite as the avatar
* Message content as sent in-game

## Bi-Directional Chat

RagnaSync also supports Discord-to-game messaging. Discord users can send messages that appear in the corresponding in-game channel.

### Message Prefix

When a Discord message appears in-game, the sender's name is shown with a prefix so players know it came from Discord. The default is `@`:

```
@DiscordUser: Hey everyone!
```

You can change this prefix — up to 10 characters, or remove it entirely — on the **Configure** page in your dashboard, under the **Ragnarok** section. A live preview shows exactly how it'll look in-game as you type.

| Prefix        | In-Game Result                   |
| ------------- | -------------------------------- |
| `@` (default) | `@PlayerName: Hello everyone!`   |
| `[D]`         | `[D]PlayerName: Hello everyone!` |
| `~`           | `~PlayerName: Hello everyone!`   |
| *(empty)*     | `PlayerName: Hello everyone!`    |