Discord bot

Scrima Discord Bot

Discord automation for PUBG scrims.

Discord operationsPUBG match linkingPublished results

Setup guild

Roles, channels and PUBG shard.

Create lobby

Name, time, maps and rules.

Open registration

Signup embed and team buttons.

Register teams

Team name, tag and roster.

Check in

Confirm teams before start.

Notify teams

Reminders when needed.

Publish lobby info

Room info to the right channel.

Track match status

Find PUBG match candidates.

Review import

Admin confirms before scoring.

Post leaderboard

Discord post with public link.

Save stats

Profiles and rankings update.

Operational runbook

One lobby state, one safe next action.

The bot shows the next safe action.

Prepare a lobby draft

Draft /admin scrim create

Creates a guild-scoped lobby shell from template or web wizard.

Missing guild settings or invalid schedule.

Registration open /admin scrim open

Posts one signup embed and links team buttons to the scrim.

No scrim channel, locked signup or invalid team rules.

Teams joining /team register or /scrim join

Stores Discord team name/tag, roster and accepted/waitlisted state.

Unverified roster, full lobby or duplicate registration.

Check-in live /admin scrim check_in + /scrim check_in

Pings accepted captains and lets each captain record `checkedInAt`.

Missing captains, no accepted teams or stale registration state.

Team reminders /admin scrim remind

Notifies accepted, waitlisted or active captains with the next lobby action.

No captains to notify, failed DMs or stale registration state.

Lobby published /admin scrim lobby

Sends custom room info to the configured lobby channel.

No host, no lobby channel or room details not ready.

Runbook review /admin scrim runbook

Summarizes current phase, next command, notifications, match status and blockers.

Missing setup, check-in gaps, host/lobby issues or unsafe publishing.

Match monitoring /admin scrim match_status

Shows PUBG candidates, confirmed/imported counts and review readiness.

Wrong mode, weak roster overlap, missing telemetry or wrong map order.

Admin review Admin web review

Confirms the correct PUBG matches before scoring becomes public.

Unconfirmed candidates or missing match/stat rows.

Results ready /admin scrim post_leaderboard

Posts leaderboard only when expected matches are imported and linked.

Missing imports, placeholder teams or unsafe public data.

Archived stats Automatic

Stores published team/player stats for profiles, rankings and scouting.

Results are unpublished, corrected or rolled back.

Discord flow blueprint

Commands, embeds and warnings for every scrim phase.

Commands, embeds and warnings stay tied to the lobby phase.

1. Create lobby /admin scrim create

Embed: Lobby created
Notification: Audit log gets a setup checklist with missing roles/channels, map rotation, start time and expected match count.
Admin warning: Block opening if the guild has no scrim channel, invalid schedule, no maps or no scoring format.

2. Open registration /admin scrim open

Embed: Registration open
Notification: Signup channel gets Register, Leave, Status and Lootspot buttons. Captains can also use /team register or /scrim join.
Admin warning: Warn if verified-team rules are enabled but teams or players are not linked to PUBG accounts.

3. Teams register /team register, /scrim join or registration button

Embed: Team registered
Notification: Captain gets accepted/waitlisted status. Admin audit shows full slots, waitlist size and duplicate roster conflicts.
Admin warning: Warn on duplicate players, missing captain, unapproved team, full lobby or placeholder-only team data.

4. Check-in /admin scrim check_in

Embed: Check-in live
Notification: Accepted captains get a check-in ping and button. Missing teams are visible in /admin scrim status.
Admin warning: Warn at T-15m if accepted teams have not checked in or waitlist promotion is available.

5. Notify teams /admin scrim remind

Embed: Scrim reminder
Notification: Accepted, waitlisted or active captains get the next action, check-in context and lobby readiness notes.
Admin warning: Warn if no matching captains can be reached, DMs fail or the lobby has stale registration data.

6. Lobby info /admin scrim lobby

Embed: Lobby info
Notification: Lobby channel gets room name, password, host, map order and captain notes in one controlled post.
Admin warning: Warn if host is not linked to a PUBG account or room info is being posted to the wrong channel.

7. Admin runbook /admin scrim runbook

Embed: Admin runbook
Notification: Admin receives current phase, next safe command, planned notifications, match status and blockers in one response.
Admin warning: Warn audit log if setup, check-in, host, lobby info, imports or publish guard are incomplete.

8. Match status /admin scrim match_status

Embed: Match found
Notification: Audit channel gets candidate matches with map, start time, roster overlap, custom mode and import confidence.
Admin warning: Block publish if matches are wrong mode, missing telemetry, wrong map order or weak roster overlap.

9. Publish results /admin scrim post_leaderboard

Embed: Results published
Notification: Results channel gets winner, top teams, top players, leaderboard image/text and public Scrima links.
Admin warning: Block public output if expected matches are missing, imports are unconfirmed or team names are not linked.

Command surface

Everything an admin needs, without spreadsheet work.

Small command set. Clear admin flow.

/admin setup ...

Save this Discord server's admin role, lobby channel, results channel, audit log and PUBG shard.

/admin settings

Show the guild's active Scrima config before a lobby is opened.

/admin template create

Save reusable lobby defaults for maps, slots, registration timing and verified-team rules.

/team create

Let captains create a team name, tag and roster linked to verified PUBG accounts.

/team submit

Send the team to admins for approval before it can join verified-team scrims.

/team register

/scrim join

Quick-register the captain's approved team for a scrim by scrim ID.

/scrim check_in

Let the captain check in an accepted team when check-in opens.

/team unregister

Remove a team from a lobby and safely promote waitlist when needed.

/team status

Show roster health, active registrations and check-in state for the captain.

/scrim list

Let captains find active lobbies, team counts, waitlist state and start time.

/scrim status

Show the public registration/check-in embed for a specific lobby without needing the original post.

/scrim leave

Remove the captain's team and promote waitlist safely when a slot opens.

/admin scrim create

Create a scrim from a template with guild defaults for region, scoring, maps and check-in.

/admin scrim open

Post the signup embed, enable Join/Leave/Lootspot buttons and start waitlist handling.

/admin scrim close

Close registration and freeze accepted/waitlisted state before lobby preparation.

/admin scrim lock_signup

Temporarily disable signup buttons while admins resolve roster or slot issues.

/admin scrim unlock_signup

Re-enable signup buttons when the lobby can safely accept team changes again.

/admin scrim remind

Notify accepted, waitlisted or active captains before check-in or lobby start.

/admin scrim check_in

Ping accepted captains with check-in instructions, a Check in button and missing-team tracking.

/admin scrim host

Assign the verified PUBG host account Scrima should track after lobby start.

/admin scrim lobby

Store and publish final PUBG custom lobby name/password to the configured channel.

/admin scrim status

Show lobby health, team counts, map rotation, next admin actions and missing setup warnings.

/admin scrim runbook

Show the current lobby phase, next safe command, planned notifications, match status and blockers in one admin view.

/admin scrim match_status

Show admin-only PUBG candidate, confirmed, imported and rejected match state.

/admin scrim post_leaderboard

Post the confirmed leaderboard only after imports are complete and team links are safe.

Discord embeds

Embeds that tell teams exactly what to do next.

Setup status

Shows this Discord server's admin roles, scrim channel, lobby channel, results channel, audit log and default PUBG shard.

Configured: live
Missing: live
Guild scoped: live

Lobby created

Admin-only checklist with start time, map rotation, slots, rules, host status and the next safest command to run.

Next action: live
Missing setup: live
Lobby ID: live

Registration open

Lobby name, start time, region, maps, team limit, scoring preview and Register Team / View Lobby buttons.

Slots open: live
Waitlist status: live
Roster requirements: live

Check-in live

Countdown, checked-in teams, missing teams and automatic waitlist promotion state.

Checked in: live
Missing: live
Promoted teams: live

Lobby info

Final team list, slots, map order, lobby rules and any private room info sent only where configured.

Accepted teams: live
Maps: live
Captain notes: live

Admin runbook

One Discord-side overview for current phase, next safe command, notification plan, match status and publish blockers.

Current phase: live
Notifications: live
Admin blockers: live

Match found

PUBG API candidate with map, start time, roster overlap, missing players and confidence score before import.

Confidence: live
Matched teams: live
Needs review: live

Results published

Winner, top teams, top players, match count, leaderboard link and public results page.

Winning team: live
Top fragger: live
Open results: live

Admin warning

Guild-scoped audit alert when status or check-in finds missing setup, host, lobby info or team readiness.

Missing setup: live
Check-in gaps: live
Publish blocked: live

Registration opens

Posts the signup embed to the configured scrim channel and keeps Join, Leave and Lootspot interactions linked to the lobby.

Team joins

Accepts teams until slots are full, moves overflow to waitlist and keeps team names/tags tied to Discord registration.

Check-in window

Pings captains, records check-in responses and posts audit warnings when accepted teams still need attention.

Lobby info posted

Sends lobby name, password, map order and captain notes only to the configured lobby channel.

Match monitor

Tracks the verified host and candidate PUBG custom matches by time window, shard, map and roster overlap.

Import warning

Alerts admins when a match has missing players, weak roster overlap, wrong mode or incomplete telemetry.

Leaderboard ready

Calculates scoring after confirmed imports and keeps unpublished data admin-only.

Results published

Posts Discord leaderboard, public results link and stores team/player stats for profiles.

Automatic notifications

The bot should warn early, not after the lobby is broken.

Guild-scoped warnings and reminders.

T-24h

Registration reminder if the lobby is not full or the scrim channel was not posted.

T-60m

Accepted captains get check-in instructions and lobby readiness status.

T-15m

Admins get warnings for missing host, missing lobby info, unverified teams or empty slots.

Match detected

Admin channel receives candidate match summary with confidence and review needs.

Publish blocked

Audit channel explains exactly why public results are not safe yet.

Results live

Results channel gets winner, top teams, top players and the public Scrima link.

Admin warning matrix

Warn before bad data reaches public pages.

Unclear imports stay private.

Missing guild setup Audit/admin channel

Admin role, lobby channel, results channel, audit log or default shard is missing.

Registration risk Scrim channel + audit

Lobby is not full, too many unverified rosters or waitlist promotion needs review.

Pre-start risk Audit/admin channel

No PUBG host, missing room info, locked signup too early or check-in is incomplete.

Import risk Audit/admin channel

PUBG candidate has weak roster overlap, wrong custom mode, missing telemetry or unexpected map order.

Publish risk Audit/admin channel

Imported results are not confirmed, team links are missing or public stats would show slot placeholders.

Public live Results channel

Results are confirmed, leaderboard is calculated and the Scrima public page is published.

Bot owns

Signups, reminders, lobby status and warnings.

Admin owns

Room info, disputes, import review and publishing.

Web UI owns

Lobby wizard, analyzer, stats and public pages.

Ops worker

Polling, telemetry and leaderboard drafts.

For organizers

Reduce manual lobby admin and keep operational decisions inside Discord.

Team registration and roster context.
Accepted/waitlisted lobby state.
Admin-only review before public publishing.

For teams

Make sure public pages show the team name, tag and roster people recognize.

Registered team names beat PUBG slot placeholders.
Player profiles can link across scrims.
Corrections happen at the registration/linking layer.

For viewers

Follow scrim results without needing access to admin channels.

Published leaderboards and match breakdowns.
Team and player profile pages.
Replay views from imported telemetry when available.

Data safety

The bot should never publish raw imports by accident.

Unconfirmed imports stay private.
Only approved results show on public pages.
Discord identity should be public only when intended by the community.