@lycanthrobot help

TL; DR: /start the bot. Add the bot to a group, master writes /newgame, players write /play. Master writes "/roles list_of_roles". Players write "/action message" in private. The bot notifies when everybody has done it. Master kills and tells what happened. Players write "/vote message", master kills the most voted person in the /polling. Repeat until /endgame.

This is a telegram bot for playing your own game of Werewolf/Mafia with your friends. It was thought to let you play in your own style with no restrictions, the master has complete control of the game. Please use the command /feedback to report errors or request features. This is what you can do with the bot in detail:

You must let the bot send messages to your private chat, for it, /start the bot @lycanthrobot. From a group, a person starts a game with /newgame. This person will be the master of the game. Then everybody that wants to play writes /play in the group. When enough people have joined the game, the master writes /roles and a list of words that will be the roles. The bot will shuffle these characters and will send them to the players using the private chat. Any role that contains in the name the string "wolf" will be considered a wolf by the bot and will send a message to each wolf telling them who the other wolves are. Later, the players must write "/action message with what I do with my role/s tonight" from the private chat. When everybody has performed their action the master will receive a message containing everything and the bot notifies in the main group that the night is over. Then the master will write /kill @nick to tell the bot the person who died. For lynching, the players must write "/vote message" from the group and all the messages can be seen with /polling. The bot lets the user to play several games simultaneously (one per group), the command /game can be used in private to tell the bot to which game the subsequent commands refer to. By default the selected game is the first game you started a game in. When such a game ends another game is selected and you are notified.

There is support for a variation of the game that is quite good, which consists of assigning more than one role (and the same number of "lives") to each person. The master can change to this mode by writing "/mode 2" for example, before "/roles". If a person dies during the night, that person will choose the role that dies (first, second...), if the person is lynched, a random role dies. The master has commands "/killn @nick number_of_role", "/killd @nick", "/killr @nick @nick2 ..." to kill after the night and kill after the diurnal lynching and to kill randomly when there is a tie in the voting, respectively.

You don't need to know more to start playing, but here there is a detailed list of all the commands the bot supports.

  Commands:

User:

  /action "message": Write a message along the command telling the master your action. You must call this command from a private chat with the bot, the message will indicate the action you perform. You have to do it even if you are a villager or if have already used your powers. After everybody has performed their action, the master will receive a private message with every action. Then the master should tell the village in the main group what has happened and will call the command /kill to tell the bot who died during the night. You can write /action this command as many times as you want, the last one will be the one to be considered.

/feedback: Send a message with your opinion of the bot, any bugs you are having, ideas to improve the bot, feature requests...

/game: The bot asks you to select one of the groups in which you are playing or being the master. After this, the private commands will refer to that group.

/help: It prints a link to this help post

/leave: Used by the users if they want to undo the effect of /play.

/me: Used in the private chat, it reminds you your role/s.

/play: Used by the users in order to tell the bot they will play the current game. A game must have been started with the command /newgame. The master cannot execute /play.

/polling: See the results of the polling. Please, try to call this from the private chat to not generate too many messages in the main group.

/rand "list of words": Used with a list of words, the bot will send one of them randomly. It is useful for some situations in which you have to decide something at random.

/rand "A number": Used with a positive number n, the bot will send a random natural number in [1, n]. It is useful for some situations in which you have to decide something at random.

/riot: If this command is called by three distinct players in a game, the bot will end the game (useful if the master is not online).

/rolelist: It sends a link to a big list of roles and their descriptions.

/roles: Used while playing, it reminds the roles and tell which of them are alive and which are dead

/signup: If you have changed your nick the bot will not be able to interact with you correctly. You can update your nick with /signup. This command is the equivalent to /start.

/start: It starts the chat with the bot. Needed for the bot to send messages to you.

/vote @nick: Vote for somebody during the day. You have to vote from the main group. If you vote again the vote is overwritten. Your vote is reseted after somebody dies with /kill

/who: If used after /newgame and before /roles, it shows who is going to play. If used while playing, it shows a list of the people that are current alive and then a list of the dead people along their role.

Just for the master:

/delayed: performed by the master in private, it tells them what people have not sent their actions yet.

/endgame: It ends the game, it can only be used by the master.

/endnight: It ends the night, it can only be used by the master. Useful to unblock a game where some users don't send their actions. Try not to use it very often.

/kill @nick: It kills somebody in the game mode with one role per person. It is used to tell the bot who died during the night or the day.

/killd @nick: It kills a role, it can only be used in the mode with more than one role per person. This is for diurnal death. The role killed is random among the ones that are still alive.

/killn @nick n: It kills a role, it can only be used in the mode with more than one role per person. This is for nocturnal death, it can only be used by the master. The master must ask the killed person the number of the role he/she wants to be killed. It is an integral greater or equal than 1.

/killr "list of @nicks": It kills a role, it can only be used in the mode with more than one role per person. The bot will pick a person from the list at random and will kill one of their roles at random. This is useful when there is a tie in the polling.

/mode n: Used by the master after /newGame. The bot will send a message with the number of roles the master has to select. n stands for the number of lives. The bot waits for the command /roles or for another /mode to set a distinct number of lives.

/newgame: It starts a new game. The master will be the one that executes this command. If a game is already being played this command does nothing.

/roles "list of roles": This command needs a list with as many words as the number of people that are playing (support for the thief will be maybe considered later). Every word must be the name of a character. The bot will shuffle the characters and will send a private message to each player with their role. Roles must be names with no spaces. The bot will consider a wolf every role that has "wolf" in its name. It will send private messages to all of them telling them who they are.

/setrole @nick role n: Used by the master in private in any moment, it overwrites the role of @nick and sets role instead. n is the number of the role, use it just if playing with more than one life. It is useful for playing with characters as the cardsharp or the thief.

/sunset: Used by the master to remind people to send their actions. It is optional, and it is usually done when the night is going to start. The people and only people that have not acted yet received a reminder. by the bot. It helps preventing people not sending their actions if a slow paced game is played.