Docs

Complete reference for all Supatimer Discord bot slash commands. Hover over any code block to copy.

Last updated: March 25, 2026See latest changes in changelog

Video Tour

Watch a 7-minute walkthrough covering bot setup, team configuration, and all key features.

Chapters

Questions or feedback? Join our Discord community for help.

Join Discord

Admin Commands

/setup

Admin Only

Guided setup wizard for first-time bot configuration. Walks admins through channel selection, role assignment, and time slot setup in an interactive flow.

Syntax

Supatimer/setup

Examples

Supatimer/setup

Opens an interactive wizard with step-by-step prompts. Asks you to select channels, roles, and time slots. Takes less than 1 minute to complete.

Note: This is the recommended way to configure the bot for the first time. It covers everything /config does but in a guided format.

/config

Admin Only

Configure bot settings manually. Add or remove channels and roles, and set time slots for specific channels.

Syntax

Supatimer/config[help] [add-channels] [remove-channels] [add-roles] [remove-roles] [time-slots] [name-format]

Options

OptionTypeRequiredDescription
helpBoolean
Optional
Show help documentation
add-channelsString
Optional
Add channels to allowed list (mention them: #channel)
remove-channelsString
Optional
Remove channels from allowed list (mention them: #channel)
add-rolesString
Optional
Add roles to allowed list (mention them: @role)
remove-rolesString
Optional
Remove roles from allowed list (mention them: @role)
time-slotsString
Optional
Set time slots for specific channels (mention them: #channel1 #channel2)
name-formatString
Optional
How player names appear in embeds for this team (full/clean/short/emoji_short/emoji_initial)

Examples

Supatimer/configadd-channels:#scrims #practice

Adds #scrims and #practice to the list of channels where the bot can post calendars.

Supatimer/configadd-roles:@Tank @DPS @Support

Adds Tank, DPS, and Support roles to the allowed roles list. Members with these roles can use bot commands.

Supatimer/configtime-slots:#scrims

Opens time slot configuration for the #scrims channel. Lets you define when scrims are scheduled.

Supatimer/configname-format:emoji_short

Changes this team's embed display to show role emojis + 3-letter names (e.g. shield emoji + Rav instead of RavensCabin).

Note: Running /config with no options shows the current configuration overview. Use /setup for guided first-time configuration.

Team Commands

/avail

Team Member

Post an availability calendar embed in the current channel. Team members can react to indicate which time slots they're available for.

Syntax

Supatimer/avail[help] [roles] [players]

Options

OptionTypeRequiredDescription
helpString
Optional
Get help (use 'all' for full help, or specific option name)Choices: "all", "roles", "players"
rolesString
Optional
Discord roles to ping (e.g., @pranksters @ringers)
playersString
Optional
Discord users to ping individually (e.g., @alice @bob)

Examples

Supatimer/avail

Posts a weekly availability calendar embed in the current channel. Team members with allowed roles can click buttons to mark their availability.

Supatimer/availroles:@Tank @Support

Posts the calendar and pings members with the Tank and Support roles to fill in their availability.

Supatimer/availplayers:@Alice @Bob

Posts the calendar and pings Alice and Bob individually. Both are added to the calendar's tracked users alongside any role members.

Supatimer/availhelp:all

Shows the full help documentation for the /avail command and all its options.

/early-lineup

Team Member

Post or update the next preliminary scrim lineup based on current availability data.

Syntax

Supatimer/early-lineup[time]

Options

OptionTypeRequiredDescription
timeString
Optional
Scrim time (e.g. '20-22 CET'). Defaults to last used time.

Examples

Supatimer/early-lineup

Posts the preliminary lineup for the next scrim using the last configured time slot. Shows who's available and suggested positions.

Supatimer/early-lineuptime:20-22 CET

Posts the lineup for a scrim at 20:00-22:00 CET. Only shows members who marked themselves as available for that time window.

Note: Each lineup post includes three copy buttons (Minimal, With Map Pool, Map Pool + Roster) for sharing scrim exchange info. Configure your team's scrim settings and map pool in Team Settings on the web dashboard.

/scrim

Team Member

Confirm a scrim and post the details to the designated scrim channel. Requires opponent information.

Syntax

Supatimer/scrimopponent_name:<name>opponent_sr:<rank>opponent_battlenet:<tag> [time] [host] [map_pool] [stagger] [hero_bans] [notes] [our_lineup] [their_lineup]

Options

OptionTypeRequiredDescription
opponent_nameString
Required
Opponent team name (e.g. 'Payload Pangolins')
opponent_srString
Required
Opponent SR / rank (e.g. '4.2k')
opponent_battlenetString
Required
Opponent BattleNet contact (e.g. 'Fracture#1234')
timeString
Optional
Scrim time (e.g. '20-22 CET'). Defaults to last used time.
hostString
Optional
Who hosts? Default: UsChoices: "Us", "Them"
map_poolString
Optional
Map pool name (e.g. 'Crown Cup Stage 1', 'Ours')
staggerBoolean
Optional
Stagger enabled? Default: Off
hero_bansBoolean
Optional
Hero bans enabled? Default: Off
notesString
Optional
Extra notes (e.g. 'Vendetta: ON', 'New Heroes: OFF')
our_lineupString
Optional
Our lineup: @tank @dps @dps @sup @sup (5 or 6 mentions)
their_lineupString
Optional
Their players: name1 name2 name3 name4 name5 (5 or 6 names)

Examples

Supatimer/scrimopponent_name:Payload Pangolinsopponent_sr:4.2kopponent_battlenet:Fracture#1234

Posts a confirmed scrim embed in the scrim channel with opponent details, using the default time and settings.

Supatimer/scrimopponent_name:Dive Mastersopponent_sr:3.8kopponent_battlenet:Echo#5678time:21-23 CEThost:Themmap_pool:Crown Cup Stage 1hero_bans:True

Posts a fully detailed scrim embed with custom time, opponent hosting, specific map pool, and hero bans enabled.

/update

Team Member

Update the latest scrim post with a score (wins/losses/draws) and an optional comment.

Syntax

Supatimer/updatewins:<number>losses:<number> [draws] [comment]

Options

OptionTypeRequiredDescription
winsInteger
Required
Number of wins
lossesInteger
Required
Number of losses
drawsInteger
Optional
Number of draws (default: 0)
commentString
Optional
Optional comment/notes (auto-wrapped in parentheses)

Examples

Supatimer/updatewins:3losses:1

Updates the latest scrim post to show a 3-1 score. The scrim embed is edited in-place with the result.

Supatimer/updatewins:2losses:2draws:1comment:Close maps, need to work on Ilios

Updates the scrim post with a 2-2-1 score and adds '(Close maps, need to work on Ilios)' as a note.

/weekplan

Team Member

Generate and post the weekly preliminary lineup to the current channel. If preliminaries already exist, re-renders and posts or updates the existing message.

Syntax

Supatimer/weekplan[redo]

Options

OptionTypeRequiredDescription
redoBoolean
Optional
Recalculate from scratch (overwrites manual edits made on the website)

Examples

Supatimer/weekplan

Generates the weekly preliminary lineup from current availability and posts it to the channel. If already posted, updates the existing message.

Supatimer/weekplanredo:True

Recalculates all slot assignments from scratch (ignoring manual edits) and posts/updates the weekly preliminary lineup.

Note: Must be run in the channel configured as the team's weekly preliminaries channel. Only team managers can run this command.

Personal Commands

/my-info

Any User

View and edit your personal contact information. Shows your current Battle.net tag and lets you update it via a Discord modal.

Syntax

Supatimer/my-info

Examples

Supatimer/my-info

Shows an ephemeral embed with your current Battle.net tag (or 'Not set'). Click the Edit button to open a modal where you can set or change your tag.

Note: Your Battle.net tag is also visible and editable from the web dashboard via the user menu in the top-right corner.

/roast

Any User

Roast a fellow gamer with a random burn. The roast is posted publicly in the channel for everyone to see.

Syntax

Supatimer/roasttarget:@username

Options

OptionTypeRequiredDescription
targetUser
Required
The player to roast (required). Pick any server member.

Examples

Supatimer/roasttarget:@PlayerName

Posts a random roast mentioning the target user, visible to everyone in the channel.

/nickname

Any User

Set your Supatimer display name in this server. This overrides your Discord nickname everywhere Supatimer shows your name (lineups, calendar embeds, polls, absences).

Syntax

Supatimer/nickname[name]

Options

OptionTypeRequiredDescription
nameString
Optional
Your custom nickname (optional, max 32 characters). Leave empty to clear and fall back to your Discord nickname or username.

Examples

Supatimer/nicknamename:Raven

Sets your Supatimer nickname in this server to 'Raven'. Takes priority over your Discord server nickname and username.

Supatimer/nickname

Clears your Supatimer nickname. Your Discord server nickname, global name, or username is used instead.

Note: Only affects this server. Admins and team managers can also set nicknames for other members via the Members page.

Need help? Join our Discord server or run /avail help:all in your server.