Chat commands
Getting started
1. Create your status
Find the short name for your game by searching with the gamelist command (the name you need is after the =).
Create the status message by specifying the game name you just found and the IP of your server (you may also need to specify a port after your IP using a colon: IP:PORT).
Once the message is created it will update every few minutes.
2. Customise your status
You can get a list of the currently active statuses in your server using the statusmod command.
This links you to the active message, and tells you what each statuses’ ID is (#ID). Using this ID you can view the settings for each status.
You can modify any of these values using the statusmod command.
For more details see statusmod.
Commands
help
List available commands or get help with a specific command.
gamelist
Output the list of games available, searchable with any text
status
Create a status message that updates automatically in the current channel.
You may get an error that the server is 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
View settings for a status
Modify setting for a status
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.
statusclear
Delete all status messages in the current channel.
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).
limits
View (and refresh) the limits for the current server (or yourself if sent via DM).
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.