Installation

Step 1

Invite the bot to your Discord server.

Step 2

Wait for the bot to finish its initial server setup.

On first join, the bot creates its baseline roles and channels if they do not already exist.

Step 3

Activate the guild.

The bot is gated by manual guild activation right now. Until activation is completed, guild commands will return an activation error.

Step 4

Run /sync-users.

This creates missing player records for current guild members and makes sure the guild exists in the database.

Step 5

Set command permissions in Discord.

Recommended approach:

• Only staff should have access to organizer and admin commands.
• Captains should only have access to captain-facing commands.
• Players should have access only to player-facing commands such as /player-card.

Step 6

Configure the guild with /config.

This is where you set:

• enabled regions
• roster size
• weekly matchmaking rules
• schedule announcement channel
• automatic weekly schedule generation time

Step 7

Make sure players can receive the Free Agent role.

The bot expects players who are available to join teams to carry the Free Agent role.