Command reference

help

List available commands or get help with a specific command.

You - Today at 4:25 PM

/help

Discord GamestatusBOT - Today at 4:25 PM

Help
!botinfo !gamelist !help !limits !status !statusclear !statusmod !statusrefresh !statusremove !tickdebug
Use "!help commandName" for detailed help

Discord bot - Today at 4:25 PM

/help command:info

Discord GamestatusBOT - Today at 4:25 PM

Help
!botinfo
Output runtime information

gamelist

Output the list of games available, searchable with any text

You - Today at 4:25 PM

/gamelist game:Counter-strike

Discord GamestatusBOT - Today at 4:25 PM

6 Available games
Counter-Strike 1.5 (2002) = cs15 Counter-Strike 1.6 (2003) = cs16 Counter-Strike: 2D (2004) = cs2d Counter-Strike: Condition Zero (2004) = cscz Counter-Strike: Source (2004) = css Counter-Strike: Global Offensive (2012) = csgo
1

status

Create a status message that updates automatically in the current channel.

You - Today at 4:25 PM

/status game:csgo ip:10.150.150.150:27015

Discord GamestatusBOT - Today at 4:25 PM

SERVER NAME
Playing MAP with X/Y players Connect with steam://connect/10.150.150.150
Player 1 Player 4
Player 2
Player 3

You may get an error that the server is unreachable:

Discord GamestatusBOT - Today at 4:25 PM

The server (10.150.150.150:27015) was offline or unreachable

This means the bot was unable to contact the IP you specified and fetch the server info, if this happens check that:

  • You are using the correct game
  • The server is online
  • The server has queries enabled
  • The query port you specified is correct
  • You can connect to your server normally
  • You cannot query the server yourself using gamedig (see below; requires nodejs)
mkdir gamedig
cd gamedig
npm init -y
npm install gamedig
npx gamedig --debug --type GAME IP
# Example: npx gamedig --debug --type csgo 10.150.150.150:27015

If none of these fix the issue and the gamedig query fails ask for support in our discord server.

statusmod

List/View/Modify status message settings.

List status messages in current guild

You - Today at 4:25 PM

/statusmod list

Discord GamestatusBOT - Today at 4:25 PM

View settings for a status

You - Today at 4:25 PM

/statusmod get status-id:0

Discord GamestatusBOT - Today at 4:25 PM

#0
title
"{name}"
offlineTitle
"{name}"
description
"Playing {map} with {numplayers}/{maxplayers} players\nConnect with {connect}"
offlineDescription
"Server is offline"
color
2659522
offlineColor
16711680
connectUpdate
false
disconnectUpdate
false
columns
3
maxEdits
900000
dots
["⚪","⚫"]

Modify setting for a status

You - Today at 4:25 PM

/statusmod set status-id:0 setting:title value:New Title

Discord GamestatusBOT - Today at 4:25 PM

#0
SERVER NAME [IP] https://discordapp.com/channels/484737965386366979/722100887941677156/963350271407312896 Set title=New Title Changes will not take effect until after the status has updated

Reset a setting

Settings values

setting description
title, offlineTitle, description, offlineDescription Take generic text, dynamic content can be added by using formatting specifiers (for multiple lines use shift+enter)
color, offlineColor Take RGB color values as decimal (red = 16711680) or hex (red = 0xff0000)
connectUpdate, disconnectUpdate Accepts true or false
columns Takes a number for the number of player name columns, set to 0 to disable player names
maxEdits deprecated
dots Takes space separated list of dots

Formatting specifiers

specifier description
{name} Name of the server (as reported by server query)
{map} Name of the active map
{numplayers} Number of players reported by query
{validPlayers} Number of players that will be displayed in player list
{maxplayers} Player limit
{connect} Generated URL to connect to server or the server IP

statusremove

Delete a specific status update by replying to the message containing it or by specifying the ID.

TODO: Reply example

You can find the channel/message ID by enabling developer mode in Discord’s settings then right clicking the channel/message and selecting Copy ID.

You - Today at 4:25 PM

/statusremove channel:<#channel> message:1157618316907663381

Discord GamestatusBOT - Today at 4:25 PM

Done
The status message has been removed

statusclear

Delete all status messages in the current channel.

You - Today at 4:25 PM

/statusclear

Discord GamestatusBOT - Today at 4:25 PM

1 Status updates have been cleared

statusrefresh

Force the bot to send a new status message for all those that are configured in the current channel (it will also attempt to delete the old messages).

You - Today at 4:25 PM

/statusrefresh

Discord GamestatusBOT - Today at 4:25 PM

Done
Refreshed 1 updates

limits

View (and refresh) the limits for the current server (or yourself if sent via DM).

You - Today at 4:25 PM

/limits

Discord GamestatusBOT - Today at 4:25 PM

You
channelLimit
5
guildLimit
5

The limits shown above state that you can have a maximum of 5 messages per channel and 5 messages per guild.

botinfo

Get information about the bot.

You - Today at 4:25 PM

/botinfo

Discord GamestatusBOT - Today at 4:25 PM

discord-gamestatus info
discord-gamestatus v1.15.3 Report bugs here Join the support server Average ping: 103ms Uptime: 8 hours 58 minutes 5 seconds Working in 2239 guilds Memory usage: 265857kb/307892kb Dependencies NodeJS v17.8.0 discord.js-light discord.js gamedig