A reference to every slash command. MagnoliaBot is multi-tenant: each server's players, seasons, points, and subscriptions are private to that server, while the Event catalog is shared across all servers. For the concepts behind these commands, see How it works.
Permission tiers
| Tier | Who | What they manage |
|---|
| Everyone | any member | self-registration, read-only views |
| Server Admin | Discord Administrator permission | their server's players, seasons, points, subscriptions, AI settings |
| Super Admin | bot-wide role (OWNER_ID + /superadmin) | the shared global Event catalog |
/player — player roster
A Player is someone tracked on RK9. The display name must match the RK9 name (without the [US]-style country suffix); only players with an RK9 name are watched.
| Subcommand | Who | Purpose |
|---|
register | member (or admin via user) | register a player with a display name and RK9 id |
update | admin | change a player's display name or RK9 id |
highlight | admin | flag/unflag a player for special styling |
highlighted | everyone | list highlighted players |
list | everyone | list the server's active players |
tournaments | everyone | show the events a player is registered for, with placements |
/event — global Event catalog
An Event is a tournament in the shared catalog. Curation is Super-Admin-only; server admins reach the catalog through request and through /subscription. Event identity is the normalized RK9 URL — two requests for the same URL resolve to one event.
| Subcommand | Who | Purpose |
|---|
request | Server Admin | petition for an event by RK9 URL; auto-subscribes on approval (or immediately, if it already exists) |
create | Super Admin | add an event to the catalog (name, date, optional RK9 URL) |
edit | Super Admin | change an event's name, date, or URL |
delete | Super Admin | remove an event from the catalog |
list | Super Admin | list upcoming events |
requests | Super Admin | view pending event requests |
approve | Super Admin | validate the URL, create the event, and subscribe the requester |
reject | Super Admin | reject a request with a reason |
/subscription — your server's subscriptions (Server Admin)
Subscribing tells the watcher to post an event's round results in your server. It captures the destination channel and watches every registered player in your server who has an RK9 name — there is no per-event roster.
| Subcommand | Purpose |
|---|
subscribe | subscribe to an event; channel: defaults to the current channel |
unsubscribe | stop watching an event |
list | list your server's subscriptions and their channels |
register | register yourself for a subscribed event (records placements) |
players | view players registered for a subscribed event |
/results — on-demand RK9 results
Reports the current round's matches for your server's registered players.
| Subcommand | Purpose |
|---|
latest | scrape results for the most recent active event |
tournament | scrape results for an event by name |
/season — championship seasons (Server Admin)
A time-boxed points period (typically a calendar quarter), scoped to your server.
| Subcommand | Purpose |
|---|
start | open a season (defaults to the current quarter) |
finish | close a season |
current | show the active season |
list | list all seasons |
leaderboard | show a season's victory-point standings |
/victorypoints — points league (Server Admin)
| Subcommand | Purpose |
|---|
add | award points to a player (with optional reason) |
subtract | deduct points |
view | a player's points for a season |
leaderboard | season standings |
history | a player's full points history |
/watcher — watcher diagnostics
| Subcommand | Who | Purpose |
|---|
status | everyone | your server's subscriptions in the watch window, last round, and channel health |
global | Super Admin | every watched event, subscriber counts, and scrape-cycle health across all servers |
/config — per-server settings (Server Admin)
| Subcommand | Purpose |
|---|
ai state:on|off | enable/disable AI mention replies for this server (off by default; mention-only; daily cap) |
/superadmin — bot-wide Super Admins (Super Admin)
Super Admin is attached to a Discord user identity and applies in every server the bot shares with that user.
| Subcommand | Purpose |
|---|
add | appoint a user as a Super Admin |
remove | remove a Super Admin (the owner, OWNER_ID, cannot be removed) |
list | list Super Admins |
