Commands - Settings

Usage Key

For commands that accept input, you'll see keys with the following:

• <required> - parameters between <> must be included with the command
• [optional] - parameters between [] are optional parameters and may be excluded
• a | or | b - | means that you can use the parameters on either side of the symbol
• repeat... - means that you can provide multiple parameters as input

These may be nested. Example: [parameter1 <parameter2>] means that the input is optional, but if you provide parameter1 then parameter2 is required. [parameter...] means that input is optional, and that the input can be any number of parameters.

Commands that change settings and configurations of the bot and what stats are displayed. All settings can be changed on the dashboard as well.

tip

Each setting can have Manager Roles set for it through the dashboard. Members with these roles are able to change the setting.

channelfilter

View; or add / remove channels to / from the filter list. The filter can be toggled between Whitelist and Blacklist with toggle channelfilter.

Controls the Channel Filter setting.

Usage

Usage

s?channelfilter 
s?channelfilter add <channelName | #channel | channelId> [channels...]
s?channelfilter remove <channelName | #channel | channelId> [channels...]

Examples

s?channelfilter 
s?channelfilter add channelA
s?channelfilter remove channelA channelB
s?channelfilter add @channelA @channelB
s?channelfilter add channelAId @channelB channelC

Aliases

cf, filterchannel

lookback

View; or set the default visible range of data for commands and the website. Does not apply to Drilldowns, Statroles, and Statdocks. Data is not deleted when changing this value.

Controls the Lookback setting.

Usage

Usage

s?lookback 
s?lookback day <# of days>
s?lookback date <day>[/month[/year]] [TZ offset] [hour[:minute]]
s?lookback all

Examples

s?lookback 
s?lookback day 7   // last 7 days
s?lookback date 1  // 1st of this month, 0:00 UTC
s?lookback date 1 -7 13  // 1st of this month, 1:00pm PST
s?lookback date 1/1/2019 5:30  // January 1st 2019, 0:00 IST

Aliases

lb, period, history, timerange

memberfilter

View; or add / remove members to / from the filter list. The filter can be toggled between Whitelist and Blacklist with toggle memberfilter.

Controls the Member Filter setting.

Usage

Usage

s?memberfilter 
s?memberfilter add <memberName | @member | memberId> [member(s)...]
s?memberfilter remove <memberName | @member | memberId> [member(s)...]

Examples

s?memberfilter 
s?memberfilter add memberA
s?memberfilter remove memberA memberB
s?memberfilter add @memberA @memberB
s?memberfilter add memberAId @memberB memberC

Aliases

mf, filtermember

precision

View; or change data on graphs to by day or by hour. Requires the Data+ upgrade to set to hour.

Controls the Precision setting.

Usage

Usage

s?precision 
s?precision <day | daily | hour | hourly>

Examples

s?precision 
s?precision day

prefix

View; or change the server's prefix. Custom prefix is case-sensitive and may contain a trailing space if wrapped in double-quotes.
You can also use @Statbot to use commands if you ever forget your prefix.
prefix reset will change the prefix to default s? / S? (not case-sensitive).

Controls the Prefix setting.

Usage

Usage

s?prefix 
s?prefix <new prefix>
s?prefix reset

Examples

s?prefix           // shows current prefix
s?prefix stats?    // stats?ping
s?prefix "stats "  // stats ping
s?prefix reset     // set to default (s? / S?)​

blacklistroles

View; or add / remove roles to / from the filter lists. When specified, a member must have no Blacklisted roles.

Controls the Role Filter setting.

Usage

Usage

s?blacklistroles 
s?blacklistroles add <roleName | @role | roleId> [role(s)...]
s?blacklistroles remove <roleName | @role | roleId> [role(s)...]

Examples

s?blacklistroles 
s?blacklistroles add roleA
s?blacklistroles remove roleA roleB
s?blacklistroles add @roleA @roleB
s?blacklistroles add roleAId @roleB roleC

Aliases

br, blacklistrole

whitelistroles

View; or add / remove roles to / from the filter lists. When specified, a member must have at least one Whitelisted role.

Controls the Role Filter setting.

Usage

Usage

s?whitelistroles 
s?whitelistroles add <roleName | @role | roleId> [role(s)...]
s?whitelistroles remove <roleName | @role | roleId> [role(s)...]

Examples

s?whitelistroles 
s?whitelistroles add roleA
s?whitelistroles remove roleA roleB
s?whitelistroles add @roleA @roleB
s?whitelistroles add roleAId @roleB roleC

Aliases

wr, whitelistrole

toggle

This command has sub-commands.

Sub-command	Setting	Description
bots	User Bot Filter	Show / hide bot stats.
channelfilter	Channel Filter	Switch channelfilter between Whitelist and Blacklist.
commandadditions	Command Additions	Show / hide additional statistics with some stats commands.
commandchannels	Command Channels	Switch commandchannels between Whitelist and Blacklist.
commandheader	Command Header	Show / hide extended information about a command, such as the UTC reminder text.
commandnotfound	Command Not Found	Turn on / off the message warning with the prefix is used without a valid command.
memberfilter	Member Filter	Switch memberfilter between Whitelist and Blacklist.
smoothing	Graph Smoothing	Turn on / off graph smoothing which will ignore 0 stats between data points.
users	User Bot Filter	Show / hide human stats.
*voice	Voice State Filter	Show / hide the voice state given with the command.

*toggle voice has further sub-commands: afk, regular, selfdeaf, selfmute, serverdeaf, servermute

Examples

s?toggle bots
s?toggle voice selfdeaf
s?toggle commandnotfound