Documentation

Player Guide

Welcome! Here's everything you need to get the most out of The Muster — from finding pickup games and joining leagues to getting help when you're stuck.

Jump to section

Player Guide

Welcome! This guide covers everything you need to get the most out of The Muster — from finding pickup games and joining leagues to getting help when you’re stuck. Let’s get you gaming.


Pickup Games

Pickup games are quick, one-off matches sorted through the bot. Tell it what you want to play, and it’ll find you a worthy opponent.

How to Find Games

Step 1 — Join the queue

Type /lfg in any channel. The bot walks you through a short wizard:

/lfg game: Warhammer 40k points: 2000
  1. Pick your game — Choose from the available systems (e.g. Warhammer 40k, Age of Sigmar, Kill Team).
  2. Set your points — Enter a single value like 2000, or a range like 1000-2000 if you’re flexible.
  3. Choose your vibe — Select one or more play style tags:
    • 🍺 Casual — Relaxed, narrative, thematic lists. Just here for a good time.
    • 🏆 Competitive — Tournament practice, optimised lists, playing to win.
    • 📖 Learner — New to the game or happy to teach. Patient, rules-focused.
  4. Pick a club night — Which upcoming session do you want to play at? Options range from this week to four weeks out.

Tip: You can run /lfg multiple times to queue for different game systems or different club nights. Want a 2000pt competitive 40k game and a 1000pt casual Kill Team game? Queue for both!

Step 2 — The bot does the matching

The bot runs a matchmaking batch on a regular schedule (typically daily). It looks for someone who:

You don’t need to do anything — just wait for your DM.

Step 3 — Check your DM

After the batch runs, you’ll get a direct message from the bot:

The Muster BOT Direct Message
The Muster BOT Today at 19:32
⚔️ You're in the Queue
You've been added to the matchmaking queue. We'll notify you when pairings are ready.
Game System
Warhammer 40k
Points
2000pts
Queue Position
#5 of 12

Don’t worry if you’re not matched straight away. Your queue entry stays active, and the bot tries again at the next batch. If the batch runs before club night, you get one extra day automatically before the entry expires.

How Matchmaking Works

Curious about what’s happening behind the scenes? Here’s how the bot works its magic:

  1. Queued players are lined up in order (first come, first served) for each game system and target club night.
  2. The bot pairs compatible players — same system, overlapping points range, at least one shared play style tag, same club night.
  3. Variety is built in — if you’ve played someone in the last 3 weeks, the bot skips them and looks for a different opponent.
  4. On club night itself, the 3-week repeat rule relaxes so everyone can get a game, even if it means a rematch.
  5. Odd player out? If an odd number of players are queued for a system, the bot posts a warning in the announcement channel before the batch runs, asking if anyone else wants to jump in.

Managing Your Queue

CommandWhen to use it
/lfgYou want to find a game — run this first
/my-queueCheck what you’re currently queued for
/leave-queueChanged your mind? This cancels all your active entries
/my-queue
The Muster BOT Direct Message
The Muster BOT Today at 19:35
📋 Your Queue Status
Game System
Warhammer 40k
Points
2000pts
Position
#5 of 12
Status
Queued — waiting for batch
/leave-queue

After Your Game — Reporting Results

Once you’ve played, either player can report the result:

/report-result opponent: @SpaceWolfSteve result: win

Your opponent gets a DM asking them to confirm or dispute the score. Confirmed results are saved to your match history. If there’s a disagreement, a league admin will sort it out.

The Muster BOT Direct Message
The Muster BOT Today at 21:15
⚔️ Result Pending Confirmation
@YourName reported the following result:
Reported Result
Win for @YourName
Game System
Warhammer 40k — 2000pts
Confirm
Dispute

Once confirmed, the results are posted to your club’s matchmaking announcement channel:

# matchmaking
The Muster BOT Today at 22:05
⚔️ Thursday Night Results — Warhammer 40k
The Emperor protects… but so does a good battle plan. Here are tonight's pairings and results:
Match 1
@SpaceWolfSteve vs @GreenSkarBoy — 2000pts
Match 2
@OrkWarrior99 vs @ChaosLord_X — 2000pts
Match 3
@EldarFarseer vs @NidSwarmKing — 2000pts

Leagues & Tournaments

Want something more structured? Leagues are multi-round tournaments run by your club’s organisers. They track your results across every round and maintain a live leaderboard — so you always know where you stand.

What Formats Are Available?

FormatHow it worksBest for
SwissEach round, you’re paired against someone with a similar record. Everyone plays every round.Large groups — fair pairings without needing every player to face every other player.
Round RobinYou play against every other player, one match per round.Smaller groups where you want a complete picture of who’s best.

How to Join a League

Browse what’s available:

/league list

Shows all leagues in the server — their format, how many players have signed up, and whether registration is still open.

Get the details:

/league info <league name>

Shows the full breakdown: game system, format, capacity, and whether there are any entry requirements (like needing a specific Discord role).

Sign up:

/league join <league name>

That’s it — you’re in. The bot confirms your spot.

Note: Some leagues may require you to have a particular Discord role before you can join. If you’re blocked, check with your league admin about getting the role.

Changed your mind?

/league leave <league name>

If the league hasn’t started yet, you’re simply removed from the roster. If it’s already underway, you’ll be marked as “dropped” — your remaining opponents get automatic bye wins for any unplayed matches.

Following Your League

Check the pairings for any round:

/league rounds <league name>

Shows who’s playing who in the current round, plus results for completed matches. Add a round number to look at a specific round: /league rounds Spring Swiss 2

Check the standings:

/league standings <league name>

The live leaderboard, updated after each confirmed result. Rankings are determined by:

  1. Win rate — Wins and draws, as a percentage of games played
  2. Strength of schedule — How tough your opponents were (average win rate of everyone you’ve faced)
  3. VP differential — Your total victory points scored, minus total conceded

Reporting Tournament Results

When you’ve played your league match, use:

/report-league-result

The bot guides you through it:

  1. Pick the match — If you have multiple active league matches, you’ll choose which one. If there’s only one, it skips straight ahead.
  2. Who won? — Select “I won”, “My opponent won”, or “Draw”.
  3. Enter the scores — Type the final scores (e.g. 2000-1400 or 3-1).
  4. Your opponent gets a DM — They’ll see a summary of the reported result with two buttons:
    • Confirm — Accepts the result. The standings update immediately.
    • Dispute — Flags it for a league admin to investigate.

If your opponent misses the DM (or has DMs turned off), they can confirm using:

/confirm-league-result <league name>

Auto-confirm: If a reported result goes unconfirmed for 48 hours, the bot automatically accepts it. So if your opponent doesn’t respond, it’ll sort itself out.


Getting Help

Stuck on something? The bot has a built-in support assistant ready to help.

Using the Support Command

/support <question>

Type your question in plain English — for example:

The bot will try to answer your question using its knowledge of the club rules and guides. You’ll see a response with two options:


Quick Reference — All Player Commands

CommandWhat it’s for
/lfgQueue up for a pickup game
/my-queueSee your active pickup queue entries
/leave-queueCancel all your pickup queue entries
/report-resultReport a pickup game score
/league listBrowse available leagues
/league infoSee details about a specific league
/league joinSign up for a league
/league leaveWithdraw from a league
/league roundsView pairings and results for a round
/league standingsView the league leaderboard
/report-league-resultReport your tournament match result
/confirm-league-resultConfirm a result your opponent reported
/supportAsk the bot a question or escalate to support

FAQ

Can I queue for more than one game at once? Yes! Run /lfg multiple times — you can queue for different game systems, different points levels, or different club nights.

What happens if nobody else is queued for my game system? You’ll get a DM from the bot explaining why you weren’t matched. Your entry stays active and the bot tries again at the next batch. You can also tap “Match Me With Anyone” to loosen your preferences.

What’s the “odd player out” announcement? Before each batch, the bot checks if an odd number of players are queued for each game system. If so, it posts a message in the game system’s announcement channel asking if anyone else wants to jump in. This helps avoid someone missing out.

I keep getting the same opponent every week — can the bot mix it up? Yes, it does this automatically. If you’ve played someone in the last 3 weeks, the bot skips them and looks for a different opponent. On club night itself, this rule is relaxed so that everyone gets a game, even if it means a repeat.

What if I can’t make it to the club night I queued for? Run /leave-queue to cancel your entries. You can always queue again for a different week.

How do league standings work? Players are ranked by win rate first. If that’s tied, it looks at strength of schedule (were your opponents tough, or did you have an easy draw?). If it’s still tied, it comes down to VP differential — your total points scored minus total points conceded across all your matches.

What happens if I drop out of a league mid-tournament? Your remaining opponents get automatic bye wins. Your past results still count in the standings for anyone who played against you, so dropping doesn’t invalidate the tournament.

My opponent reported a wrong score — what do I do? Hit the Dispute button on the DM confirmation, or let a league admin know. They can override any result using their admin tools.

I missed the confirmation DM — how do I confirm? Use /confirm-league-result <league name>. You can also just wait — unconfirmed results are automatically accepted after 48 hours.

What’s the difference between pickup games and leagues? Pickup games are one-off: you queue, get matched, play, done. Leagues are multi-round tournaments with standings, pairings, and a winner at the end. You can do both at the same time — they’re completely separate systems.

How do I get help if I’m stuck? Run /support followed by your question. The bot will try to answer it for you. If the answer doesn’t help, you can escalate it to the support team and someone will get back to you.