Game Instruction

Introducing The Game

For complete manual of classical mafia game read this instruction.

If you have willing to know more about game read wikipedia entry.

In this bot we have four playing rule: citizen, mafia, detective and doctor.

Role - Citizen

Their goal is to figure out who is a member of secret Mafia, and try to eliminate them during the day.

Role - Detective

Detective try to figure out who is guilty of being a Mafia and who is innocent. Every night detective asks from moderator(Bot) about one person and moderator(Bot) answers if that person is Mafia or not. thus their goal is to help the citizens vote correctly in who to eliminate during the day. They generally want to keep their identity secret so that the Mafia cannot eliminate them early.

Role - Doctor

Doctor is a protecting character, who wakes up once during each night and indicates someone who is to be protected. If Mafia try to kill the protected person he/she will survives.

Role - Mafia

Mafia unlike citizens is a small group of people which know each other. they try to keep their identity secret and eliminate citizens.

Bot Instruction

Game instruction and how to play with the Bot

Bot Instruction

IMPORTANT: Every player should have a valid username in Telegram. To define username, go to profile setting in the Telegram.

To use the bot must first add it to your group chat. To do this use this link and after clicking the bot's name (mafiaBot) choose add to group and then click the desired group.
You can start the game with the start command. Remember that you need to enter the necessary parameters along with the start command (the number of citizens, number of Mafia, number of detectives, and number of doctors).
When the robot says the game has started all players need to sign up using the register command.
When all players have signed up, the game starts automatically in day mode.

At the beginning of the game the bot sends everyone private messages telling them their roles. It's also tells members of mafia the names of other mafia members. So all mafia members know each other. At this point if the mafia are more than 2 people, they should create a new group and add the bot to it.

During the day every user, can start a election using the election command however this type of election has no influence on the game and it is merely for information and continued discussion. After the election has started everyone can vote using the vote command. Voting finishes when everyone has voted, then the results are announced. Those with more votes should defend their case. You can do as many elections as you want but in the end a final election should be done and the one with the most votes will be killed.

When someone is killed during the day, the Night comes. Now it's mafia’s turn. The Mafia discuss among themselves in their own group and then kill someone with the kill command.

After the user is killed by Mafia it's the detectives’ turn. The bot will privately ask the detective whom he/she suspects, and then the detective enter the suspect's name using the ask command. The bot will then let him know if the suspect is Mafia or not.

After mafia and detective, it is now the Doctor’s turn. Doctor can heal one player per night. The Bot will privately ask the doctor to name someone to rescue. Doctor has to rescue a player by heal command.

After doctor’s heal, it will be day again and the Bot will announce the killed player in the game’s public group chat. The game will continue its routine until whether all the mafia players being killed or the number of citizens equals the number of mafias.

Start Command

-number of citizens
-number of mafia
existence of detective - 0 or 1
existence of doctor - 0 or 1

Sample: for starting a game with 8 citizens, 2 mafias, 1 detective and without doctor, you should enter:

/start 8 2 1 0

Register Command


After start command all the people who wish to start the game have to enter the registration by entering:


Election Command

This command should be used in the Day. By executing this command, the voting process will begin. If the command executed again during an election, the election process will be started over.
Please keep in mind that this is not yet the final election and results are just for your information, meaning no one will be killed yet.


Final Election Command

The same process for starting election goes on here, but the person who gaines the highest votes will be killed.


Vote Command

Person or People - the list of telegram username(s) that are separated with space.
After starting the election or final election, players should announce their vote by entering the following command. E.g. for voting for the user “Alice”, you should enter:

/vote Alice

or for vote for “Alice” and “Bob”, enter:
/vote Alice ‌Bob

or to vote for no one, simply enter:
/vote nobody

Kill Command

Person - the username of the person that you want to kill.
This command is solely for mafia player at night. Pay attention that this command is unexecutable in the game’s main chat group and should only be executed in another chatroom or in private. The command acts like a vote and should be executed by all the mafia players and they should all announce their vote with this command. e.g. for killing Bob, you should execute this command in a private message to the Bot or in a group other that the main game group.

/kill Bob

Heal Command

Person - the username of person

this command is solely for the Doctor and at night, after mafia killed a player, the doctor will be asked who he/she wants to be healed. Like kill command, this command should also being executed privately in a message to the Bot and not in the public group.
e.g. the Doctor should enter the following command to the Bot in a private chat to heal the user “Alice”:

/heal Alice

Ask Command

person - person’s username

This command is only to be used by detective and at night while Mafia kills someone, then its detectives turn to ask the Bot privately about a suspicious user whether he/she is a mafia or not. e.g. if the detective is suspicious about “Robert”, to ask it from the bot, he/she enter the following command privately to the bot:

/ask Robert

Who is Playing Command


Anytime during game, any user can ask the bot (in private or in public room) about the remaining players.


Cancel Command


During the play if majority of players want to cancel the current game, they have to enter the following command separately. If majority of players perform this command, the game will be cancelled and players can start a new game.


Help Command


Shows the link to this manual page.


What is my role Command


Players can ask the bot in private chat about their own role.


Kill me Command


Players can kill themselves anytime during the game. Usually this command is used for leaving a leftover game and register in a new game.


Change Language Command

fa or en

To change the bot’s interface language, you can use the following commands:

/lang fa

/lang en


Does Mafia kills anyone on the first night?
No. The game starts with Day! As the bot announces the roles in a private chat to players and mafias to other mafia players, the first Night does not exists. It means that neither Mafia kills anyone nor detective asks about anyone or doctor heals anyone.
Can someone vote to several people during a day?
Yes.You can vote for a list of names you want to by entering on after the vote command. For details see vote command manual.
Can someone vote for nobody?
Yes, Simply enter nobody after kill command or vote command.
Can someone play in several games simultaneously?
No. In this case the bot can not recognize which game are the private messages are for. That’s why the bot does not register the user on the second game unless he leaves the current game with cancel command or kill me command.
Does the bot announces identity of killed person?
No. To keep the game more exciting, the bot does not do that but once every two night the bot announces the game information including citizens and mafias.
Does the bot have access to all the messages in the group?
No. the Bot is added to groups in “Privacy Mode” and just have access to messages starting with “/” character. For more information on this subject please visit this page.

Contact us

We love to receive your emails at