Egg Shen Bot

Appearance

Commands Overview ​

Egg Shen Bot provides comprehensive slash commands for searching entertainment media, hosting watch parties, and managing your server's settings. All commands use Discord's native slash command interface for easy discovery and autocomplete.

Quick FAQ ​

Q: Why don't I see all the commands?
A: Commands appear based on configured API keys. Missing APIs = those commands won't show up.

Q: How do I use slash commands?
A: Type / in Discord and start typing the command name. Discord will show autocomplete options.

Q: Can I restrict who uses certain commands?
A: Yes! Use Discord's built-in command permissions system or configure per-command restrictions via /eggshen-config.

Q: Do commands work in DMs?
A: Most search commands work in DMs. Server-specific features (timers, watch history, config) require a server.

Q: What happens if a movie/show isn't found?
A: The bot will show a "not found" message. Try different spelling, year, or check TMDB to see if it exists.

Commands Overview ​

Egg Shen Bot provides comprehensive slash commands for searching media, hosting watch parties, and server management.

Search Commands ​

/movie ​

Search for movies with comprehensive ratings and links.

Options:

  • query (required) - Movie title to search for
  • private - Only show the result to you (default: false)

Features:

  • Ratings from IMDb, Letterboxd, Trakt, Rotten Tomatoes
  • Streaming availability via JustWatch
  • Release date, runtime, genres
  • Overview and poster
  • Configurable services per server

Example:

/movie query:The Matrix

Learn more →

/tv ​

Search for TV shows with ratings and episode information.

Options:

  • query (required) - TV show title to search for (optionally include an episode name)
  • private - Only show the result to you (default: false)

Features:

  • Similar to movies but for TV shows
  • Episode count and season information
  • First air date and status (ongoing/ended)
  • Network information

Example:

/tv query:Breaking Bad

Learn more →

/episode ​

Search for specific TV show episodes.

Options:

  • show (required) - TV show name
  • episode (required) - Episode title (e.g. Sandkings) or number (e.g. s3e11, 3x11)
  • private - Only show the result to you (default: false)

Features:

  • Episode-specific ratings
  • Air date
  • Episode title and overview
  • Still image from the episode

Example:

/episode show:The Last of Us episode:s1e1

Learn more →

/episode-list ​

View all episodes from a complete season.

Options:

  • series (required) - TV series name
  • season (required) - Season number
  • private - Only show the result to you (default: false)

Features:

  • Compact multi-column layout
  • Clickable IMDb links for each episode
  • Air dates and ratings
  • Handles large seasons efficiently

Example:

/episode-list series:Breaking Bad season:5

Learn more →

/game ​

Search for video games or board games.

Options:

  • query (required) - Game title to search for
  • private - Only show the result to you (default: false)

Features:

  • Video game support via RAWG API
  • Board game support via BoardGameGeek
  • Metacritic scores
  • Platform information
  • Release dates

Example:

/game query:The Last of Us
/game query:Wingspan

Learn more →

/book ​

Search for books with comprehensive information.

Options:

  • query (required) - Book title or author to search for

Features:

  • Google Books integration
  • Author information
  • ISBN-13 and ISBN-10
  • Page counts and publication dates
  • Ratings from Google Books
  • Categories and genres
  • Preview and purchase links
  • Links to Goodreads and Open Library

Example:

/book query:Clive Barker Books of Blood

Learn more →

Tournament Commands ​

/escape ​

Escape Velocity: a multi-day movie and TV genre trivia event in the style of Who Wants to Be a Millionaire?. Climb 15 stages to reach orbit, with one launch a day and your best run counting. Admins run events with /escape-setup.

Learn more →

/bracket ​

Host comprehensive tournaments for movies, TV shows, video games, board games, or books.

Key Subcommands:

  • help - 🆕 Comprehensive tournament guide (All members)
  • create - Create new tournament (Admin/Mod)
  • setup-link - Private link to the web setup form: upload a CSV/JSON file or fill it in (Admin/Mod)
  • manage-titles - Add or remove titles from groups (Admin/Mod)
  • open - 🆕 Smart: Auto-opens next round based on phase (Admin/Mod)
  • close - 🆕 Smart: Auto-closes current round and advances (Admin/Mod)
  • open-groups - Open specific groups for voting (Admin/Mod)
  • close-groups - Close specific groups (Admin/Mod)
  • resolve-tiebreaker - 🆕 Manually resolve ties (Admin/Mod)
  • open-matchup - Open specific matchup(s) (Admin/Mod)
  • close-matchup - Close specific matchup(s) (Admin/Mod)
  • status - View tournament progress (All members)
  • my-votes - View your voting history (All members)
  • view - Generate visual bracket image (All members)
  • export - Export results as JSON/Markdown (All members)
  • cancel - Cancel tournament (Admin/Mod)

Features:

  • Button-based voting: No commands needed - just click to vote!
  • Smart phase detection: Commands automatically detect tournament phase
  • Automatic tiebreakers: Creates short voting rounds when ties occur
  • Valid tournament sizes: 2, 4, 8, 16, 32 (bracket mode) or 36, 40, 44, 48 (group mode)
  • Auto-detection: Bot automatically chooses bracket or group mode based on size
  • Group stage: Members vote for top 2 per group via buttons
  • Dynamic wildcards: Auto-calculated to reach power-of-2 bracket
  • 4-region knockout bracket (March Madness style)
  • Visual bracket display with live vote counts
  • Live standings with vote bars that update as votes come in, drawn with the bot's own emoji once they're uploaded
  • Complete vote tracking and history

Example:

/bracket help
/bracket-setup create name:Horror Movie Madness max-titles:32
/bracket-setup manage-titles action:add group:A type:movie
/bracket open duration:24h
/bracket close tiebreaker-duration:30m
/bracket status
/bracket view

Learn more →

Watch Party Commands ​

/timer ​

Start, stop, or check channel-specific timers.

Subcommands:

  • /timer start - Start a timer in the current channel
  • /timer pause - Pause the active timer, freezing elapsed/remaining time
  • /timer resume - Resume a paused timer
  • /timer stop - Stop the active timer
  • /timer adjust - Change the active timer's total duration
  • /timer autostop - Enable or disable auto-stop for the active timer
  • /timer status (alias: /timer check) - Check timer status; private to you by default, public:true to announce it to the channel
  • /timer remind - Announce timer is starting (with event auto-detection)

Features:

  • Auto-stop timers: Set duration (1-1440 min); by default a real duration always runs for its full length, with an optional per-server ceiling admins/mods can turn on
  • No-duration fallback: If a timer starts with no duration at all (nothing typed, nothing detected), it defaults to 6 hours (configurable) instead of running forever
  • Expiry warning: ~1 hour before a no-duration-fallback timer auto-stops, the bot posts a channel warning with a button to extend it (never fires for timers with a real duration)
  • Runtime auto-detection: Searches movies, TV shows, and board games and adds a 10-min buffer — works whether the label was typed manually or auto-detected
  • Smart selection: Shows menu when multiple matches are found
  • Auto-detects Discord scheduled events
  • Optional custom labels
  • One timer per channel
  • Persists across bot restarts
  • Watch history integration

Example:

/timer remind message:Everyone ready? role:@Movie Night
/timer start label:Movie Night duration:120
/timer stop
/timer status

Learn more →

/watched ​

Log and view server watch party history.

Subcommands:

  • /watched add - Manually log a watch party (options: title, notes, private — keep the confirmation to yourself instead of posting it to the channel, default: false)
  • /watched history - View server watch history (options: filter — all, movie, tv; limit — 1-25, default 10)

Features:

  • Server-level watch tracking
  • Channel tracking
  • Notes support
  • Frequency tracking
  • Filter by type (movies/TV)

Example:

/watched add title:Hereditary notes:Annual horror night!
/watched history filter:movie limit:20

Learn more →

/announce party ​

Post an advance watch party announcement to a channel (Admin/Moderator only).

Options:

  • title1 (required) - First movie or TV show title
  • time (required) - Start time to include in the announcement (e.g. "8:00 PM EST")
  • message (optional) - Your own text, posted exactly as written. Skips AI entirely
  • channel (optional) - Where to post it (default: the current channel)
  • role (optional) - Role to ping, in the message content so it actually notifies
  • episodes1 (optional) - Episode(s) for title1 if it's a TV show (e.g. "S3E9-E12", "Season 3 Episode 9")
  • title2 / episodes2 (optional) - A second title, for back-to-back watch parties
  • host (optional) - Who's hosting — a name, persona, or @mention
  • tone (optional) - Funny, Scary, Dramatic, Wholesome, or Mysterious. AI-written text only
  • custom-tone (optional) - Free-text tone/style instead of the preset list — overrides tone

Features:

  • Your own message always posts verbatim; AI only writes the text when you don't supply one and the server has AI text enabled
  • Looks up the real plot/premise from TMDB so AI-written text is about the actual movie/show, not generic filler
  • Includes real streaming availability ("Available to stream on...") automatically
  • Verifies it can post in the target channel before claiming success
  • Falls back to a plain (non-AI) template when AI is off or unavailable

Example:

/announce party title1:"Tales From the Crypt" episodes1:"S3E9-E12" title2:"Hellraiser" time:"8:00 PM EST" host:"Cryptkeeper" tone:Scary

Learn more →

/announce starting ​

Post the "starting in 10 minutes" nudge to a channel (Admin/Moderator only).

Options:

  • message (required) - e.g. "Starting in 10 minutes" or "Starting at 9:35 pm". Always posted exactly as written
  • title (optional) - What's being watched, which adds the artwork
  • channel (optional) - Where to post it (default: the current channel)
  • role (optional) - Role to ping, in the message content

Example:

/announce starting message:"Starting in 10 minutes" title:"Hellraiser" role:@Movie Night

Learn more →

/announce schedule ​

Post the full watch-party card automatically, a set time before one of the server's scheduled events (Admin/Moderator only). It moves if the event moves and is cancelled with it.

Options:

  • event (required) - Start typing to pick an upcoming event
  • hours (required) and minutes (optional) - How long before the start to post
  • channel (optional) - Where to post it (default: the current channel)
  • role, message, title1, episodes1, title2, host (optional) - As for /announce party. title1 is for when the event's name isn't the title

/announce scheduled lists what's waiting to post, with a Cancel button for each.

Every scheduled event also gets a short "starting soon" card in its own channel 10 minutes before it starts, automatically.

Example:

/announce schedule event:Night of the Living Dead hours:2 channel:#announcements role:@Movie Night

Learn more →

AI Image Generation Commands ​

/image ​

Generate AI images: freeform, from a Discord message, a "versus" battle between two titles, or a persona of a server member — all in one command.

Options:

  • prompt - Describe the image to generate (or add extra style detail alongside title1/title2 or matchup)
  • message - Username or message ID to generate from
  • title1 / title2 - Two titles for a versus battle image (movie, TV, game, board game, book) — provide both together
  • matchup - Generate from an active tournament matchup instead of searching (e.g., "The Thing vs Alien")
  • user - Imagine a member from their profile details (name, roles, colors, the titles they look up), never their avatar. Needs prompt
  • private - Only show the generated image to you instead of the whole channel (default: false)

Features:

  • Text-to-image generation, generate-from-message, versus-battle, and member-persona modes
  • Smart search validation across TMDB, RAWG, BGG, and Google Books for versus mode
  • Cross-type comparisons (movies vs games, etc.)
  • Square format (1024x1024) for freeform/message mode; wide format (1792x1024) for versus mode
  • Rate limited (5-min cooldown, 10/day per user, 50/day per server)
  • Whitelisting for unlimited users
  • Cost: $0.04 per image

Examples:

/image prompt:A dragon flying over a medieval castle at sunset
/image message:username
/image title1:Godzilla title2:King Kong
/image title1:Alien title2:The Thing prompt:in deep space
/image matchup:1A
/image user:@Doug prompt:a Lego minifig version of them

Learn more →

Utility Commands ​

/random ​

Get random movie, TV show, episode, game, board game, or book with filters.

Subcommands:

  • /random movie - Random movie with genre/decade/rating/streaming filters
  • /random tv - Random TV show with genre/decade/rating/streaming filters
  • /random episode - Random episode from a specific show
  • /random game - Random video game with genre/platform/rating filters
  • /random boardgame - Random board game with category/rating filters
  • /random book - Random book with subject/decade/rating filters

Streaming filter: streaming (movie and tv) limits the pick to titles on the services you name, in the server's streaming region (/eggshen-config settings region). Separate several with commas — Shudder, Tubi means on either. Start typing to see the services available. A service includes its Amazon, Apple TV and Roku channel versions, so Shudder also finds what's on Shudder through Prime Video.

Example:

/random movie genre:horror min-rating:7
/random movie genre:horror streaming:Shudder, Tubi TV
/random book subject:horror decade:1980s

/recommend ​

Suggests what to watch next based on what this server has actually watched.

Every option is optional — a bare /recommend works. Combine as many or as few as you like.

OptionWhat it does
typeMovies or TV shows (default: both)
sourceWhere picks come from (default: your watch history)
genreAutocompleted from TMDB's live genre list
decade1950s through 2020s
directorAutocompleted; ranks directors ahead of same-named actors
privateShow the result only to you

Sources:

  • Watch History (default) — finds titles similar to what the server watches most, skips anything already seen, and ranks them for tonal fit
  • Most Watched — what this server rewatches. Until something has been watched twice, it shows recent watches instead and says so, rather than presenting an arbitrary order as a ranking
  • Discover — browses TMDB by filter. The default on a server with no watch history yet

Examples:

/recommend
/recommend type:tv genre:Comedy
/recommend source:most-watched type:movie
/recommend director:John Carpenter decade:1980s

Results link to IMDb, and to Letterboxd for movies. When AI is configured, each pick includes a one-line reason referencing titles the server actually watched; without it, picks are ranked by popularity and similarity instead. The footer tells you which.

Genres differ between movies and TV

TMDB has no Horror or Romance category for television, so those won't appear when type:tv is set. Autocomplete only ever offers genres that can actually return results.

/similar ​

Find similar content recommendations.

Options:

  • title (required) - Title to find similar content for
  • type (optional) - movie, tv, game, boardgame, or book (searches all if not specified)

Example:

/similar title:The Matrix type:movie
/similar title:Dracula type:book

/eggshen-ask ​

Ask how to do something in plain words, and get the exact commands to run, answered from this documentation. Private unless you add public:true. See Ask the Bot.

Example:

/eggshen-ask question:how do I run a tournament one matchup at a time?

/eggshen-help ​

Display comprehensive bot help with complete command list — tailored to what's actually enabled on the server it's run in.

Features:

  • Overview of all bot commands organized by category
  • Guild-aware: only shows commands your server has enabled. If an admin disables /game via /eggshen-config commands toggle, it disappears from your help list too — no more listing commands that will just reply "disabled" if you try them
  • A category only disappears entirely if every command in it is disabled; otherwise it stays with just the remaining enabled commands
  • Movies & TV Shows: movie, tv, episode, episode-list, similar, watched
  • Games & Entertainment: game, boardgame, book, soundtrack
  • Random & Discovery: random with filters
  • Tournaments & Polls: bracket, survey, escape
  • AI Image Generation: image
  • Fun & Games: potion, foodfight, doom, rescue, siege, scoreboard, leaderboard, how-to-play
  • Watch Party Tools: timer, watchparty, stats
  • Admin commands shown conditionally for moderators
  • Links to full documentation at eggshenbot.com
  • Tips for command-specific help (e.g., /bracket help)

Example:

/eggshen-help

Pro Tip: Some complex commands have their own help subcommands:

  • /bracket help - Tournament system guide
  • Use these for detailed, context-specific guidance!

/soundtrack ​

Search for movie and TV show soundtracks with iTunes and Spotify integration.

Options:

  • query (required) - Movie or TV show title to find soundtrack for
  • private (optional) - Only show the result to you instead of the whole channel (default: false)

Features:

  • TMDB title verification for accurate matching
  • iTunes Search API integration (no API key required)
  • Spotify API integration (optional - shows both platforms when configured)
  • Album artwork and metadata display
  • Artist/composer information
  • Track count and release dates
  • Price information and purchase links (iTunes)
  • Direct links to iTunes and Spotify for streaming
  • Supports both movies and TV shows

Examples:

/soundtrack query:The Matrix
/soundtrack query:Breaking Bad
/soundtrack query:Interstellar

How It Works:

  1. Search for movie or TV show title
  2. Select correct title from TMDB results
  3. Bot searches iTunes for soundtrack
  4. Displays soundtrack details with purchase links

Fun & Social Commands ​

/survey ​

Create interactive polls and surveys with up to 10 options and real-time vote tracking.

Subcommands:

  • /survey create - Create a new survey with up to 10 options. A tie for first starts a runoff vote, then a random pick (tie-break:None to let a tie stand)
  • /survey list - View all surveys (active, closed, or all)
  • /survey results - View detailed results with progress bars
  • /survey voting-post - Post an open survey again at the bottom of the channel, with its vote buttons and the votes so far. The old card greys out and links to the new one. Anyone can use it; members once every 10 minutes per survey, the creator and admins any time. Leave out poll_id when only one survey is open
  • /survey close - End voting and show final results (creator/admin/mod only)
  • /survey delete - Permanently delete a survey (creator/admin/mod only)

Features:

  • Up to 10 options per survey
  • Single or multiple vote modes
  • Vote with buttons; the card updates its progress bars with every vote
  • Permission system for management
  • Persistent storage across bot restarts
  • Configurable per-server

Examples:

/survey create question:"What should we watch tonight?" option1:"Horror" option2:"Comedy" option3:"Action"
/survey list filter:active
/survey results poll_id:a1b2c3d4e5f6g7h8
/survey voting-post
/survey close poll_id:a1b2c3d4e5f6g7h8

Learn more →

/potion ​

Give magical potions with fun pop culture references, to a member, a whole role, or @everyone.

Options:

  • user (required) - Who gets it: a member, a role, or @everyone. A role or @everyone is shown but not pinged
  • type (required) - Type of potion (Health, Mana, Strength, Speed, Invisibility, Luck, Confusion, Love, Poison, Energy, Weakness, Curse, Slow)
  • item (optional) - An item from your Glovebox. Only 🍀 Lucky Penny fits: the potion works and your points double. The list shows only what you hold (Items)

Features:

  • 13 different potion types (helpful & harmful!)
  • 339 built-in responses with references to:
    • Horror: Midsommar, The Stuff, Poltergeist, The Ring
    • Comedy: Army of Darkness, Shaun of the Dead, Hot Fuzz
    • Fantasy: LOTR, Harry Potter, The Witcher, Princess Bride
    • Games: Dark Souls, Skyrim, Zelda, Mario
    • Modern: Deadpool, Twin Peaks
  • Prevents giving potions to bots
  • Public messages; a member is pinged, a role or @everyone isn't
  • Scores points: helpful potions that work, harmful ones that work, and backfires each score differently (Games & Scores)

Available Potion Types:

Helpful Potions:

  • 💚 Health Potion - Healing with +HP
  • 💙 Mana Potion - Magic restoration with +MP
  • 🔴 Strength Potion - Power boost with +STR
  • 💨 Speed Potion - Haste effect with +SPD
  • 👁️ Invisibility Potion - Stealth mode
  • 🍀 Luck Potion - Fortune boost with +LUCK
  • 💕 Love Potion - Romance boost with +CHARM
  • ⚡ Energy Potion - Power up with +ENERGY

Harmful Potions (for fun chaos!):

  • 😵 Confusion Potion - Chaos effect with -INT
  • ☠️ Poison - Dark magic with -HP
  • 💔 Weakness Potion - Debuff with -STR
  • 👹 Curse - Ancient evil (CURSED status)
  • 🦥 Slow Potion - Movement debuff with -SPD

Examples:

/potion give user:@Friend type:health
→ "🧃 @You tosses @Friend an Estus Flask. 'Praise the sun!' 💚 +100 HP"

/potion give user:@Friend type:weakness
→ "🫠 @You gives @Friend a potion that tastes like regret. Their muscles turn to jelly! 💔 -75 STR"

/potion give user:@Friend type:curse
→ "👹 @You 'accidentally' gives @Friend the Cursed Videotape Juice. Seven days... 📼 CURSED (The Ring)"

/potion give user:@Friend type:love
→ "💘 @You hands @Friend Cupid's arrow in liquid form. 'As you wish.' 💕 +95 CHARM (Princess Bride)"

Note: Every potion scores points for you and the member you gave it to. See Games & Scores.

/foodfight ​

Start a food fight, after the classic BBS door game: throw food at a member, a whole role, or @everyone, or feed them instead. Each throw hits, misses, or backfires on the thrower; each meal is tasty, gross, or spilled. Both score points (Games & Scores).

Options (throw):

  • target (required) - A member, a role, or @everyone. A role or @everyone is shown but not pinged
  • food (optional) - Cream pie, spaghetti, pudding, mashed potatoes, Jell-O, meatloaf, creamed corn, tapioca, pizza, taco, fish sticks or split pea soup. Leave it out for a random one
  • item (optional) - An item from your Glovebox. Only 🥧 Golden Pie fits: a sure hit, and your points double. The list shows only what you hold (Items)

Options (feed): the same target, food and item (a 🥧 Golden Pie makes it always tasty, +2 more for you both).

Admin/Mod: /foodfight lines add, list, remove and reset take their food from a list, as you type, and manage your server's own lines for action:throw (with {thrower} and {target}) or action:feed (with {feeder} and {target}), each tagged with its outcome.

Examples:

/foodfight throw target:@Friend food:pie
/foodfight throw target:@everyone
/foodfight throw target:@Friend item:Golden Pie
/foodfight feed target:@Friend food:taco

See Social Commands › Food Fight.

/doom ​

Deal someone, a whole role, or @everyone a horror-movie fate: horror-comedy that dooms the target, backfires on you, or ends in a narrow escape. Scores points; someone shielded by a recent /rescue is safe (Games & Scores).

Options (fate):

  • target (required) - A member, a role, or @everyone. A role or @everyone is shown but not pinged
  • trope (optional) - Zombie, monkey's paw, slasher, possession, cursed tape, haunted doll, vampire, werewolf, killer clown, Necronomicon, Ouija board or Bloody Mary. Leave it out and fate decides
  • item (optional) - An item from your Glovebox. Only 📼 Cursed VHS fits: it can't backfire, doubles your points, and cuts through a shield or Garlic (Items)

Admin/Mod: /doom lines add, list, remove and reset manage your server's own lines, which need {user} and {target} and an outcome (doomed, escaped or backfired).

Examples:

/doom fate target:@Friend trope:monkey-paw
/doom fate target:@everyone

See Social Commands › Doom.

/rescue ​

Save someone from a horror movie: a Final Girl, holy water, the boomstick, the dog. A rescue that works shields them from the next /doom for an hour.

Options (attempt):

  • target (required) - A member, a role, or @everyone. You can't rescue yourself
  • trope (optional) - Final Girl, holy water, Ghostbusters, boomstick, salt circle, silver bullet, sunrise, getaway car, Van Helsing, survival rules, garlic or the dog
  • item (optional) - An item from your Glovebox. Only 💧 Holy Water fits: it can't be caught, gives you +2 more, and the shield lasts 3× as long (Items)

Admin/Mod: /rescue lines add, list, remove and reset manage your server's own lines, which need {user} and {target} and an outcome (rescued, caught or sacrificed).

Examples:

/rescue attempt target:@Friend trope:final-girl
/rescue attempt target:@everyone

See Social Commands › Rescue.

/siege ​

A monster attacks the drive-in and the whole server fights it together with food, dooms and potions. Beat it before time runs out and everyone who fought is paid, with a bonus and loot for the top fighter. Let it escape and everyone who fought loses a few points. Every 5 minutes it fights back: it grabs a fighter (free them with /rescue), poisons one (cure them with a helpful /potion) or roars. An admin starts one, or one turns up by itself (Random sieges).

Subcommands:

  • attack - Hit the monster. Anyone, from the siege's channel or its threads
  • status - The monster, its HP and your own damage and place. Only you see it
  • start - A monster attacks this channel (Admin/Mod)
  • end - End the siege now, with no rewards and no penalties (Admin/Mod). A monster already at 0 HP counts as beaten, and one whose time is up as escaped

Options (attack):

  • weapon (required) - food (throw something), doom (a horror fate) or potion (poison: damage now and for 5 minutes)
  • item (optional) - An item from your Glovebox. Golden Pie fits food, Cursed VHS fits doom, Lucky Penny fits potion, and the Silver Bullet fits any weapon. The list shows only what you hold (Items in a siege)

Options (start):

  • monster (optional) - One of 11 monsters. Without it you get a random one
  • minutes (optional) - How long it lasts, 30 to 60. Without it, 45, or the monster's own

Examples:

/siege attack weapon:food
/siege attack weapon:potion item:Lucky Penny
/siege status
/siege start monster:blob minutes:45
/siege end

Your first 30 attacks a day score points; later ones still do damage. A fighter the monster has grabbed can't attack until someone frees them, and one it has poisoned does half damage until someone cures them (It fights back). Turn it off with /eggshen-config commands toggle setting:siege enabled:false. See Games & Scores › Siege.

/scoreboard ​

Your game card, or anyone's: avatar, total and rank, a column per game (points, rank, plays, what they did and received, streak), an active rescue shield and any twist status, any happening or siege in progress, and your rewards: prizes in progress, nights in a row, Glovebox and titles. Right-click a member → Apps → Game card shows anyone's card privately.

Options: user, game, period (this month, this year, all time), private, and title (pick which earned title shows with your name, or No title; only for yourself)

/scoreboard
/scoreboard user:@Friend period:month

See Games & Scores › Scoreboard.

/leaderboard ​

The server's game card: the top 15 players one line each (medal, name, a bar against the leader, points), who leads each game, who received the most of everything, the period's plays, points, players, most played game, best streak and sieges won or escaped, and any happening or siege in progress.

Options: game, period (this month, this year, all time), private

/leaderboard period:month
/leaderboard game:doom

See Games & Scores › Leaderboard.

/how-to-play ​

Quick help for the games: one short card per topic, with a menu and ◀ Previous / Next ▶ to the others. Every number on it is the one the games use, and the limits are your server's own. Games switched off on the server are left out.

Options:

  • topic (optional) - Basics (default: the games, points, the limits and your score), Items & Glovebox, Prizes & titles, Nights in a row, Twists, Happenings or Siege
  • private (optional) - Only you see it. On by default; private:false shows it to the channel. Anyone can page through a public one: the buttons answer each person privately and never change the posted card

Examples:

/how-to-play
/how-to-play topic:Siege
/how-to-play topic:Items & Glovebox private:false

See the Games Quick Guides and the Games FAQ.

/stats ​

View server statistics (Admin/Moderator only).

Options:

  • filter - all-time, month, week, today
  • type - server or personal

Features:

  • Command usage statistics
  • Most searched content
  • User activity breakdown
  • Configurable tracking

Example:

/stats filter:month

Learn more →

Admin Commands ​

/eggshen-config and friends ​

Comprehensive server configuration (Admin/Moderator only), split across 6 commands to stay under Discord's per-command size limit:

  • /eggshen-config - settings, stats, commands, notifications
  • /eggshen-config-watch-party - watch party channels, rate limiting
  • /eggshen-config-ai - AI image limits and permissions, AI announcement text, and AI answers for /eggshen-ask
  • /eggshen-config-moderation - whitelist, cooldowns, auto-ban
  • /eggshen-config-events - event request system
  • /eggshen-config-games - game limits, game channels, happenings, twists and random sieges, score resets (/siege included)

Example:

/eggshen-config settings view
/eggshen-config-watch-party rate-limit toggle enabled:true
/eggshen-config-moderation moderation toggle enabled:true
/eggshen-config-games happenings frequency:rare

Learn more →

/eggshen-logs ​

View bot logs and diagnostics (Admin only).

Subcommands:

  • stats - View log file statistics
  • errors - View recent errors
  • category - View logs by category

Categories: system, command, button, scheduler, bracket, api, performance

Examples:

/eggshen-logs stats
/eggshen-logs errors count:20
/eggshen-logs category category:command count:10

Learn more →

/eggshen-help ​

Display help information and available commands.

Command Categories ​

CategoryCommands
Search/movie, /tv, /episode, /episode-list, /game, /boardgame, /book
Watch Parties/timer, /watched
Discovery/random, /similar, /soundtrack
Fun & Social/survey, /potion, /foodfight, /doom, /rescue, /siege, /scoreboard, /leaderboard, /how-to-play
Statistics/stats
Configuration/eggshen-config, /eggshen-config-watch-party, /eggshen-config-ai, /eggshen-config-moderation, /eggshen-config-events, /eggshen-config-games
Help/eggshen-help

Command Permissions ​

  • Everyone: Search, timer, watched add, random, similar, soundtrack
  • Admin/Mod: stats, eggshen-config (and its 5 sibling commands), watched from timer (or timer starter)

Learn about moderation →

Egg Shen — A Discord bot for movie, TV, video and board gaming, and book communities.

Copyright © 2026 Doug C. Hardester (known as r3volution11)