# Link your players to Discord

Players link their Steam and Discord accounts with a code. Staff look links up with /link search.

## Set it up once

The bot posts the instructions in the link channel and keeps it tidy.

1. Open **Integrations**, then **Discord**, and choose **Add the bot to Discord** in the title bar. **Home** has the same button until the bot is added. Pick your Discord server on Discord's page and allow the bot. You need Manage Server there.
2. Back on the **Discord** page, under **Player linking** and **Link channel**, choose **Create a link channel for me**, or pick a channel and choose **Use this channel**.
3. On each server, open **Software** and install the **RustSC plugin**. It needs Oxide or Carbon.
4. Optional: paste your Discord invite link and choose **Save invite link**. Players see it in the game next to their code.

- [Connect Discord chat and roles](https://rustsc.com/support/guides/discord-chat-roles/index.html.md)

## What players do

A player presses **Unlink** in the panel or on **Link Status** to end the link. Leaving your Discord server also ends it. If another plugin already uses /link, choose another name under **Command players type** on the Discord page.

1. In the game chat, type /link. A small panel shows a code.
2. In Discord, open the link channel and press **Link my account**.
3. Enter the code. The panel in the game then says who they are linked to.

## Find a link with /link search

In Discord, type /link search. Search by Steam ID, Steam name or Discord name, or pick a member. The answer is private to you and has an **Unlink** button.

People with Manage Server can always use it. To let other people, choose roles under **Who can search links in Discord**.

You can also search and unlink under **Linked players**, inside **Player linking** on the Discord page. **Sync now** there checks every link against Discord again.

**Disconnect Discord** in the title bar stops the bot answering in the link channel. Players stay linked.

## Tell players when their upkeep runs low

A player stops the alerts for themselves in the game with /upkeep off.

1. On the **Discord** page, find the **Upkeep alerts** card.
2. If you have more than one server, choose the **Server**.
3. Turn on **Track upkeep**. Leave **Tell players** on to let linked players know before their upkeep runs out, then choose **Save**.

## If something goes wrong

- The page says the /link command could not be added: choose **Add the bot to Discord again** in the title bar of the Discord page.
- Your players linked with another service before: use **Bring your old links** under **Player linking**.
- The page says the link channel is gone: choose another channel.
- /link does nothing in the game: check that the RustSC plugin is installed on that server and that **Let players link in the game** is on.
- A player types a wrong code too often: they must wait a moment. Other players are not affected.

- [Install or update the RustSC plugin](https://rustsc.com/support/guides/rustsc-plugin/index.html.md)

- [Move existing Discord links](https://rustsc.com/support/guides/move-discord-links/index.html.md)

HTML version: https://rustsc.com/support/guides/discord-link/
