Skip to content
Docs Command Reference

Matches & Results

/challenge

everyone 5 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 Discord Management → Challenge Command, 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 Discord Management → Challenge Command. 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 Discord Management → Challenge Command → Open Challenges. Cancelling records nothing and never counts as a forfeit.

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

Challenge one or more players to a match

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")

* required