Skip to main content
Murder Mystery Bot is a self-hostable Discord game of social deduction. One player is the murderer. Everyone else has to find and execute them before the murderer kills the town. One bot process can run many games in many servers at the same time. Server data stays on the machine that runs the bot, in SQLite.

​
Invite and source

Guild invite for the published application: Add Murder Mystery Bot client_id is the Discord application id. The scope includes applications.commands. In the developer portal, enable the Message Content and Server Members intents before you invite the bot.

Support server

Questions about the bot go to the support Discord.

Bot repository

Public source for this bot, on the Krithiv-7 account.

More projects

Further work is on the justkrithiv GitHub account.

Playing and setup

Join a lobby, or clone the bot and run it yourself.
If you self-host, replace the application id in that invite. The steps are on Playing and setup.

​
What the bot does

  • Lobbies, day and night rounds, voting, and win conditions
  • Roles including murderer, doctor, detective, banker, thief, jailer, broadcaster, fool, hunter, werewolf, cupid, mayor, bodyguard, and medium
  • Prefix commands (!join) and slash commands (/join) that share the same game rules
  • An admin settings panel for timers, disabled commands, the prefix, and live games
  • Wildcard permissions such as admin.* and member.join
A game starts in a lobby. Codes look like MM-7F2A. During the day, the town votes. Executing the murderer wins the game for the town. At night, role actions and the shop happen in DMs. Public status stays in the server’s setup channel, or in the channel where the lobby was created. The bot does not create a channel, category, role, or voice channel for a game. !help and /help show Murder Mystery Bot v2.0.0 plus the command catalog.

​
Guide

Roles

Roles that are always seated, and roles that need more players.

Items

Night shop items, gold costs, and how you use them.

Commands

Prefix and slash commands for players, admins, and debug.

Settings

Player limits, timers, the prefix, and where status is posted.
The same role list is available in Discord with !wiki and /wiki.

​
Bot privacy and terms

The bot has its own privacy notice and terms, dated September 29, 2026 in the project source. They apply to Murder Mystery Bot. They are separate from the docs site Privacy Policy and Terms of Use. From that notice:
  • The bot processes Discord server ids and user ids so settings and statistics stay with the right person and server.
  • Gold is not saved between games. XP, level, objectives, win statistics, permissions, and server settings are saved.
  • Prefix commands and night replies are read so the game can respond. That text is not stored as a chat log.
  • The default store is data/bot.sqlite. A live lobby stays in memory and is discarded when the game ends or the process stops.
  • If you self-host, you are the operator of that instance. Publish a notice that fits your deployment.
  • Report a bot issue on the support server or in the repository. Leave the bot token out of the report.

Bot privacy

What the bot processes, where it is stored, and how to ask for a deletion.

Bot terms

Acceptable use, the guild invite, and the license for the source.
Source code is under the MIT License. See LICENSE in the repository. The project also has a Code of Conduct.