About the ChatBot

The aim of this ChatBot is to make life better for players and Judges in events that are too large to use paper as the sole method of displaying pairings.

Rather than a custom website or app, Facebook was chosen as it's reasonable to expect that a decent proportion of players at events have an account, and carry with them a mobile device able to access it.

For the Player

1) Visit the page your Tournament Organiser has set up to host pairings.

They might have given you the name of the page, an http://m.me/ link or a Messenger code to scan.

2) Start a chat with the bot.

The chat should appear something like this on first contact.

3) Type your DCI

If found, the pairing should appear and give you a button to register for notifications.
If pressed, you will be notified with your table number whenever you are paired.

OR Type your name

If found, the pairing should appear and give you a button to register for notifications.
If pressed, you will be notified with your table number whenever you are paired.

Player Commands

  • A name
    • This searches the pairings for the name given.
    • If found, it will give the pairing for that player.
    • If you don't already have notifications set up, a button will allow you to get notifications for that name.
  • A DCI Number
    • This searches the pairings for the DCI number given.
    • If found, it will give the pairing for that player.
    • If you don't already have notifications set up, a button will allow you to get notifications for that DCI number.
  • T<number> (e.g T42)
    • This searches the pairings for the given table number.
  • me
    • If you have notifications set up, it gives you your current pairing.
  • STOP
    • Clears any notifications you have set up.
  • ABOUT
    • Displays some information about the bot.
  • HELP
    • Lists these commands.

For the Scorekeeper

1) Enter the scorekeeper password.

This can be set by the Tournament Organiser for their individual pairings page.

2) Export the pairings.

Use WER's Export feature to save the event, or use WLTR to generate a CSV file of pairings.
NOTE: If using WLTR, upload a JSON event export for Round 1. Then pairing CSVs can be used for Rounds 2 and onwards.

3) Upload the pairings.

Once you have exported the current round's pairings from WLTR or WER, use the "Add Files" button in the chat window to send the pairings to the bot.
Check that the bot has detected the correct number of pairings in the file.
You can set the starting table number here if you need to.
Once you have confirmed everything looks correct, click the Round X button provided or manually type "Round N" if the detected round number isn't correct.
If you have entered a round number that has already been paired, the bot will ask you if you are re-pairing the round.

5) That's it!

The bot will automatically send notifications to players who have signed up for notifications.

Scorekeeper Commands

  • ALLTABLES
    • Show all pairings for the current round.
  • EOR
    • Set the End Of Round flag, which prevents users from querying the pairings while new ones are being uploaded.
  • SOR
    • Clear the End of Round flag, if set. This is done automatically by uploading new pairings.
  • STN <n> (e.g STN 5)
    • Set the Starting Table Number, if required. Defaults to 1.
  • ROUND <n> (e.g ROUND 4)
    • Manually set the Round Number, if required, though the bot will try to automatically detect it.
  • RESET
    • Delete all pairings and rounds, and clear all flags.
  • STOS
    • Toggle the Send to Other Scorekeepers flag, which will inform other registered Scorekeepers of actions that are taken.
  • PROTOUR
    • Toggle the Pro Tour style pairing flag, which will prevent players from seeing their opponents' names and searching for pairings.
  • SKSTOP/SKSTART
    • Unsubscribe/Re-Subscribe from Scorekeeper Notifications sent when the STOS flag is set.
      Note: You are subscribed by default when you input the Scorekeeper password.
  • SILENT
    • Toggles the silent flag, which stops the bot from sending any pushed notifications to players (though you can still pair as normal). Useful for fixing uploads without re-spamming everyone.
  • FULLSILENCE
    • Toggles the full silence flag, which stops the bot from sending any messages at all (i.e turns it on and off).

Judge Commands

  • Normal Judge Privileges
    • Inputting the Judge password allows you to retrieve pairings while the EOR flag is set, while PROTOUR mode is on and also displays Pending pairings that haven't been published yet.
    • As a Judge, querying any Table will also allow you to see TABLE HISTORY (who has played there in previous rounds) and PLAYER HISTORY (who the players at the table have played previously).
  • R<x>T<y> (e.g R3T12)
    • Displays the given table for the given round. This will also allow you to locate where the players from that historical table are currently playing.
  • RANDOMTABLE
    • Displays a random table from the current round
  • RANDOMTABLE <n>(e.g RANDOMTABLE 20)
    • Displays a random table from the current round between 1 and the number given.

For the Tournament Organiser

1) Create a Facebook Page to host your pairings

It's best to create a separate page to handle all your event pairings. Calling it something like "Your Store Name Pairings" will make it easy for your players to find and remember. If you already have one, great! Otherwise, you can create a page here.

2) Add the App to your Page.

Visit the Sign Up page and subscribe your page to the Bot.

3) Add a messenger button to your page.

Make it easy for the players to open a chat with your page by adding the "Send a Message" button.

4) That's it!

Your page is ready to be used for online pairings.
Publish the link to your pairings page on your event, and you can also use Facebook to generate a http://m.me/pageusername link (if your page has an @username) or an image that players can scan with their phone that goes directly to the ChatBot.



Magic: the Gathering and related properties are Copyright © Wizards of the Coast - All Rights Reserved. This website is not affiliated with Wizards of the Coast in any way.