This is the walkthrough for a server admin onboarding their own Discord server. Hosting your own instance instead? See Self-hosting.
1. Invite the bot
Use the bot's invite link (ask the bot operator for it). The bot needs:
- Scopes:
botandapplications.commands - Permissions: View Channels, Send Messages, Embed Links, and Read Message History in the channel(s) where you want round updates posted.
2. Register the players you want to track
Players are who the watcher looks for on RK9 pairings.
/player register displayname:<name> playerid:<rk9-id>
- A member can register themselves with the command above.
- An admin can register anyone by adding the
discorduseroption.
The display name must match the player's name on RK9 (without the [US]-style country suffix). Only players with an RK9 name are watched.
3. Subscribe to an event
An Event is a tournament in the global catalog (e.g. a regional). Subscribing tells the bot to post that event's round results in your server.
/subscription subscribe event:<name> [channel:#channel]
- The destination channel is captured when you run the command — it defaults to the current channel, or pass
channel:to choose another. - Subscribing automatically watches every registered player in your server who has an RK9 name — there's no per-event roster.
- See your server's subscriptions with
/subscription list.
4. If the event isn't in the catalog yet
The catalog is curated by Super Admins, so you can't add events directly — you request them:
/event request url:<rk9-pairings-url> [channel:#channel]
A Super Admin reviews pending requests and approves or rejects them. On approval the event is created and your server is automatically subscribed in the channel you requested it from. If the event already exists, requesting it just subscribes you immediately.
5. Optional: enable AI replies
The bot can reply when mentioned, using AI. This is off by default. An admin turns it on with /config ai state:on (and back off with state:off). Replies are mention-only and capped per day.
6. Optional: run a points league
If your community runs a victory-points league:
/season start— open a championship season (defaults to the current quarter)./victorypoints add player:@user points:<n>/subtract— award or deduct points./season leaderboardor/victorypoints leaderboard— see standings.
Checking on the watcher
/watcher status shows your server's subscriptions in the current watch window, the last round detected, and whether any channel is broken (deleted, or the bot can't post there).
