Skip to content

/lineup create

Create a new team lineup embed in the current channel.


Usage

/lineup create name:<team name> league:<league>

Parameters

Parameter Required Description
name Yes The name of your team. This appears in the lineup embed title.
league Yes The tournament league this lineup will compete in. Populated via autocomplete — only currently active leagues are shown.

What happens

  1. The bot posts a temporary message: "Creating your lineup, standby..."
  2. This is immediately replaced with the full lineup embed, including all the slot fields for the selected league and the action buttons.
  3. You receive a private (ephemeral) confirmation: "Your lineup has been created."

The lineup embed is persistent — it stays in the channel and all updates (roster assignments, match times, scores) are applied to that same message.


Example

/lineup create name:Team Rocket league:Battle Frontier Season 2 Cycle 2

This creates a lineup for the Battle Frontier Season 2 Cycle 2 league with 7 slots: Great League, Ultra League, Master League, EUIC Cup 1, EUIC Cup 2, Majestic Cup 1, and Majestic Cup 2.


Restrictions

The command enforces three requirements before creating a lineup. If any check fails you receive an ephemeral error in the channel and a DM explaining what went wrong.

1. Rate limit — one per minute

Each user can run /lineup create at most once every 60 seconds. This prevents accidental duplicate lineups and keeps channel history clean.

If you hit the limit the error message tells you exactly how many seconds remain before you can try again.

2. Bot must have Read Messages and Send Messages

The bot needs both permissions in the channel where you run the command so it can post and later edit the lineup embed. If either permission is missing the error message names the missing permission(s) and prompts you to update the channel's permission overrides for the bot role.

3. @everyone must not have Send Messages

The lineup embed acts as the single source of truth for your team's roster and match times. If other members can post in the channel, messages accumulate around the embed and make it hard to find. To prevent this the bot requires that the @everyone role be explicitly denied Send Messages in the lineup channel.

What to do if you see this error:

  1. Open the channel settings for the lineup channel.
  2. Under Permissions, add a permission override for the @everyone role and set Send Messages to Deny.
  3. Make sure the bot role still has Send Messages and Read Messages set to Allow (or at minimum not denied).
  4. Run /lineup create again.

This setup lets only the bot write to the channel while everyone can still read the embed and interact with its buttons.


After creating

Once the lineup is created, use the buttons on the embed to manage it:

  • ✏️ Edit Schedule — Admin menu for assigning players, setting the opponent name, overriding scores and times, changing the league, and resetting the lineup
  • 📅 Set Your Match Time — Players enter when their match is scheduled
  • 🔢 Set Your Score — Players record their match result

See Managing Lineups for the full admin workflow, or Using the Bot for the player-facing experience.