Skip to main content

Discord bot

The GSA Discord bot adds features like !kickme commands for players and game server management commands for the Admin team. Talk with in-game players from Discord and more.

Go to Discord bot settings >

Bot commandsโ€‹

Discord users should first connect their Discord to GSA in order for the bot to recognize them.

Discord bot - bot commands

User commandsโ€‹

CommandInfoRole
!help

Returns all available commands.

!servers

Provides a list of available game server for the community

Player

!vote

Provides a list of available voting site URLs.

Player

!claim

Claim reward after player casted votes.

Player

!kickme

Kicks player from the game server they are on.

Player

Group commandsโ€‹

Group commands are available on Discord servers that were connected via a Community website.

CommandInfo
!motd [message]

Sets the Message of the Day for your group.

Admin commandsโ€‹

Bot commands use the Admin Team permissions to determine what an admin can do. Commands that control game servers are only working for DediConnect game servers.

CommandInfo

!start [server ID or 'all']

Perform "start" action for game server(s).

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

Perform "stop" action for game server(s), with countdown (optional).

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

Perform "restart" action for game server(s), with countdown (optional).

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

Perform "update" action for game server(s), with countdown (optional).

!cancel [server ID or 'all']

Cancels current shutdown/stop, restart & update scheduled action for game server(s).

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

Perform "create back up" action for game server(s).

Featuresโ€‹

Channel update delay

It may take a few minutes for new Discord channels to show up in the dropdown lists.

Discord + Cluster chatโ€‹

Talk directly with in-game players from Discord and visa versa. All games that support Cluster chat can use this feature.

Discord bot - Cluster chat + Discord

Navigate to the Discord page and select a Discord channel for the Discord + Cluster chat field.

info

After saving the Discord channel it may take a couple minutes for the Discord + Cluster chat to start working. Please be patient.

Discord bot - Enable Cluster chat + Discord

Player join / leaveโ€‹

Report join / leave messages to Discord and see when a new player joins a game server.

Discord bot - Player join / leave

Navigate to the Discord page and select a Discord channel for the Player join & leave field.

Discord bot - Player join / leave

Game server status cardโ€‹

Shows a status card that is automatically updated on events, like updates or scheduled restarts.

Discord bot - Game server status card

Navigate to the Discord page and select a Discord channel for the Game server status card field.

Discord bot - Player join / leave

Game server status logโ€‹

Shows detailed activity about game servers, like when a mod update was detect or the game server is starting up / shutting down.

Discord bot - Game server status log

Navigate to the Discord page and select a Discord channel for the Game server status log field.

Discord bot - Player join / leave

Group logs to Discordโ€‹

Let players report their group logs to a private Discord server, so they can see what is happening in-game when they're offline.

How-toโ€‹

Invite bot to your Discordโ€‹

In order to use the Discord bot, it should first be connected with the Discord server.

1. Connect Discordโ€‹

Navigate to the Discord page and hit Connect your Discord.

Discord bot - Connect discord 1

2. Select Discord serverโ€‹

Select the Discord server the bot should join and click Continue.

Discord bot - Connect discord 2

3. Confirm permissionsโ€‹

Leave all listed permissions enabled as the bot will need all of them. Click Authorize to invite the bot.

Discord bot - Connect discord 3

4. Done!โ€‹

Discord bot - Connect discord 4

Connect Discord for playersโ€‹

Learn how to connect your Discord account with GSA as a player.

Type !help in a channel on the community Discord (the one you're playing on) to bring up the connect link.

Discord bot - Connect player 1

2. Authorize Discordโ€‹

Click Authorize to give the bot your Discord ID and username to identify you on Discord.

Discord bot - Connect player 2

2. Success!โ€‹

After successfully connecting your Discord it may take a few minutes for the bot to recognize you.

Discord bot - Connect player 3

Setup group logs for communitiesโ€‹

Learn how to setup Group logs so your group can access group logs on your private Discord.

1. Log in on Community websiteโ€‹

Group logs can be enabled per group, by the group admins. In order to do this the group admin should log in on your Community website.

Discord bot - Group log setup 1

Head over to Group settings.

Discord bot - Group log setup 2

2. Connect group Discordโ€‹

On the Group settings page click Connect Discord to invite the bot to your private Discord server.

Discord bot - Group log setup 3

Select the Discord server that should have the group logs.

Discord bot - Group log setup 4

Leave all listed permissions enabled as the bot will need all of them. Click Authorize to invite the bot.

Discord bot - Group log setup 5

3. Select Discord channelโ€‹

Select the Discord channel where you want the group logs.

Discord bot - Group log setup 6

4. Done!โ€‹

New group logs are now automatically reported to the configured Discord channel. It may take up to 10 minutes for new group logs to post on your Discord.

Discord bot - Group log setup 7

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

The bot isn't posting messagesโ€‹

If you just added the bot to your Discord, please wait a few minutes.

Make sure the bot has permissions to talk in all channels. Check the bot roles and ensure it can send messages.