Discord Command Reference

There are two categories of Discord commands provided by Tabtastic, Participant Commands, which are available to any speaker or judge registered with Tabtastic, and Admin Commands, which are only available to Tab Staff (see Adding Staff), except for /meeting.

Most commands take ‘arguments’, which are options that change the behaviour of the command. Some arguments are optional, and are written in italics. The different types of arguments are explained below:

Type	Description
boolean	A true/false or on/off value
channel	A Discord channel, usually a text channel
number	A number, may be a whole or decimal number
string	A piece of text
rounds	A series of round abbreviations, separated by commas, e.g. R1,ESF for Round 1 and ESL Semifinals)
time	A 24 hour time, relative to the tournament’s configured timezone
user	A user on Discord

Participant Commands

/callback Judge Only

Notifies speakers using the configured debates channel that they should return to the room for the oral adjudication. Fails if the round is silent, the draw has not released, the judge is not adjudicating in this round, or the round has been marked as completed.

This command has no arguments.

/link

Links the user to a participant on tab, based on their link code or email.

Command Arguments
Name	Type	Description
code	string	The link code or email corresponding to the participant.

/tab

Sends the participant’s private URL for feedback and ballot submissions in a direct message.

This command has no arguments.

Admin Commands

Caution

If Tabtastic restarts (such as for an update), interactive or dynamic widgets (like /categorypicker or /countdown) may stop working. This is a known limitation which is currently being worked around. If a widget stops responding, delete it and create a new one. Tabtastic does not normally restart during the weekend, so this should not affect most tournaments.

/categorypicker

Creates a message in the channel the command was executed in with a button for each speaker category marked as Selectable, allowing speakers to toggle their speaker status for a given category by clicking on the corresponding button. Fails if there are no speaker categories marked as Selectable.

This command has no arguments.

/checkin

Starts a check in session on Discord, tagging @everyone, allowing participants to check in by clicking the button on the corresponding announcement. A reminder, also tagging @everyone, will be posted 3 minutes before check in closes, if the check in window is longer than 3 minutes.

Command Arguments
Name	Type	Description
closes	time	The time check in should close.
opens	time	The time check in should open. Defaults to now if not provided.
channel	channel	The text channel to post the check in message into. Defaults to the announcements channel.
chicken	boolean	Whether secret chicken powers should be activated. Defaults to false.

/countdown

Creates a simple countdown timer in the channel the command was executed in, similar to the one used by /release. A second announcement will be posted when the timer ends.

Command Arguments
Name	Type	Description
duration	number	The duration of the timer, in minutes.
name	string	The name of the timer, defaults to 'Countdown'.

/draw

Starts the process for releasing the draw and notifying participants.

Command Arguments
Name	Type	Description
rounds	rounds	The rounds to release the draw for. Defaults to all rounds with confirmed but unreleased draws.
at	time	The time to release the draw at. Defaults to now.
private	boolean	Only send the links for the debates to participants instead of publishing them on Tabbycat and in the general announcement. Defaults to false.

/judgecheckin

Creates a message in the channel the command was executed in with buttons for judges to check themselves in and out with, optionally expiring at a certain time. Speakers using the buttons has no effect.

Command Arguments
Name	Type	Description
closes	time	The time check in should close. Defaults to never.
chicken	boolean	Whether secret chicken powers should be activated. Defaults to false.

/meeting

Sets the link to join debates for a set of rooms. See Using Zoom Allocations.

Note

/meeting is a more permissive admin command. Most admin commands require the configured tab role, whereas anyone with the configured staff role, which is automatically given to any tournament staff, can use /meeting.

Caution

/meeting currently makes use of the old ‘building’ system, which will soon be replaced with more general purpose ‘zones’. This documentation will be updated once the transition is complete.

Command Arguments
Name	Type	Description
building	string	The building to set the join link for, affecting all rooms assigned to that building.
link	string	The join link to use for the affected rooms.

/purgeroles

Deletes all roles automatically generated by Tabtastic.

Caution

This command is very slow and is usually unnecessary, it should only be used for troubleshooting when directed by the Tabtastic Team.

This command has no arguments.

/refreshdraw

Fetches changes to the draw (e.g. judge and room swaps), and notifies participants who are affected.

Command Arguments
Name	Type	Description
rounds	rounds	The rounds to refresh the draw for. Defaults to all rounds with released draws that are not yet complete.

/release

Announces the motion, and info slide if provided, in the configured announcements channel after a countdown, beginning a countdown for prep time after the motion is released. The countdown before an info slide is always 60 seconds.

Command Arguments
Name	Type	Description
rounds	rounds	The rounds to release the motion for. Defaults to all rounds with released draws.
at	time	The time to start releasing the motion at. Defaults to now.
immediate	boolean	Skip the countdown before announcing the motion. If the motion has an info slide, this will be released immediately, and you will be prompted to then release the motion. Defaults to false.
skip-prep	boolean	Does not start a countdown for prep time. Defaults to false.
countdown	number	The time before the motion is released, after the info slide is released if one is provided. Defaults to 60 seconds.

/schedule

Creates a message in the channel the command was executed in the configured schedule (see Setting a Schedule), using Discord timestamps so that the times display in the user’s local timezone.

This command has no arguments.

/setlink

Forcibly links a user to a given participant on tab, based on their invite code or email.

Command Arguments
Name	Type	Description
user	user	The Discord user to be linked to a participant.
code	string	The link code or email corresponding to the participant.
silent	boolean	Hide the success message a user would see normally. Defaults to false.

/unlink

Unlinks a user from a given participant on tab.

Command Arguments
Name	Type	Description
user	user	The Discord user to be unlinked.

/update

Starts updating Tabtastic with the latest information from the connected tab. See Synchronising with the Tab.

Caution

The /update command is slowly being phased out in favour of triggering updates via the website and receiving a notification when it is finished, since updates can be a lengthy process.

This command has no arguments.