Server Admin Guide

Thanks for setting up The Muster for your club! This guide covers everything you need — from the initial setup to managing game systems, subscriptions, and keeping matchmaking running smoothly.

You’ll need the Manage Server permission (or the configured admin role) to use these commands. If you’re setting things up for the first time, we’ll have you sorted in just a few minutes.

Getting Started

Initial Setup

When you first add The Muster to your server, run the setup command to get everything configured:

You will be asked to provide:

• club_night_day — The day of the week for your club night (choices: Monday through Sunday)
• club_night_time — The start time for club night games (e.g. 7:30 PM, 18:30)
• timezone (optional) — Your server timezone (defaults to Europe/London)

This does several things automatically:

• Registers your server with The Muster
• Seeds the standard game systems (Warhammer 40k, Age of Sigmar, and Kill Team) with their common points breakpoints
• Activates a 14-day free trial of the Captain tier, giving you full access to all features while you get set up

Once you’ve added your game systems and completed the wizard steps, you’ll see a final confirmation:

You only need to run this once. If you run it again, it’ll let you know the server is already configured.

Setting the Admin Role

Want to give other trusted members admin access without sharing the full Manage Server permission? You can delegate it to a specific role:

/muster-admin configure set-admin-role @role

For example, if you have a “League Admin” or “Club Organiser” role, assign it here. Anyone with that role will be able to use all /muster-admin and /league-admin commands.

When to use this: Right after setup. Pick a role that your tournament organisers and club managers already have.

Configuring Bot Settings

Want to tweak things? You can view and update your server’s settings at any time:

• View current configuration:

  /muster-admin configure show
  

  Displays your current batch times, timezone, target weeks ahead, club night schedule, game tags, and message templates.

• Update scheduling and timezone settings:

  /muster-admin configure set-scheduling [batch_times] [batch_time_tz] [days_ahead] [club_night_day] [club_night_time] [batch_results_day]
  

  Modify specific scheduling rules (e.g. set timezone to America/New_York or change the club night day).

• Update game play-style tags:

  /muster-admin configure set-tags <tags>
  

  Provide a comma-separated list of tags (e.g., casual,competitive,learner).

• Update automated DM message templates:

  /muster-admin configure set-message <key> <value>
  

  Customize the text players receive when matched, deferred, unmatched, or when confirming their queue status.

Managing Game Systems

Before players can queue for games, your server needs game systems configured. The setup command adds the common ones automatically, but you can add more whenever you like.

Adding a New Game System

/muster-admin add-game

The bot asks you for:

• Name — The full name, e.g. “Warhammer 40k” or “Kill Team”
• Abbreviation — A short code, e.g. “40k” or “KT”
• Points breakpoints — The common points levels for that system, separated by spaces. For example: 500 1000 1500 2000. Players choose from these when they queue.
• Channel (optional) — A channel where the bot posts “odd player out” warnings (more on this below)
• Role (optional) — A Discord role to ping in those warnings

Players will see the new system in /lfg straight away — no restart needed.

When to use this: When your club starts playing a new game system, or if you want to add a variant (e.g. “40k Combat Patrol” alongside “Warhammer 40k”).

Note: The number of active game systems depends on your subscription tier. The free Recruit tier allows 1 system. See the Subscription Tiers section for details.

Updating Announcements for an Existing System

Forgot to set a channel or role when you added a game? Or want to change it?

/muster-admin set-announcement <game system> [channel] [role]

• Set just a channel, just a role, or both
• Leave both blank to clear the announcement config entirely
• The game system name isn’t case-sensitive — “warhammer 40k” and “Warhammer 40K” both work

When to use this: When you add a new announcement channel, or want to change which role gets pinged.

Checking Queue Activity

Wondering how many games are lined up? Take a look:

Shows you a breakdown of who’s currently queued, organised by game system and target club night. Useful for getting a feel for how active things are, or spotting systems that might need a nudge.

When to use this: Before club night, to see how many games are lined up. Or anytime you’re curious about activity levels.

Subscription Tiers

The Muster uses a simple tiered subscription model. Every server starts with a 14-day free trial of the Captain tier — so you can try everything before deciding what works for your club.

Tier Comparison

• Recruit is the free tier you’ll be on after your trial ends (or if you cancel). You keep one game system and basic matchmaking for up to 10 players — still useful for smaller clubs!
• Sergeant unlocks unlimited game systems and raises your player cap to 40. A great fit for medium-sized clubs.
• Captain gives you the full works — unlimited systems, unlimited players, and the complete league and tournament system. Perfect for clubs running structured seasons.

Checking Your Subscription Status

To see your current subscription tier, days remaining on your trial, and your active player counts against limits, use:

Managing Your Subscription

This sends you a DM with secure payment links for the Sergeant and Captain tiers. Payment is handled through Stripe — the bot never sees your card details.

Once payment completes, your server is upgraded instantly. If you cancel, you’ll drop to Recruit at the end of your billing period.

Trial expiring? The bot sends a DM warning 7 days before your trial ends. If you don’t subscribe, you’ll be moved to the Recruit tier and any extra game systems beyond the first will be deactivated.

How Pickup Matchmaking Works

Ever wondered how the bot decides who plays who? Here’s a look under the hood so you can answer player questions and troubleshoot if needed.

The Daily Batch

The bot runs its matchmaking batch on a regular schedule. Here’s what happens for each game system and club night:

1. Lines up all queued players in order (first come, first served)
2. Tries to pair each player with a compatible opponent — same system, overlapping points, shared play style tag, same club night
3. Skips anyone the player has already faced in the last 3 weeks (for variety)
4. Sends DMs to matched players with the details
5. Sends DMs to unmatched players explaining why, with buttons to adjust their entry

The Odd-Player-Out Warning

Nobody wants to turn up to club night with no game! Before each batch, the bot checks if an odd number of players are queued. If so, it posts a message in that system’s announcement channel — tagging the configured role — to see if anyone else can jump in.

This only works if you’ve set an announcement channel for the game system. If there’s no channel, the check is silently skipped.

Special Rules

• On club night itself: The 3-week repeat-opponent rule is relaxed. Everyone gets a game, even if it means a rematch.
• Deferred players: If someone isn’t matched before club night, they get one more day automatically. The bot tries again at the next batch before the entry expires.

Player Capacity

How many players can take part in matchmaking on a given club night depends on your subscription tier:

“Active players” means the total number of unique players who are either queued or have a pending match on any given club night. If the cap is reached, new /lfg entries will be blocked with a message suggesting the server admin upgrade.

Quick Reference — All Server Admin Commands

Server Configuration (/muster-admin)

Need to manage leagues? Tournament commands live in /league-admin. Head over to the League Admin Guide for the full rundown.

FAQ

What role do I need to use server admin commands? You need the Manage Server permission, or the admin role configured via /muster-admin configure set-admin-role.

What happens during initial setup? /muster-admin setup registers your server, configures your club night schedule, seeds Warhammer 40k, Age of Sigmar, and Kill Team as game systems, and activates a 14-day Captain free trial.

Can I run setup more than once? Yes, but it won’t do anything if the server is already configured. It’s safe to re-run.

How do I add a game system that isn’t Warhammer? Use /muster-admin add-game and fill in the name, abbreviation, and points breakpoints. You can add any tabletop game — it doesn’t have to be Games Workshop.

I’ve hit the game system limit — what do I do? The free Recruit tier only allows 1 game system. Upgrade to Sergeant or Captain using /muster-admin subscribe to unlock unlimited systems.

How do I set up odd-player-out announcements? When adding a game system with /muster-admin add-game, set the announcement channel and role. Or update an existing system with /muster-admin set-announcement. The bot does the rest.

Can players adjust their own queue entries without leaving and re-queuing? Yes — when they get an “unmatched” DM, it includes buttons to adjust their points or tags directly. No need to leave the queue and start over.

A player says they didn’t get a DM — what happened? They probably have DMs from server members turned off in their Discord privacy settings. The bot can’t override this.

What happens when our trial expires? You’ll be moved to the Recruit tier. Extra game systems beyond the first are deactivated, the player cap drops to 10, and leagues are disabled. You can upgrade at any time with /muster-admin subscribe.

Can I change the admin role after setting it? Yes, just run /muster-admin configure set-admin-role @new-role again. The old role loses access and the new one takes over.

What’s the difference between server admin and league admin? Server admins manage the bot installation — game systems, subscriptions, and server-wide settings. League admins manage individual tournaments — creating leagues, advancing rounds, resolving disputes. They use different command groups (/muster-admin vs /league-admin), but the same Discord role grants access to both.