GameGrid Discord Bot
Manage your game servers directly from Discord. 46 slash commands for server control, console access, file browsing, backups and Windrose Plus — without opening the panel.
Free for all GameGrid customers. No separate account needed — uses your GameGrid API key.
Features
Server Control
Start, stop, and restart your game servers with slash commands. Full Access role required for lifecycle actions.
Live Status
One /status call returns players, CPU, memory, uptime, network in and out, threads, connections and handles, read live from the host agent.
Console Access
View recent console output and run commands directly from Discord. Configurable command channel restriction.
Live Console Mirroring
Point a channel at a server with /config live-console or /config live-logs and new lines appear there every 10 seconds. Bindings are per channel and per server, so one Discord server can watch several game servers at once.
File & Settings
Browse server files, view settings, and manage mods — all through Discord commands.
Backups
List existing backups and create new ones on demand. Full Access role required for creating backups.
Permission Roles
Five permission levels: None, Read Only, Console Access, Full Access, and Owner. Assign per Discord role.
Support Tickets
Read your open tickets and any single ticket in full, without leaving Discord. Replies are private to you.
Channel Binding
Bind specific Discord channels to specific game servers. Commands in a bound channel automatically target that server.
Commands (46)
| Command | Description |
|---|---|
/setup | Link your GameGrid API key to this Discord server |
/config | Configure bot channels, roles, default server and live mirroring (13 subcommands) |
/servers | List your game servers |
/server | Get details for a specific server |
/status | Get live stats (CPU, RAM, players, uptime) |
/start | Start a server (Full Access only) |
/stop | Stop a server (Full Access only) |
/restart | Restart a server (Full Access only) |
/console | View recent console output (Console Access+) |
/command | Run a console command (Console Access+) |
/players | View player lists (whitelist, ban, ops) |
/backups | List, create, restore or delete backups (create/restore/delete need Full Access) |
/files | Browse server files |
/settings | View a setting, or change one (Full Access to change) |
/windrose | Windrose Plus status, config, enable/disable (Windrose servers) |
/mods | List, search, install, uninstall or toggle mods |
/auto-restart | View or set auto-restart interval |
/account | View your account info (Owner only) |
/billing | View your billing overview (Owner only) |
/tickets | List your support tickets (Owner only) |
/ticket | View a specific support ticket (Owner only) |
/check-update | Check if a server update is available |
/help | Show all available commands |
/balance | Check your in-game currency balance |
/daily | Claim your once-a-day login bonus |
/shop | Browse the server shop |
/buy | Buy an item from the shop |
/link | Link your Discord account to your in-game player |
/unlink | Remove your Discord-to-game link |
/my-transactions | View your recent shop transactions |
/help-economy | Show every economy command |
/economy-stats | Economy statistics for a server (Full Access) |
/economy-links | List all Discord-to-game links (Full Access) |
/economy-link-remove | Remove a Discord-to-game link (Full Access) |
/shop-admin | Add, remove, edit or list shop items (Full Access) |
/award | Award currency to a member (Full Access) |
/refund | Refund a purchase (Full Access) |
/economy-earn | Configure auto-earn rewards (Full Access) |
/economy-setup | Show what the economy has and what it still needs (setup user or server owner) |
/economy-config | View or rename the currency (setup user or server owner) |
/chat-link | Mirror a Discord channel to in-game chat (Full Access) |
/chat-unlink | Remove the in-game chat link (Full Access) |
/preset | Save, view, delete and apply config presets for a server (Full Access) |
/event | Schedule, inspect and cancel timed config events — a double-XP weekend that reverts itself (Full Access) |
/command-schedule | Schedule recurring console commands — save the world every hour, broadcast daily, or shut down weekly (Console Access+) |
/map | Live map — the map page, who is online and where, and what is on it (6 subcommands) |
Quick Setup
- Add the bot to your Discord server using the "Add to Discord" button above.
- Get your GameGrid API key from your account page at wdcgamegrid.com/account/api-keys. Keys start with
gsk_. - Run
/setupin your Discord server and paste your API key. The bot verifies the key and links it to your Discord server. - Configure permissions with
/config role. Assign Read Only, Console Access, Full Access, or Owner to specific Discord roles. Owner is the one that unlocks/account,/billingand the ticket commands — Full Access alone will not run them. - Set a default server with
/config default-server(optional), or bind channels to servers with/config channel-server. - Run your first command.
/serverslists what you have,/statusreports live stats, and/helpprints every command with your current access level at the top.
Security
- Your API key is encrypted with AES-256-GCM before it is stored, is never echoed back into Discord, and is never written to a log.
- Only the member who ran
/setupand the Discord server owner can change configuration. That check runs inside the bot, so a Discord Administrator who is neither is still refused. - Every member starts with no access. Access is granted per Discord role with
/config role, and a member gets the highest level any of their roles carries. - Full Access is required to start, stop or restart a server, to create a backup, and to change a setting. Console commands can additionally be confined to one channel.
- Every request goes through the same Customer API the web panel uses, signed with your key — the bot cannot reach anything that key is not scoped for.
/config resetdeletes the stored key and all configuration for that Discord server.
Questions people ask before inviting it
- Do I need to host the Discord bot myself?
- No. It is a single public bot run by GameGrid. You invite it with the Add to Discord button and link your API key; there is nothing to install or keep running.
- What does the bot cost?
- Nothing. It is included for GameGrid customers and needs no separate account — it authenticates as you, using a GameGrid API key you create in your account.
- What Discord permissions does it ask for?
- Four: View Channel, Send Messages, Embed Links, and Use Application Commands. It does not ask to read message history, manage messages, mention everyone, kick, ban, or manage roles.
- Can other people in my Discord control my servers?
- Only if you let them. Every member starts at No Access. You grant a Discord role one of Read Only, Console Access, Full Access or Owner with /config role, and a member gets the highest level any of their roles has. Owner is the tier that reads your account, billing and support tickets. @everyone can be given Read Only and nothing above it, so one wrong pick in the dropdown cannot hand server control — or your billing — to the whole Discord.
- Does anyone at GameGrid have access through the bot?
- One account does: the operator account the bot runs under. It is our support path into the bot, it is not something a customer can set, and every command it runs is written to your log channel if you have set one with /config log-channel.
- Who can change the bot configuration after setup?
- Only the member who ran /setup and the Discord server owner. That check is in the bot itself, so a Discord Administrator who is neither of those is still refused.
- Where is my API key stored, and can anyone see it?
- It is encrypted with AES-256-GCM and kept in the bot's own database. It is never echoed back into Discord, never written to a log, and is decrypted in memory only for the moment it is used to call the API.
- Will my billing or account details appear in the channel?
- No. /account, /billing, /tickets and /ticket reply privately to you — nobody else in the channel sees them.
Documentation
Step-by-step instructions for adding the bot, linking your API key, and configuring permissions.
Every command, its options, the permission level it needs, and who can see the reply.
The five permission levels, API key encryption, and the full security model.
