Running a tournament with TJ Sheets

Running the tournament (TJ Sheets)

1. Follow the instructions for creating the TJ Sheets control sheet and room scoresheets (steps 1-4 in the instructions)
2. Create your tournament server
3. Invite the bot by clicking on this link
4. Add a role for the bot that gives it the following permissions:
   • Read Text Channels & See Voice Messages
   • Embed Links
   • Send Messages
   • Mute Members
5. Create a reader role for readers. If you create multiple reader roles, then they should begin with a common prefix.
6. Have the server admin run !setReaderRolePrefix *prefix*. For example, if the reader role is Reader, we would run !setReaderRolePrefix Reader.
7. Create the team roles. The roles must have a prefix in common, like Team A, Team B, etc.
8. Have the server admin run !setTeamRolePrefix *prefix*. For example, if our teams are Team A, Team B, we would run !setTeamRolePrefix Team
9. Assign players to these team roles
10. Once everyone has joined, have the server admin run !setRostersForTJ *URL_to_control_sheet*. For example, if https://docs.google.com/spreadsheets/d/1dZ_Yj_WBt5nWoHdyhv2VYeW--ecNR8-aQY39TBsaNwU was the link to your Control Room sheet, then run !setRostersForTJ https://docs.google.com/spreadsheets/d/1dZ_Yj_WBt5nWoHdyhv2VYeW--ecNR8-aQY39TBsaNwU.
11. If you are using bonuses, have the server admin run !enableBonusesByDefault. This makes every game use bonuses in the server.
12. For each game
    1. The reader types in !read to make the bot start scorekeeping
    2. Follow the instructions in Gameplay to keep score
    3. When you are ready to create the scoresheet, run !exportToTJ *URL_to_scoresheet* *round_number*. The bot will try to update the scoresheet, and tell you if it was successful.
       • For example, if your have finished reading round 3, and your scoresheet is at https://docs.google.com/spreadsheets/d/1IJji0c23_mOYz6SnMiUlj2WDCIAHutIqfMdG-0hpEIU, you should run !exportToTJ https://docs.google.com/spreadsheets/d/1IJji0c23_mOYz6SnMiUlj2WDCIAHutIqfMdG-0hpEIU 3.

Limitations

The scoresheet has the following limitations:

• The bot will use the user's nicknames or usernames in Discord to fill out the scoresheet, so they cannot change them in the server between setting the rosters and exporting a scoresheet. Otherwise, the scoresheet will have errors and the SQBS export will fail.
• It will only track up to 24 tossups, and only 20 bonuses. It will currently fail to export if you have read more than 24 questions.
  • You can !undo until you get to tossup 24, then export it.
• It will only work for up to 2 teams.
• It will only work as long as each team has 6 players or less.
• Users and servers have a daily export limit. At the time of this writing, users can export 50 scoresheets a day, and 1000 scoresheets can be exported from a server.