🚀 Quick Start Guide
Referee is an all-in-one Discord moderation, competitive gaming, and virtual economy bot. Designed with a clean Referee Yellow (#FEE75C) and Developer Red aesthetic, it gives servers automated enforcement, live rosters, and anti-spoofed Rocket League stats.
✨ Personal User Apps & Context Menus
Referee can be installed directly to your personal Discord user account, allowing you to use right-click message applications and personal utility commands across any DM, Group DM, or server.
| Action / Command | Context | Description |
|---|---|---|
| Apps ➔ 🟡 Issue Yellow Card | Right-Click Message | Issues an official referee caution embed on the selected message. |
| Apps ➔ 🟥 Issue Red Card | Right-Click Message | Issues a straight dismissal red card to the author with locker room penalty. |
| Apps ➔ 📌 Save to Matchbook | Right-Click Message | Bookmarks the message in your personal matchbook (viewable via /notes). |
| Apps ➔ 📊 Message Text Stats | Right-Click Message | Analyzes word count, character count, line breaks, and attachments. |
| /notes [view|clear] | User App & DM | Manage your personal saved bookmarks and quotes. |
| /flip, /roll, /decide | User App & DM | Fast referee decision-makers, coin toss, and dice roller. |
🏎️ Rocket League & Anti-Spoof Verification
Look up competitive ranks, divisions, MMR ratings, win streaks, and lifetime stats across Epic Games, Steam, PlayStation, Xbox, and Nintendo Switch.
| Command | Parameters | Description |
|---|---|---|
| /rl | [player] [platform] | Pulls competitive dossier with 2v2, 3v3, 1v1 ranks, and streak badges. |
| /rl_link | [player] [platform] | Opens the Swift7 Account Portal to verify your Epic ID. |
| /duel challenge | <member> <wager> [mode] | Challenges another player to a 1v1 Rocket League or Freestyle match with coin escrow! |
| /duel report | <winner> | Both players confirm the match outcome to release the prize pool to the champion. |
| /duel resolve | <winner> | Administrator Force resolve a disputed duel and distribute prize coins. |
🛡️ Anti-Spoofing Verification: Log in at swift7.wuaze.com/login with Discord Connections enabled. Discord cryptographically verifies ownership of your Epic Games account so nobody can fake their rank on the pitch.
🏆 Tournament Director & Live Brackets
Run persistent single-elimination Rocket League events with mobile-friendly registration, captain check-ins, seeded brackets, verified score reporting, evidence links, disputes, staff resolutions, automatic advancement, and champion rewards. Public spectators can follow every event on the Swift7 live bracket page.
| Command | Who | Purpose |
|---|---|---|
| /tournament create | Server manager | Open registration and publish persistent Join, Check In, and Live Bracket buttons. |
| /tournament join | Captain | Register a named team or squad for an open event. |
| /tournament checkin | Captain | Confirm readiness from Discord on desktop or mobile. |
| /tournament start | Organizer | Lock entrants, optionally remove no-shows, seed teams, and generate the bracket. |
| /tournament report | Match captain | Submit the Team A-Team B score with an optional screenshot or replay URL. |
| /tournament confirm | Opponent | Verify the report and advance the winner automatically. |
| /tournament dispute | Captain | Freeze a disputed match with a reason and optional evidence. |
| /tournament resolve | Organizer / manager | Issue the final staff ruling and resume bracket progression. |
| /tournament bracket | Everyone | View live matchups, pending confirmations, disputes, and the champion. |
🏆 Live Match Predictions & Pool Wagering
Launch interactive match prediction pools with live countdown timers and automated pool payouts.
| Command | Permission | Description |
|---|---|---|
| /prediction create | Administrator | Creates a live match prediction pool with Option A and Option B voting buttons. |
| /prediction bet | Anyone | Wagers coins from your wallet on Option A or Option B. |
| /prediction end | Administrator | Resolves the winner, calculates proportional odds, and pays all winning voters automatically! |
🪙 Server Economy & Virtual Betting
A complete server currency system with bank vaults, daily streak multipliers, pitch shifts, interactive casino minigames, and a server shop.
| Command | Usage | Description |
|---|---|---|
| /balance | [member] | Check wallet balance, bank vault coins, and net worth. |
| /daily | None | Claim 500 base coins + (50 * streak) daily login bonus. |
| /work | None | Complete a 10-minute pitch shift (Refereeing, Goalkeeping, Clip Editing). |
| /pay | <member> <amount> | Send coins directly to another server member. |
| /deposit, /withdraw | <amount|all> | Transfer coins between wallet and secure bank vault. |
| /blackjack | <bet> | Play interactive Blackjack with Hit, Stand, and Double Down buttons. |
| /slots | <bet> | 3-reel Rocket League slot machine with multipliers up to 20x. |
| /gamble | <bet> [heads|tails] | 50/50 Double-or-Nothing coinflip. |
| /shop, /buy, /inventory | <item_id> | Browse and purchase collectibles, VIP badges, and XP boosters. |
| /quests, /quests_claim | None | Track 3 daily challenges (Chatting, Casino, LFG) and claim bonus coin rewards + Daily Master Bonus! |
| /give_coins | <member> <amount> | Administrator Grant coins directly to a member's wallet for testing. |
| /richest | None | Top 10 server wealth leaderboard (also synced to web leaderboard). |
🎵 Scrim Music & 24/7 Gaming Radio
Stream music directly into your voice channel during scrims and matches, or tune into 24/7 low-latency gaming radio stations.
| Command | Usage | Description |
|---|---|---|
| /play | <query> | Search & play any song from YouTube, SoundCloud, or direct audio link. |
| /radio | <station> | Stream 24/7 radio stations (lofi, edm_gaming, synthwave, rock_energy). |
| /pause, /resume | None | Pause or resume audio playback. |
| /skip | None | Skip to the next song in the queue. |
| /stop | None | Stop music, clear queue, and disconnect from voice. |
| /queue | None | View currently playing track and upcoming playlist. |
| /volume | <1-100> | Adjust playback volume level. |
🎬 Community Clips & Freestyle Vault
Submit Rocket League gameplay clips and earn community recognition.
| Command | Description |
|---|---|
| /clip submit <url> <title> [category] | Upload a clip (YouTube, Medal, Twitch, TikTok, Streamable). 3+ approved clips auto-awards the Comp Clip Hitter or Freestyler role! |
| /clip list [category] | Browse recent community submissions directly in Discord. |
🍯 Persistent Anti-Raid Honeypot
Referee can deploy a clearly labeled, public tripwire channel that raid accounts and compromised users reveal themselves by using. Any non-exempt account that sends a message or presses the persistent warning button is recorded, its message is removed when possible, and the configured response is applied. Core honeypot protection is free for every server.
| Command | Permission | Action |
|---|---|---|
| /honeypot setup <channel> <log_channel> [action] [timeout_minutes] | Manage Server + sanction permission | Arms the trap with log_only, timeout, kick, or ban. The trap must be reachable by @everyone, while the separate staff log must be hidden from @everyone. |
| /honeypot status | Manage Server | Shows the armed state, trap and private-log channels, enforcement action, timeout length, trusted roles, total triggers, and latest trigger. |
| /honeypot exempt_role <add|remove> <role> | Manage Server | Maintains up to 25 trusted human or bot roles. This can exempt a legitimate integration through its managed bot role without exempting every bot automatically. |
| /honeypot disable | Manage Server | Disarms enforcement and retires the active panel button without deleting the channel or its trigger history. |
log_only, exempt every legitimate bot or trusted role that could post in the trap, verify private alerts, and only then move to timeout, kick, or ban. Keep the warning panel intact so legitimate members are never tricked into interacting.
⚖️ Moderation & 3-Strike Escalation
Fast, fair moderation tools with automatic disciplinary escalation, strict user and bot permission checks, role-hierarchy safety, Discord audit reasons, and persistent numbered case records. Core moderation remains free for every server.
| Command | Permission | Action |
|---|---|---|
| /warn <member> <reason> | Moderate Members | Strike 1: Logged • Strike 2: 1h Timeout • Strike 3: 24h Timeout • Strike 4: Ban. |
| /warnings [member] | Anyone | View infraction history and active disciplinary strikes. |
| /removewarn <member> <number> [reason] | Moderate Members | Remove one warning after staff review while preserving the rest of the member's history. |
| /clearwarns <member> [reason] | Administrator | Pardon all warning strikes for a member and record the review as a case. |
| /kick, /ban | Kick/Ban Members | Direct server expulsion with DM notice. |
| /timeout, /untimeout | Moderate Members | Mute a member for a specified duration in minutes. |
| /purge <amount> | Manage Messages | Bulk delete up to 100 messages with optional user filter. |
| /slowmode <seconds> | Manage Channels | Set channel slowmode cooldown. |
| /mod unban, /mod softban | Ban Members | Revoke a ban by user ID or remove a member while clearing up to seven days of messages and immediately reopening re-entry. |
| /mod ban_id | Ban Members | Ban a Discord user by ID even after they leave, while still enforcing hierarchy checks when they remain in the server. |
| /mod tempban, /mod tempbans | Ban Members | Schedule an automatic ban expiry from one hour to one year and inspect all active schedules. Expiries persist across restarts. |
| /mod nickname | Manage Nicknames | Change or reset a member's server nickname with moderator and bot hierarchy protection. |
| /mod role_add, /mod role_remove | Manage Roles | Add or remove non-integrated roles only when the role and target are below both the moderator and Referee. |
| /mod move, /mod disconnect | Move Members | Move a member between voice channels or disconnect them from voice. |
| /mod voice_mute, /mod voice_deafen | Mute/Deafen Members | Apply or remove Discord server mute and deafen states while enforcing moderator and bot hierarchy. |
| /mod clean | Manage Messages | Scan up to 200 recent messages and filter by member, bots, links, attachments, embeds, or matching text. |
| /mod channel_hide, /mod channel_reveal | Manage Channels + Roles | Hide a channel from @everyone while preserving the exact previous overwrite, then restore it safely later. |
| /mod note, /mod history, /mod case, /mod reason | Moderate Members | Add private staff notes, inspect recent or member-specific cases, open a numbered case, and audit a corrected reason. |
| /mod case_evidence, /mod case_status | Moderate Members | Attach up to three private evidence links or Discord files, then open or close the case with an attributed resolution. |
🎖️ Leveling & Toggleable Role Rewards
Chat XP progression system with customizable level milestones and toggleable auto-role rewards upon level up.
| Command | Permission | Description |
|---|---|---|
| /rank [member] | Anyone | Checks chat level, total XP, server rank card, and progress bar. |
| /leveling toggle_rewards | Administrator | Toggles auto-role milestone rewards ON or OFF across the server. |
| /leveling add_role | Administrator | Assigns a role reward to a level milestone (e.g. Level 5 ➔ Bronze Member). |
| /leveling list_roles | Anyone | Displays all configured level milestones and reward roles. |
👑 Live Staff Directory
Auto-updating Discord directory embed that dynamically reflects role assignments and roster changes.
| Command | Description |
|---|---|
| /staff post <channel> | Deploys the live auto-updating staff directory into a designated channel. |
| /staff add_role <role> [title] | Adds a role category (e.g. 👑 Owner, 🛡️ Admins, 🎨 Creators). |
| /staff remove_role <role> | Removes a tracked role from the live directory. |
| /staff refresh | Forces an instant re-scan and embed update. |
🤖 Auto-Responder & Channel Reactions
Set automated responses to custom player keyword triggers and automatic channel reaction emojis.
| Command | Description |
|---|---|
| /autoresponder add <trigger> <reply> | Adds a keyword response (e.g. gg ➔ GG! Well played on the pitch. ⚽). |
| /autoresponder list | View all active server keyword triggers. |
| /autoresponder autoreact_channel <channel> <emojis> | Automatically reacts with emojis on every new message in a channel. |
⏰ Scheduled Visual Announcements
Automated background broadcaster that schedules announcement embeds to post at future times.
| Command | Permission | Description |
|---|---|---|
| /schedule add | Administrator | Schedules a visual embed broadcast with minutes delay and optional role mention. |
| /schedule list | Administrator | Lists all pending scheduled broadcasts. |
| /schedule cancel <id> | Administrator | Cancels a pending scheduled broadcast. |
📡 Cloud REST API Reference
The Referee Bot web service runs on port 10000 on Render and exposes standard JSON endpoints with CORS support: