Skip to content
Docs Command Reference

Matches & Results

/challenge

everyone 6 options

Challenge one or more players to a match

Name one opponent for a 1v1, or up to three more (opponent_2, opponent_3, opponent_4) for a free-for-all where everyone reports their own finishing place and ratings are scored by placement. The options count opponents, so you are not one of them — naming three opponents makes a 4-player match. The challenge message shows each player's exact best case (finishing 1st) and worst case (finishing last); middle placements land between them. The optional message option attaches a short note to the challenge ("Bo3 tonight at 8pm") — it is shown to the players and nothing more; it does not set the map or any other match setting. Set the leaderboard's map voting strategy to Challenger Chooses and /challenge will ask you to pick the map from the pool before it sends the challenge, so the players agree to a settled map rather than voting on one after. The same picker can ask for match conditions — any match-level choice stats the leaderboard nominates under Challenges → Challenge rules, such as tees, wind or ruleset. They show on the challenge so opponents know what they are accepting, and they are recorded with the match, so nobody enters them again afterwards. Declining a multi-player challenge never records a loss — forfeit-on-decline applies to 1v1 only. Cooldowns (with an issue-time or resolution-time clock), allow/block lists for who can challenge and who can be challenged, forfeit-on-decline roles, the response timer, the player cap, whether everyone or just anyone has to accept, and whether the resulting match is recorded at all are set per leaderboard under Challenges → Challenge rules. A challenge can be called off with the Cancel button — usable by the challenger or a server admin, never by the challenged player — or from Challenges (the Open challenges list). Cancelling records nothing and never counts as a forfeit. The optional leaderboard picks which leaderboard the match counts on; its list shows the leaderboards on the league's public pages (every leaderboard when it has none). Leave it empty to use the channel's leaderboard, or the server default.

Who can run it

Anyone in the server can run this command. If you would rather restrict it, add a role or member override under Server Settings → Integrations → Team Up.

Command permissions guide →

Usage

/challenge
OptionTypeWhat it does
opponent *user The player you're challenging (1v1)
opponent_2 user Add a 2nd opponent — makes it a 3-player free-for-all
opponent_3 user Add a 3rd opponent — makes it a 4-player free-for-all
opponent_4 user Add a 4th opponent — makes it a 5-player free-for-all
message text A short note shown with the challenge (e.g. "Bo3 tonight at 8pm")
leaderboard text
autocomplete
Which leaderboard it counts on (default: this channel's)

* required

Other Matches & Results commands

Record results, adjust ratings, and fix mistakes. Includes the right-click message actions that parse results out of a chat message.

Back to the full command reference →