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.