Skip to main content

/tournament create

Admin Command

This command requires administrator permissions.

Create a new tournament and show signup buttons.

Usage​

/tournament create [maximum_participants] (tournament_type) (auto_start_on_fill) (auto_create_matches) (auto_create_new_tournament) (team_size) (name) (url) (details) (forfeit_timer_sec)

Arguments​

  • maximum_participants: (Required) Maximum number of teams that can register.
  • tournament_type: (Optional) (Default: Single Elimination) Tournament type.
        Options: single_elimination, double_elimination, round_robin, swiss
  • auto_start_on_fill: (Optional) (Default: True) Automatically start the tournament when the participant capacity is hit.
  • auto_create_matches: (Optional) (Default: True) If the bot should automatically create matches when ready.
  • auto_create_new_tournament: (Optional) (Default: On Completion) Automatically create a new tournament when this one starts/ends?.
        Options: On Start, On Completion, Never
  • team_size: (Optional) Number of players on each team.
  • name: (Optional) The tournament name, also the name of the queue/stats storage for determining seeding.
  • url: (Optional) Tournament URL slug, or omit to auto generate.
  • details: (Optional) Any extra details to show in the queue message.
  • forfeit_timer_sec: (Optional) How longer players have to join the match (in seconds) before forfeiting.

Details​

Creates a fully configurable tournament, posts a persistent signup message with interactive Join/Leave buttons, and runs the bracket. New tournaments use the native NeatQueue engine by default: brackets, seeding, match pairing, and standings are owned locally (no Challonge account required) and are viewable on the website in real time. Pass use_challonge: True to instead run the tournament on the legacy Challonge engine (requires a linked Challonge account). The bot auto-seeds by MMR, spins up queue matches as the bracket progresses, applies entry-fee/payout options, and supports automatic behaviors (start on fill, auto-create matches or successor tournaments).

Required Permissions​

Permission Required

This command requires either:

  • A configured NeatQueue Staff Role
  • Manage Channels permission