Mafia.exe

MAFIA BOT

Mafia Bot brings the classic social deduction game directly to your Discord server with zero setup required. Host immersive Mafia/Werewolf games with friends and community members through an intuitive, fully automated system.

HOW IT WORKS

CREATE A ROOM Use /createroom to set up a lobby for 4-15 players. A unique join code is generated instantly and a live-updating lobby embed appears with player count and status. The lobby updates in real-time as players join or leave.

PLAYERS JOIN Friends use /joinlobby to browse all active lobbies sorted A-Z by host name. Each room shows player count, privacy status, and availability. Public rooms allow instant joining. Private rooms use a host approval system where players request to join and the host approves or denies.

ROLES ARE ASSIGNED When the host clicks Start Game, roles are randomly distributed among players. Base roles include Villager, Mafia, Doctor, Detective, Vigilante, and Jester. Addon roles like Mayor, Gunsmith, Traitor, Blackmailer, and Lovers can be toggled on or off by admins using /config. Roles are assigned with random distribution - sometimes you'll get a Doctor, sometimes you won't. Each game is unique!

Each player can see their role by clicking the See Role button in the game thread. A private thread is automatically created for the game, keeping chat organized and separate from the main channel. NO DMs are sent - all role info is shown in the game thread via ephemeral messages.

NIGHT FALLS The town sleeps. All players are muted during night phase to prevent meta-gaming. Mafia secretly chooses a target to kill. Doctor selects someone to save and can save themselves. Detective investigates suspicious players. Vigilante takes their one-time shot. Blackmailer forces someone to vote for their target. Gunsmith gives a gun to someone. Mayor's vote counts as 2 during the day.

All actions are submitted through interactive buttons and select menus with role-specific wording - "Save target" for Doctor, "Spy on target" for Detective, "Select target" for Mafia and Vigilante. The night phase auto-resolves when all players have acted, no waiting for the full timer.

DAY BREAKS Deaths are announced. The town discusses who might be guilty and votes to eliminate suspects. Real-time vote tracking on the embed shows who voted for whom. A skip vote option is available for no-lynch. Tied votes result in no elimination with randomized tie messages. The Mayor role has double voting power. Dead players are automatically muted using the MMuted role to prevent ghosting.

GAME ENDS Win conditions are checked automatically after each phase. Mafia wins by outnumbering villagers. Village wins by eliminating all Mafia. Jester wins by getting themselves lynched. Lovers win if both survive to the end. Final results display all roles in an embed. The game thread stays for 30 seconds before auto-deleting so players can read the results. Everyone is automatically unmuted when the game ends.

KEY FEATURES

SETUP REQUIREMENT The bot requires an admin to run /setup before any commands work. This ensures the MMuted role and game channel are properly configured. Players will see a helpful message directing them to run /setup if it hasn't been completed.

SEAMLESS LOBBY SYSTEM Browse lobbies with a dropdown menu instead of typing codes. Live player counts and status indicators show if rooms are open, full, joined, pending, or kicked. Rooms sort A-Z by host name. Leave accidentally joined rooms with /leavelobby or the Leave Lobby button. The lobby embed updates instantly when players join or leave.

HOST CONTROLS Toggle between public and private rooms at any time. Approve or deny individual join requests. Kick disruptive players with a 5-minute rejoin cooldown. Close inactive rooms with a confirmation modal. Auto-detects and warns abandoned lobbies. Thirty-minute hard timeout for inactive rooms. Privacy toggle has a 10-second cooldown to prevent spam.

AUTOMATED GAMEPLAY Configurable day and night phases with Speed (1min), Normal (2min), or Relaxed (3min) presets via /config. Actions auto-resolve when all players have submitted. Live-updating embeds show pending actions and vote tallies. Detective investigation results include reveal buttons sent as ephemeral messages. Tie votes and no-vote scenarios are handled gracefully with randomized messages. Auto-end game when less than 4 players remain.

ANTI-ABUSE PROTECTION Command rate limiting with 3-second cooldowns. Join request spam detection caps at 5 requests per 10 seconds. Server-wide game limit of 30 active lobbies. Kick system with temporary bans lasting 5 minutes. Privacy toggle cooldown of 10 seconds. Ping role cooldown of 5 minutes. Setup guard prevents commands from running until /setup is completed.

QUALITY OF LIFE No DMs are sent - all role info is shown via ephemeral messages in the game thread. Private threads keep game chat organized. Dead players are muted using the MMuted role. Game threads auto-delete after 30 seconds. Session persistence means games survive bot restarts. Addon roles are toggleable via /config. Automatic backups are created every 10 seconds to games.json. The MMuted role is created automatically during setup. Commands are locked until setup is complete.

ROLE BREAKDOWN

BASE ROLES

VILLAGER A regular townsperson with no special abilities. Find the Mafia through discussion and observation.

MAFIA Kill one villager each night. Blend in during the day to avoid suspicion and steer votes away from your team.

DOCTOR Save one person from death each night, including yourself. Your protection cancels out a Mafia kill.

DETECTIVE Investigate one player each night to learn whether they are Mafia or not. Share results strategically.

VIGILANTE Kill one person during the game. A one-time ability. Choose wisely or you might eliminate an ally.

JESTER Your only goal is to get yourself lynched by the town. Act suspicious enough to be voted out.

ADDON ROLES (Toggleable via /config)

MAYOR Your vote counts as 2 during the day. Lead the village to victory.

GUNSMITH Give a gun to someone at night. They can use it to kill once. Use your ability wisely.

TRAITOR You appear as a Villager to the Detective. Win with the Mafia. Stay hidden.

BLACKMAILER Force someone to vote for your target the next day. Stay in the shadows.

LOVERS Two players are bound together. If one dies, the other dies too. Win together if both survive.

ADMIN COMMANDS

/setup - Set up the bot with MMuted role and select game channel (must be run first) /config - Configure timers, role presets, theme color, ping role, and toggle addon roles

PLAYER COMMANDS

/createroom - Create a new Mafia lobby /joinlobby - Browse and join available lobbies /leavelobby - Leave a lobby you joined /listrooms - List all active rooms /close - Close a room you are hosting /leave - Leave a game you are in, which kills your character /stats - View game statistics /about - Information about the bot

BUILT FOR COMMUNITIES

Zero setup required beyond running /setup once. Invite the bot and start playing. Runs in any channel with proper permissions. Automatic thread management keeps your server clean. AFK detection prevents abandoned lobbies. Server limits prevent abuse with a maximum of 30 active lobbies. The MMuted role is auto-managed for dead players. Commands are locked until setup is complete, ensuring proper configuration. Web dashboard available for easy server management.

Created by roughzero._