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.
Bot commandsโ
To use the bot, Discord users must first connect their Discord account to GSA so the bot can recognize them.
User commandsโ
Command | Info | Role |
!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 only available in Discord servers linked via a Community website.
Command | Info |
!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.
Command | Info |
!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โ
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.
Go to the Discord page and assign a channel to the Discord + Cluster chat setting.
It may take a few minutes for chat to activate after saving your channel. Please be patient.
Player join / leaveโ
Get real-time join/leave notifications in Discord when players enter or exit a game server.
Set up the Player join & leave channel on the Discord page.
Game server status cardโ
Display a real-time server status card that updates on events like restarts or updates.
Assign a channel for the Game server status card on the Discord page.
Game server status logโ
Track detailed server events such as startup, shutdown, or mod updates in Discord.
Assign a channel for the Game server status log on the Discord page.
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.
2. Select Discord serverโ
Choose the Discord server where the bot should be installed and click Continue.
3. Confirm permissionsโ
Keep all requested permissions enabled, the bot needs them to function properly. Click Authorize.
4. Done!โ
Connect Discord for playersโ
Learn how players can connect their Discord account with GSA.
1. Get the connect linkโ
Type !help
in a community Discord channel to get your personal connect link.
2. Authorize Discordโ
Click Authorize to link your Discord ID and username.
3. Success!โ
After connecting, it may take a few minutes before the bot recognizes you.
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.
Go to Group settings.
2. Connect group Discordโ
On the settings page, click Connect Discord to invite the bot to your group's private server.
Select the server where you want group logs to be posted.
Keep all listed permissions enabled, then click Authorize.
3. Select Discord channelโ
Choose the channel where group logs should be posted.
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.
๐ฅ 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.