Skip to main content
These commands are available to users with the Referee role. They allow referees to start and end matches, configure IRC credentials, assign referees to matches, and manage match lobbies.

​
/startref

Initiates a new match and creates its associated Discord thread.
​
match-id
string
required
The unique identifier for the match (e.g., “A1”, “QF1”)
​
referee
string
required
The display name of the referee who will manage this match
​
match-type
MatchType
required
The type of match being started (e.g., Qualifiers, Elimination)

​
Usage Example

/startref match-id:A1 referee:JohnDoe match-type:Elimination
This command will:
  • Verify that the referee exists in the database
  • Create a match environment with the specified ID
  • Generate a Discord thread for match coordination
  • Notify the channel that the match has started successfully
The referee must have previously configured their IRC credentials using /linkirc before they can be assigned to matches.

​
/endref

Finalizes a match and archives its Discord thread.
​
match-id
string
required
The unique identifier of the match to end

​
Usage Example

/endref match-id:A1
This command will:
  • Close the match worker process
  • Archive the associated Discord thread
  • Update the match status in the database
This action cannot be undone. Ensure all match results have been properly recorded before ending the match.

​
/linkirc

Configures your IRC credentials for automated referee bot functionality.
​
nombre
string
required
Your display name as a referee
​
osuId
integer
required
Your osu! user ID
​
ircPass
string
required
Your IRC authentication password for BanchoBot

​
Usage Example

/linkirc nombre:JohnDoe osuId:1234567 ircPass:your_irc_password
This command stores your IRC password in the database. Use this in a private channel or DM to protect your credentials. Your Discord ID will be automatically linked to this referee profile.
The bot will respond with a confirmation showing:
  • Referee display name
  • osu! ID
  • Discord ID (automatically captured)

​
/assignref

Assigns a referee to a specific match that has already been created.
​
matchId
string
required
The ID of the match to assign a referee to
​
refName
string
required
The display name of the referee to assign

​
Usage Example

/assignref matchId:A1 refName:JohnDoe
This command:
  • Verifies the referee exists in the database
  • Verifies the match exists (checks both regular matches and qualifier lobbies)
  • Updates the match with the assigned referee
  • Works for both elimination matches and qualifier lobbies
You can reassign a referee to a match by running this command again with a different referee name.

​
/addmplinkid

Adds or updates the osu! multiplayer lobby ID for a match.
​
matchId
string
required
The ID of the match in the database
​
mpLinkId
string
required
The multiplayer lobby ID from osu! (numeric value from the MP link)

​
Usage Example

/addmplinkid matchId:A1 mpLinkId:118575195
The MP link ID is the numeric value in osu! multiplayer lobby URLs. For example, in https://osu.ppy.sh/community/matches/118575195, the ID is 118575195.
This is required before you can import scores directly from the osu! API.

​
/matchups

Displays a paginated list of all scheduled matches.

​
Usage Example

/matchups
This command shows:
  • Match ID
  • Team Red vs Team Blue
  • Scheduled date and time
  • Pagination controls (5 matches per page)
Use the ◀️ and ▶️ buttons to navigate between pages.
Matches are displayed in descending order by start time, showing the most recent matches first.

Build docs developers (and LLMs) love

Get started for freeTalk to us