/murdermystery
Social-deduction party game for 4–15 players. Killers pick off the innocent team at night; detectives investigate; meetings vote out suspects. Last side standing splits the prize pot.
Description
A snappy Discord take on Among Us / Mafia. The host opens a lobby with an entry fee; players who join pay the same fee into a shared pot. Once the game starts, it alternates between night rounds (~2 min) and meetings (~2 min). A persistent status panel reposts itself to the bottom of the channel whenever something changes, so you never have to scroll back to find the buttons.
Optional Fields
- entry_fee - Per-player buy-in (
k,m,max,halfsupported; default10k). Must meet the bot's minimum bet. - max_players - Maximum players in lobby (4–15, default
10). - killers - Number of killers (1–3, default
1).
Usage
/murdermystery [entry_fee] [max_players] [killers]
Examples
/murdermystery
/murdermystery entry_fee:50k
/murdermystery entry_fee:1m max_players:12 killers:2
/murdermystery max_players:15 killers:3
Free NPC test
/murdermystery-npctest [npc_count] [killers] [your_role]
Free practice mode against NPC players. NPC killers and guardian angels auto-play; other NPC roles idle (so NPC detectives/doctors are basically wasted slots).
- npc_count - Number of fake players (3–14, default
7). - killers - Number of killers (1–3, default
1). - your_role - Force your own role (
random,killer,detective,guardian_angel,doctor,juggernaut,civilian).
Player requirements
| Killers | Minimum players |
|---|---|
| 1 | 4 |
| 2 | 6 |
| 3 | 7 |
Roles
- Killer - Picks one player to eliminate each night. 10-second wait after the round starts before the first kill of the round.
- Detective - Investigates a player and posts a public read: SUSPICIOUS or INNOCENT. Reads have a 15% chance to flip, so cross-check before voting. Investigations per round =
max(2, alive // 5). - Guardian Angel - Picks one player to protect each night. A killer's attack on the protected player is blocked. Available at 5+ players.
- Doctor - Once per game, revive a dead player. Available at 6+ players.
- Juggernaut - Automatically survives the first two killer attacks. Still vulnerable to vote-outs. Available at 7+ players.
- Civilian - No special powers; discuss, vote, survive.
Detectives are assigned 1 per 6 players (minimum 1). One guardian angel / doctor / juggernaut slot is added as the lobby grows past the thresholds above.
Game flow
- Lobby - players join via button; the host can start manually, and after 10 minutes the lobby starts itself with whoever joined. If the minimum player count still is not met at that point, all entry fees are refunded.
- Role reveal - each player gets their role by DM (ephemeral fallback if DMs are closed). Night begins after a short 5-second pause.
- Night round (~2 min) - killers/detectives/guardian angels/doctors act. The status panel reposts on every action. Round ends early when all alive killers have acted.
- Meeting (~2 min) - 30 seconds of discussion, then ~75 seconds of voting. Players can skip or vote a target. Live vote tally shown on the panel.
- Repeat night/meeting until one side wins.
- Auto-cleanup if a game runs longer than 60 minutes; entry fees and unsettled penalties are refunded.
Status panel
Instead of scattered action messages, the game shows a single status panel that gets reposted whenever something happens. It always shows:
- Current phase (Night N, Discussion, or Voting)
- Alive / dead counts, killers remaining, prize pot
- Live vote tally during meetings
- Buttons for whatever action makes sense in this phase
When discussion bumps the panel up the channel, an action (kill, vote, etc.) automatically reposts it at the bottom.
Economy
- Entry fee is deducted on join and added to the pot.
- Leaving the lobby before start refunds your fee.
- Wrongful-vote penalty: if the meeting eliminates an innocent player, every innocent voter who voted for them is fined
max(1, entry_fee / 4)from their wallet (capped at current balance). The fine is added to the pot. - Catching a killer: voters credited with eliminating a killer earn "catch" credit, boosting their share of the final pot.
- NPC test mode uses no money — no penalties, no payouts.
Win conditions
- Innocents win when all killers are eliminated.
- Killers win when alive killers ≥ alive innocents.
Reward split
The pot is split among human winners by score (NPCs never collect):
- Innocents score =
1 + (catches × 3) + (1 if alive) − wrong_votes, floored at 1. - Killers score =
1 + (kills × 2) + (1 if alive), floored at 1.
Each winner gets pot × score / total_score, with any remainder going to the top scorer.
Notes
- Cooldown: 5 seconds (host).
- One game per channel at a time. If a game stalls, the channel frees itself automatically.
- Lobby and game both auto-clean if abandoned, refunding fees and penalties.
- The host can leave during the lobby; host transfers to the next remaining player.
- Re-DM your role any time with the Get Role Info button.