Skip to main content

Discord bot

The GSA Discord bot adds features like !kickme commands for players and game server management tools for the Admin team. Chat with in-game players directly from Discord, manage your servers, and more.

Go to Discord bot settings >

Bot commandsโ€‹

To use the bot, Discord users must first connect their Discord account to GSA so the bot can recognize them.

Discord bot - bot commands

User commandsโ€‹

CommandInfoRole
!helpReturns all available commands.*
!serversProvides a list of available game server for the communityPlayer
!voteProvides a list of available voting site URLs.Player
!claimClaim reward after player casted votes.Player
!kickmeKicks player from the game server they are on.Player

Group commandsโ€‹

Group commands are only available in Discord servers linked via a Community website.

CommandInfo
!motd [message]Sets the Message of the Day for your group.

Admin commandsโ€‹

Admin commands follow Admin Team permissions. Commands that control game servers only work on DediConnect-enabled servers.

CommandInfo

!start [server ID or 'all']

Starts the specified game server(s).

!stop [server ID or 'all'] [countdown: now,5,15,30 or 60]

Stops the specified server(s) with an optional countdown.

!restart [server ID or 'all'] [countdown: now,5,15,30 or 60]

Restarts the specified server(s) with an optional countdown.

!update [server ID or 'all'] [countdown: now,5,15,30 or 60]

Updates the specified server(s) with an optional countdown.

!cancel [server ID or 'all']

Cancels scheduled stop, restart, or update actions for the specified server(s).

!snapshot [server ID or 'all'] [snapshot name]

Creates a backup snapshot for the specified server(s).

Featuresโ€‹

Channel update delay

New Discord channels may take a few minutes to appear in dropdown lists.

Discord + Cluster chatโ€‹

Chat directly with in-game players from Discord. Supported in all games that support Cluster chat.

Discord bot - Cluster chat + Discord

Go to the Discord page and assign a channel to the Discord + Cluster chat setting.

info

It may take a few minutes for chat to activate after saving your channel. Please be patient.

Discord bot - Enable Cluster chat + Discord

Player join / leaveโ€‹

Get real-time join/leave notifications in Discord when players enter or exit a game server.

Discord bot - Player join / leave

Set up the Player join & leave channel on the Discord page.

Discord bot - Player join / leave

Game server status cardโ€‹

Display a real-time server status card that updates on events like restarts or updates.

Discord bot - Game server status card

Assign a channel for the Game server status card on the Discord page.

Discord bot - Player join / leave

Game server status logโ€‹

Track detailed server events such as startup, shutdown, or mod updates in Discord.

Discord bot - Game server status log

Assign a channel for the Game server status log on the Discord page.

Discord bot - Player join / leave

Group logs to Discordโ€‹

Allow players to view group logs in a private Discord server to stay informed about in-game activity even when offline.

How-toโ€‹

Invite bot to your Discordโ€‹

To get started, you need to connect the bot to your Discord server.

1. Connect Discordโ€‹

Go to the Discord page and click Connect your Discord.

Discord bot - Connect discord 1

2. Select Discord serverโ€‹

Choose the Discord server where the bot should be installed and click Continue.

Discord bot - Connect discord 2

3. Confirm permissionsโ€‹

Keep all requested permissions enabled, the bot needs them to function properly. Click Authorize.

Discord bot - Connect discord 3

4. Done!โ€‹

Discord bot - Connect discord 4

Connect Discord for playersโ€‹

Learn how players can connect their Discord account with GSA.

Type !help in a community Discord channel to get your personal connect link.

Discord bot - Connect player 1

2. Authorize Discordโ€‹

Click Authorize to link your Discord ID and username.

Discord bot - Connect player 2

3. Success!โ€‹

After connecting, it may take a few minutes before the bot recognizes you.

Discord bot - Connect player 3

Setup group logs for communitiesโ€‹

Group logs allow your community to receive in-game activity logs on a private Discord server.

1. Log in on Community websiteโ€‹

Group logs must be enabled by a group admin on the Community site.

Discord bot - Group log setup 1

Go to Group settings.

Discord bot - Group log setup 2

2. Connect group Discordโ€‹

On the settings page, click Connect Discord to invite the bot to your group's private server.

Discord bot - Group log setup 3

Select the server where you want group logs to be posted.

Discord bot - Group log setup 4

Keep all listed permissions enabled, then click Authorize.

Discord bot - Group log setup 5

3. Select Discord channelโ€‹

Choose the channel where group logs should be posted.

Discord bot - Group log setup 6

4. Done!โ€‹

Group logs will now automatically appear in the selected Discord channel. It may take up to 10 minutes for new logs to show up.

Discord bot - Group log setup 7

๐Ÿ’ฅ Troubleshooting ๐Ÿ’ฅโ€‹

The bot isn't posting messagesโ€‹

If youโ€™ve just added the bot, please wait a few minutes.

Ensure the bot has the correct permissions to post in your channels. Check the bot's role settings and make sure it can send messages.