Discord Integration

01What it does

Some Surge features run through your Discord. Raid Alarm is the big one, because that's where alarms get posted. This page shows you at a glance whether your Discord is hooked up properly, and lets you save an invite link so players who aren't in your Discord yet can join in one click.

It's also where you run your Discord server itself. Instead of adding five different bots for welcomes, tickets, giveaways and moderation, the Surge bot does all of it, and you set it all up from here.

Once this Discord is connected to a server, Surge creates a green role called Surge Linked. Discords that were already connected get the role too, the next time the bot starts, and the check repeats every few minutes. Anyone who has linked an in-game name on Surge, and who is in that Discord, gets the role. Linking is the same on every server, so they do not link again for each one. If their name is unlinked, the role comes off.

02The tabs

Across the top of the panel you'll find these tabs:

• Overview: the status card and your invite link. Both are explained further down this page.
• Embeds: design good looking embed messages and post them in any channel. Save the ones you use a lot as templates.
• Ticket System: a private support channel for each member who needs help. See the Ticket System page.
• Giveaways: run giveaways where the bot picks the winners at random. See the Giveaways page.
• Greeting Messages: welcome people when they join and say goodbye when they leave. See the Greeting Messages page.
• Auto Respond: the bot answers when someone types one of your trigger words, in the channels you pick. See the Auto Respond page.
• Moderation: look someone up by name and time them out, warn, kick or ban them. See the Moderation page.
• Server to Discord: post the killfeed, player count, heatmap, Top Currencies and Kit Claims. See the Server to Discord page.
• Server Wipe: announce wipe locks and server wipes in a channel, with messages you design yourself. See the Server Wipe Announcements page.

03What the bot needs

The bot can only do what Discord lets it do. If something is missing, the tab that needs it shows a yellow banner telling you exactly what to fix, so you don't have to guess.

Permissions. Give the bot's role these permissions in your Discord server settings, or press Update Bot on the banner to invite it again with the right ones:

• Manage Channels for ticket channels.
• View Channel and Manage Channels on the population channel, so Server Population can rename it. Voice channels also need Connect.
• Manage Roles for auto roles and giving or taking roles.
• Kick Members, Ban Members and Timeout Members for moderation.
• Manage Messages for clearing messages.
• Manage Nicknames for changing nicknames.

Role order. Discord only lets a bot manage people and roles that sit below its own role. Drag the Surge role near the top of your role list, otherwise it can't give out a role or time out someone who ranks higher than it.

04The status card

The card at the top tells you where you stand:

• Not linked yet: this Rust server has no Discord. Use Get install code on this same Overview card.
• Linked to (your Discord name) and The bot is in your Discord: you're all set for this server.
• The bot is not in this Discord: this server is linked, but the bot was removed or never added. Click Add bot to invite it, otherwise it can't post or check who's a member.
• The bot is offline right now: Surge couldn't check. Usually temporary.

05Linking your Discord

The server owner or an admin on that server does this on Discord Integration → Overview. You can reuse the same Discord on every server, or pick a different one. New servers start unlinked.

1. 1Click Add bot and invite Surge to the Discord you want for this server.
2. 2Click Get install code. You get a 10-digit code that lasts 30 minutes.
3. 3In that Discord, run /install and paste the code. You need Manage Server or Administrator in that Discord to do this.
4. 4Run /admin-role and pick the role that's allowed to open the Surge admin dashboard for Rust servers linked to that Discord.
5. 5Use Unlink Discord if this server should stop using that Discord. Other servers that use it stay linked.

06Your Discord invite link

This is the link players are shown when they aren't in your Discord yet, for example when they try to get a Raid Alarm code. Without it, they're just told to contact an admin.

1. 1Paste your invite link into the box (for example https://discord.gg/yourserver).
2. 2Click Save. Underneath you'll see exactly what players get, with Copy and Remove buttons.

• It accepts discord.gg, discord.com/invite and discordapp.com/invite links. Anything else is rejected.
• However you paste it, Surge saves it in the short https://discord.gg/ form.
• Click Remove to clear it.