Add fun and interactive elements to your entertainment Discord community with surveys, polls, potions, food fights, horror-movie fates and rescues, and status quotes.

/potion, /foodfight, /doom and /rescue are games with points, a /scoreboard and a /leaderboard, and /siege is a fifth, played all together against a monster. See Games & Scores for how points, shields, limits and sieges work. Each play can take an item: from your Glovebox, and keep playing to earn prizes and titles.

Quick FAQ

Q: Can I disable the survey command if we already have a polling bot?
A: Yes! Use /eggshen-config commands toggle setting:Survey Command enabled:false

Q: Who can manage surveys?
A: The person who created the survey, server administrators, and moderators can close or delete surveys.

Q: How do users vote in surveys?
A: By clicking the button under their choice.

Q: Can users change their vote?
A: Yes! Click a different button to switch your vote. In multiple-vote mode, clicking a button toggles that option on or off without affecting your other selections.

Q: Are survey results stored permanently?
A: Yes, all surveys are stored in JSON files per-server and persist even if the bot restarts.

Q: Can I give a potion, throw food, deal a fate or rescue a whole role, or everyone?
A: Yes. Pick a member, a role, or @everyone as the target. A role or @everyone shows in the message but nobody gets a notification; only a member you pick is pinged. Only you score points for those.

Q: Can I turn off /potion, /foodfight, /doom, /rescue or /siege?
A: Yes: /eggshen-config commands toggle setting:potion enabled:false (or setting:foodfight, setting:doom, setting:rescue, setting:siege). Admins and moderators can always use them. To keep the games to certain channels, or out of them, use /eggshen-config-games channels (Games & Scores).

Q: The survey scrolled away. How do people find it?
A: /survey voting-post posts it again at the bottom of the channel, with its buttons and the votes so far. The old card greys out and links to the new one.

Q: Can a survey close itself automatically?
A: Yes! Set duration:[minutes] when creating it (/survey create ... duration:120 for 2 hours). Without it, a survey stays open until someone runs /survey close.

Q: What happens if two options tie?
A: A runoff vote between just the tied options starts automatically. If the runoff ties too, the bot picks one at random. Set tie-break:None when creating a survey where a tie is a fine answer. See Ties.

Survey Commands

Create interactive polls and surveys with up to 10 options, live vote tracking, optional auto-close, and comprehensive management.

Create a Survey

/survey create question:[question] option1:[text] option2:[text] ... option10:[optional] multiple:[optional] duration:[optional] tie-break:[optional]

Parameters:

question (required) - The survey question (max 256 characters)
option1 (required) - First option (max 100 characters)
option2 (required) - Second option (max 100 characters)
option3-option10 (optional) - Additional options (max 100 characters each)
multiple (optional) - Allow users to vote for multiple options (default: false)
duration (optional) - Auto-close voting after this many minutes, from 1 minute up to 14 days (20160 minutes). Omit for a survey that stays open until manually closed with /survey close
tie-break (optional) - What a tie for first does: Runoff vote (default) or None (the tie stands). See Ties

Features:

Up to 10 options per survey
Vote by clicking a button under the option — no reactions to add or copy
Single-vote mode (default): Clicking a different button switches your vote
Multiple-vote mode: Clicking a button toggles that option on/off, other selections stay as-is
The survey message updates live as votes come in — no need to run /survey results to see current standings
Optional auto-close after a set duration, closing and posting results automatically without anyone needing to run /survey close

Examples:

/survey create question:"What should we watch tonight?" option1:"Horror" option2:"Comedy" option3:"Action"

/survey create question:"Which genres do you like?" option1:"Sci-Fi" option2:"Fantasy" option3:"Drama" option4:"Thriller" multiple:true

/survey create question:"Best 80s movie?" option1:"The Breakfast Club" option2:"Back to the Future" option3:"Blade Runner" option4:"Die Hard" option5:"E.T."

/survey create question:"Movie night pick?" option1:"The Thing" option2:"Alien" duration:120

How It Works:

Bot posts an embed with your question and a button under each option
Users vote by clicking a button
The survey message updates live with current vote counts and percentages as votes come in, and you'll get a private confirmation of your own vote
If a duration was set, the embed shows when voting ends and the bot automatically closes the survey and posts results at that time — otherwise, use /survey close when you're ready to end it
Anyone can view live results any time with /survey results

Ties

When a survey closes with two or more options tied for first:

A runoff starts. The results card says who tied, and a new runoff survey is posted below it with only the tied options. It's one vote each, even if the original allowed several, and it runs as long as the original did, or 24 hours if the original had no timer. Everyone can vote, including people who didn't vote the first time.
If the runoff ties too, the bot picks one of the tied options at random. The results show the pick with a 🎲 and say it was random.

A survey nobody voted in has no winner and no runoff, and a tie for second place doesn't count. Create a survey with tie-break:None to let a tie stand, which suits opinion polls like "How scary was it?". /survey results on a tied survey links to its runoff.

List All Surveys

/survey list filter:[active|closed|all]

Parameters:

filter (optional) - Filter surveys by status (default: active)
- active - Only show active surveys
- closed - Only show closed surveys
- all - Show all surveys

Features:

Shows up to 25 most recent surveys
Displays survey ID, question, vote count, creation time, and channel
Status indicators: 🟢 Active, 🔴 Closed
Jump links to original survey messages

Examples:

/survey list
/survey list filter:Active
/survey list filter:All

View Survey Results

/survey results poll_id:[id]

Parameters:

poll_id (required) - The survey to view — start typing the question and Discord will suggest matching surveys (active and closed) with their live vote counts

Features:

Detailed results with progress bars
Vote percentages for each option
Total vote count
Shows your own votes (if any)
Link to jump to original survey message
Works for both active and closed surveys

Example:

/survey results poll_id:a1b2c3d4e5f6g7h8

Result Display:

📊 What should we watch tonight?

🏆 1️⃣ **Horror**
🟨🟨🟨🟨🟨🟨🟨🟨⬜⬜ `80%` · 8 votes

2️⃣ Comedy
🟦🟦⬜⬜⬜⬜⬜⬜⬜⬜ `20%` · 2 votes

3️⃣ Action
⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜ `0%` · 0 votes

Your Vote(s): 1️⃣ Horror

The leader gets a 🏆 and a gold bar; everyone else's bar is blue, so the front-runner stands out at a glance. If the top spots are tied, no option is crowned and every bar is blue.

Once the bot's own emoji are uploaded (it does this itself on its first start), the bars are drawn with them, and they turn grey when the survey closes. A survey with many long options gets shorter bars so the whole card still fits; the bars keep the same length from the first vote to the last.

Post a Survey Again

/survey voting-post poll_id:[optional]

In a busy channel the survey scrolls up out of sight. This posts it again at the bottom, as a new message, with its vote buttons and the votes so far, so people can find it and see how it's going.

Parameters:

poll_id (optional) - The survey to post. Leave it out when only one survey is open; with several open, start typing the question and pick one

How It Works:

The new card is the survey from then on: votes on it update it, and it's the one that shows the final result when the survey closes
The old card greys out its buttons and gets a link down to the new one, so there's never an out-of-date count with working buttons left behind
Anyone who can use /survey can run it. Members can post the same survey once every 10 minutes per channel; the survey's creator and anyone who can manage the server, any time
Closed surveys can't be posted again; use /survey results to see how they ended. Very old surveys that were voted on with reactions can't move either, and you get a link to the original instead

Example:

/survey voting-post

Close a Survey

/survey close poll_id:[id]

Parameters:

poll_id (required) - The survey to close — autocomplete only suggests surveys you're actually allowed to close (your own, or any if you're an admin/mod)

Permissions:

Survey creator
Server administrators
Moderators (users with kick/ban/timeout permissions)

Features:

Ends voting immediately
Disables the voting buttons on the survey message (they stay visible, just grayed out)
Updates the original message to show final results
Posts final results as a new message in the channel, with a chart of them: each option's share as a bar, most votes first, the winner's bar gold under a crown (or the 🎲 when a runoff was settled at random), and the total underneath. Emoji in the question and options are left out of the chart. If the chart can't be drawn, or the bot can't attach files in that channel, the message posts without it
Closed surveys can still be viewed with /survey results

Example:

/survey close poll_id:a1b2c3d4e5f6g7h8

Note: If the survey was created with a duration, all of this happens automatically once voting ends — you don't need to run /survey close yourself unless you want to end it early.

Delete a Survey

/survey delete poll_id:[id]

Parameters:

poll_id (required) - The survey to delete — autocomplete only suggests surveys you're actually allowed to delete (your own, or any if you're an admin/mod)

Permissions:

Survey creator
Server administrators
Moderators (users with kick/ban/timeout permissions)

Features:

Permanently removes the survey from storage
Attempts to delete the original survey message
Cannot be undone
Use /survey close instead if you want to keep the record

Example:

/survey delete poll_id:a1b2c3d4e5f6g7h8

Warning: This action cannot be undone. If you want to keep the survey in history, use /survey close instead.

Survey Management

Permission System

Three types of users can manage surveys:

Survey Creator - The person who created the survey
Administrators - Users with Administrator permission
Moderators - Users with any of these permissions:
- Manage Server
- Kick Members
- Ban Members
- Timeout Members (Moderate Members)

Regular users can only vote, not manage surveys.

Storage and Persistence

Surveys are stored in JSON format per-server
Files located in guild_polls/[server-id].json
Data persists across bot restarts
Includes full vote history and metadata

Configuring Survey Access

Administrators can enable or disable the survey command per-server:

/eggshen-config commands toggle setting:Survey Command enabled:false

This is useful if your server already has a preferred polling bot (like top.gg or DarcyBot) and you want to avoid command conflicts.

Potion Command

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

Give a Potion

/potion give user:<member, role, or @everyone> type:<potion-type> item:[item]

item is optional: a 🍀 Lucky Penny makes the potion work and doubles your points. The list shows only what you hold (Items). A 💊 Antidote on the receiving end works by itself against a harmful potion.

Potion Types:

Helpful: Health, Mana, Strength, Speed, Invisibility, Luck, Love, Energy
Harmful: Confusion, Poison, Weakness, Curse, Slow

Features:

339 built-in responses with references from movies, TV shows, video games, and more
Themed responses based on genre (Horror, Comedy, Fantasy, Sci-Fi, Gaming, Action, Classics, Animation, Drama)
Posted publicly. A member you pick is pinged; a role or @everyone is shown but not pinged
Scores points: a helpful potion that works gives you +1 and them +2; a harmful one gives you +2 and them −2; a backfire costs you 2 (Games & Scores)

Examples:

/potion give user:@Alice type:health
/potion give user:@Movie Club type:confusion
/potion give user:@everyone type:luck
/potion give user:@Alice type:poison item:Lucky Penny

Sample Responses:

"🧪 Alice hands Bob a suspicious red liquid. 'This... is my BOOMSTICK of healing!' 💚 +50 HP (Army of Darkness approved)"
"🍷 Charlie gives Dave Joffrey's wedding wine. Should've skipped the reception... 💀 -75 HP (Game of Thrones)"
"🐒 Eve wishes on a Monkey's Paw for Frank's luck. A finger curls. Eve stubs every toe for a week. 💔 -60 LUCK" (a backfire)

Custom Responses and Themes (Admin/Mod)

/potion responses add type:health outcome:worked response:{giver} hands {receiver} a juice box. 💚 +5 HP
/potion responses list type:health
/potion responses remove type:health index:1
/potion responses reset type:health
/potion theme set themes:horror,comedy

A response needs both {giver} and {receiver}, and an outcome: worked or backfired. Your own responses are used alongside the built-in ones; themes narrow which built-in ones are used.

Food Fight

Start a food fight, after the classic BBS door game. Throw food at a member, a whole role, or @everyone, and the bot says what happened: a hit, a miss, or a throw that backfires on you. Or be nice and feed them instead.

Throw Food

/foodfight throw target:<member, role, or @everyone> food:[food] item:[item]

Leave out food and the bot grabs whatever's on the tray. item is optional: a 🥧 Golden Pie is a sure hit and doubles your points. The list shows only what you hold (Items).

Foods: 🥧 Cream Pie, 🍝 Spaghetti, 🍮 Pudding, 🥔 Mashed Potatoes, 🟩 Jell-O, 🍖 Meatloaf, 🌽 Creamed Corn, 🥣 Tapioca, 🍕 Pizza, 🌮 Taco, 🐟 Fish Sticks, 🥬 Split Pea Soup

Examples:

/foodfight throw target:@Alice food:pie
/foodfight throw target:@Moderators
/foodfight throw target:@everyone food:pea-soup
/foodfight throw target:@Alice item:Golden Pie

Sample lines:

"🥧 @Alice winds up like a Three Stooges short and plants a cream pie square on @Bob. Nyuk nyuk nyuk." (a hit)
"🐟 @Bob swats @Alice's fish stick aside with a pool noodle. Where did the pool noodle come from? Doesn't matter. Clean miss."
"🍝 @Alice grabs the spaghetti by the sauce end. Rookie. @Alice is marinara to the elbows and @Bob is laughing their ass off." (a backfire)

Posted publicly, with the points underneath: a hit is +3 for you and −1 for them; a miss −1 / +1; a backfire −2 / +2. A member you hit is pinged; a role or @everyone is shown but not pinged. Bots dodge everything. 300 built-in lines.

Feed Someone

/foodfight feed target:<member, role, or @everyone> food:[food] item:[item]

The kind half of a food fight. A 🥧 Golden Pie (item) makes it always tasty, with +2 more for you both. It's tasty (+1 for you, +2 for them), gross (−1 each), or you spill it on yourself (−2 for you, +1 for them, who still gets fed). 181 built-in lines.

"🍮 @Alice makes @Bob a flan so jiggly it waved hello. @Bob waved back, then ate it."

Your Own Lines (Admin/Mod)

/foodfight lines add action:throw food:pie outcome:hit line:{thrower} hurls a key lime pie at {target}!
/foodfight lines add action:feed food:pie outcome:tasty line:{feeder} bakes {target} a perfect pie.
/foodfight lines list action:throw food:pie
/foodfight lines remove action:throw food:pie number:1
/foodfight lines reset action:throw food:pie

food is picked from a list: start typing and the bot suggests the menu. A food that isn't on it is refused.

A throw line needs both {thrower} and {target} and an outcome of hit, miss or backfire; a feed line needs {feeder} and {target} and tasty, gross or spill. Your lines are used alongside the built-in ones. {target} can be one person, a role, or @everyone, so write lines that read for any of them.

Doom

Deal someone a horror-movie fate: a zombie bite, a monkey's paw, a cursed tape. It's horror-comedy, so things go wrong for the victim, backfire on whoever did the dooming, or occasionally end in a narrow escape. Aim it at a member, a whole role, or @everyone.

Deal a Fate

/doom fate target:<member, role, or @everyone> trope:[trope] item:[item]

Leave out trope and fate decides. item is optional: a 📼 Cursed VHS can't backfire, doubles your points, and cuts through a shield or Garlic. The list shows only what you hold (Items). A target with 🧄 Garlic turns a doom into an escape by itself (Defences).

Tropes: 🧟 Zombie, 🐒 Monkey's Paw, 🪓 Slasher, 😈 Possession, 📼 Cursed Tape, 🪆 Haunted Doll, 🧛 Vampire, 🐺 Werewolf, 🤡 Killer Clown, 📖 Necronomicon, 🔮 Ouija Board, 🪞 Bloody Mary

Examples:

/doom fate target:@Alice trope:zombie
/doom fate target:@Camp Counselors trope:slasher
/doom fate target:@everyone
/doom fate target:@Alice item:Cursed VHS

Sample lines:

"🪓 @Bob tries to call for help. No bars. One bar. Zero bars. @Alice cuts the landline anyway, purely for style points." (doomed)
"🧟 @Bob gets bitten, turns, and immediately eats @Alice. Somebody should have aimed for the head." (backfired)
"🔮 @Alice asks the spirits to haunt @Bob. The planchette spells "N-O-P-E," floats across the room, and bonks @Alice on the forehead every hour, on the hour." (backfired)

Posted publicly, with the points underneath: doomed is +3 for you and −1 for them; an escape −1 / +2; a backfire −2 / +1. Someone recently saved with /rescue is shielded: the doom is blocked, nobody scores, and the shield is used up. A member you doom is pinged; a role or @everyone is shown but not pinged. Bots are already undead. 300 built-in lines.

Your Own Lines (Admin/Mod)

/doom lines add trope:zombie outcome:doomed line:{user} serves {target} brain casserole!
/doom lines list trope:zombie
/doom lines remove trope:zombie number:1
/doom lines reset trope:zombie

A line needs both {user} and {target}, and an outcome: doomed, escaped or backfired. Your lines are used alongside the built-in ones. {target} can be one person, a role, or @everyone, so write lines that read for any of them.

Rescue

/doom's opposite: save someone from a horror movie. A Final Girl drags them out of the cabin, holy water, the boomstick, the dog that always survives. A rescue that works shields them from the next /doom for an hour.

Attempt a Rescue

/rescue attempt target:<member, role, or @everyone> trope:[trope] item:[item]

Leave out trope and whatever works, works. item is optional: 💧 Holy Water can't be caught, gives you +2 more, and the shield lasts 3× as long. The list shows only what you hold (Items). The tropes named Holy Water, Garlic and Silver Bullet are flavour, not items.

Tropes: 🔪 Final Girl, 💧 Holy Water, 👻 Ghostbusters, 🔫 Boomstick, 🧂 Salt Circle, 🥈 Silver Bullet, 🌅 Sunrise, 🚗 Getaway Car, 🗡️ Van Helsing, 📜 Survival Rules, 🧄 Garlic, 🐕 The Dog

Outcomes:

Rescued: +1 for you, +2 for them, and they're shielded.
Caught: you both get caught, −1 each.
Sacrificed: you save them and take the hit yourself: −2 for you, +3 for them, and they're shielded.

Sample lines:

"🗡️ @Alice beats the vampire in a staring contest, then stakes it while it's blinking. @Bob is saved, and slightly confused."
"🔪 @Alice tries to save @Bob, but they both trip over absolutely nothing while running from a guy who is walking. Both caught."

You can't rescue yourself ("Final Girls don't save themselves for points"), or a bot. Rescuing a role or @everyone scores only you and shields nobody. 300 built-in lines.

Your Own Lines (Admin/Mod)

/rescue lines add trope:the-dog outcome:rescued line:{user} follows the dog and drags {target} out the back door!
/rescue lines list trope:the-dog
/rescue lines remove trope:the-dog number:1
/rescue lines reset trope:the-dog

A line needs both {user} and {target}, and an outcome: rescued, caught or sacrificed.

Status Quote Commands

The bot rotates its Discord status once an hour through a list of short quotes, each optionally tagged with a title (movie/show/game/etc.) and an author (character or real person). See QUOTES_ADMIN_SETUP.md for how server admins manage that list (the quotes-admin web page, opened with a one-click link from /eggshen-config-quotes admin-link, or the other /eggshen-config-quotes subcommands).

Post a Random Quote

/quote title:[optional] author:[optional]

Parameters:

title (optional) - Only pull quotes from this movie/show/game/etc. Has autocomplete against titles currently in the list.
author (optional) - Only pull quotes by/from this character or person.

If both title and author are given, a quote matching either one is returned (not both at once). With no options, a random quote is picked from the entire list.

Examples:

/quote
/quote title:"The Thing"
/quote author:"MacReady"
/quote title:"The Thing" author:"MacReady"

Suggest a Quote

/suggest-quote quote:[text] title:[optional] author:[optional]

Parameters:

quote (required) - The quote text (max 400 characters)
title (optional) - The movie/show/game/etc. it's from (max 100 characters)
author (optional) - The character or real person who said it (max 100 characters)

How It Works:

Your suggestion is added to a review queue — it does not go straight into the bot's status rotation
If the server has a quote-suggestions moderation channel configured, moderators see it there with Approve/Edit/Reject buttons
Once approved, it becomes part of the live rotation /quote and the bot's status can pull from

Example:

/suggest-quote quote:"Trust no one." title:"The Thing" author:"MacReady"

Best Practices

Surveys

Keep questions concise - 256 characters max, but shorter is better
Limit options - 2-5 options typically work best, though you can use up to 10
Use multiple-vote mode for preference surveys (e.g., "Which genres do you like?")
Use single-vote mode for decisions (e.g., "What should we watch tonight?")
Close surveys when voting is complete to show final results
Clear survey titles help when browsing /survey list

Common Use Cases

Watch party planning: "What should we watch tonight?"
Schedule coordination: "What time works for the watch party?"
Content preferences: "Which genres should we explore more?"
Event feedback: "How was last night's watch party?"
Quick polls: "Horror or comedy?"

Troubleshooting

Survey issues

Problem: Users can't vote
Solution: Make sure the survey is still active. Check with /survey list. If closed, votes are disabled.

Problem: Survey command doesn't appear
Solution: Check if it's enabled: /eggshen-config settings view and look at the Command Permissions section.

Problem: Can't close someone else's survey
Solution: Only the creator, admins, or moderators can manage surveys. Regular users can only vote.

Problem: Lost the survey ID
Solution: Use /survey list to find all surveys and their IDs.

Potion issues

Problem: Potion responses are repetitive
Solution: Administrators can add their own with /potion responses add, used alongside the 339 built-in ones.

Problem: A role or @everyone didn't get a notification
Solution: That's on purpose: /potion, /foodfight, /doom and /rescue show a role or @everyone without pinging anyone, so a game doesn't notify a whole server. Pick a member to ping them.

Problem: "⏳ cooldown" or "🎲 Games are played in…"
Solution: Each game can be played once every 20 seconds per person, and the games can be limited to certain channels. See Games & Scores.

Games & Scores - Points, shields, scoreboards and game settings
Configuration Commands - Customize survey and potion settings
Watch Party Commands - Host watch parties with timers
Statistics - Track command usage

Tournament Quick Guides

Games Quick Guides

Quick FAQ

Survey Commands

Create a Survey

Ties

List All Surveys

View Survey Results

Post a Survey Again

Close a Survey

Delete a Survey

Survey Management

Permission System

Storage and Persistence

Configuring Survey Access

Potion Command

Give a Potion

Custom Responses and Themes (Admin/Mod)

Food Fight

Throw Food

Feed Someone

Your Own Lines (Admin/Mod)

Doom

Deal a Fate

Your Own Lines (Admin/Mod)

Rescue

Attempt a Rescue

Your Own Lines (Admin/Mod)

Status Quote Commands

Post a Random Quote

Suggest a Quote

Best Practices

Surveys

Common Use Cases

Troubleshooting

Survey issues

Potion issues

Social Commands ​

Quick FAQ ​

Survey Commands ​

Create a Survey ​

Ties ​

List All Surveys ​

View Survey Results ​

Post a Survey Again ​

Close a Survey ​

Delete a Survey ​

Survey Management ​

Permission System ​

Storage and Persistence ​

Configuring Survey Access ​

Potion Command ​

Give a Potion ​

Custom Responses and Themes (Admin/Mod) ​

Food Fight ​

Throw Food ​

Feed Someone ​

Your Own Lines (Admin/Mod) ​

Doom ​

Deal a Fate ​

Your Own Lines (Admin/Mod) ​

Rescue ​

Attempt a Rescue ​

Your Own Lines (Admin/Mod) ​

Status Quote Commands ​

Post a Random Quote ​

Suggest a Quote ​

Best Practices ​

Surveys ​

Common Use Cases ​

Troubleshooting ​

Survey issues ​

Potion issues ​

Related Documentation ​

Social Commands

Quick FAQ

Survey Commands

Create a Survey

Ties

List All Surveys

View Survey Results

Post a Survey Again

Close a Survey

Delete a Survey

Survey Management

Permission System

Storage and Persistence

Configuring Survey Access

Potion Command

Give a Potion

Custom Responses and Themes (Admin/Mod)

Food Fight

Throw Food

Feed Someone

Your Own Lines (Admin/Mod)

Doom

Deal a Fate

Your Own Lines (Admin/Mod)

Rescue

Attempt a Rescue

Your Own Lines (Admin/Mod)

Status Quote Commands

Post a Random Quote

Suggest a Quote

Best Practices

Surveys

Common Use Cases

Troubleshooting

Survey issues

Potion issues

Related Documentation