Skip to content

Telegram bot for hosting The Resistance: Avalon games made with the python-telegram-bot.

Notifications You must be signed in to change notification settings

fatma0828/TheResistance-Avalon-Telegram-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TheResistance-Avalon-Telegram-Bot

Telegram bot for hosting The Resistance: Avalon games made with the python-telegram-bot.

Installation Guide

  1. Download this repo.
  2. Register at BotFather for a token and bot URL.
  3. Prepare a host server with webhook compatibility. (e.g Heroku)
  4. Input (1) Bot token, (2) bot URL, and (3) Webhook URL to myconfig.py
  5. Deploy on server.

(Optional) Edit gamemsg.py to change the game text.

(Optional) Change the images in the /img folder to change game images.

Game rules

Use the /genrules command to invoke game rules message. Or, visit https://www.ultraboardgames.com/avalon/game-rules.php

Known issue(s)

Anonymous mode for admins is not recommended for players. Some commands may not work as intended when the sender is an anonymous admin.

Commands

/newgame - Start a new game in the current group

/startgame - Begin the game when there are enough players

/endgame - End the game when it is stuck or when it is over

/genrules - Show the rules of the game

/rolerules - Show the functions of all roles

/rolecons - Show the distribution of roles for different number of players

/checkvote - Show the current voting status of the current round, to check who has not voted yet (once per round)

Disclaimer

This bot was built for educational purposes. The right to all characters and gameplay mechanisms belong to the original owner of the game. Also, this bot has only been tested on Heroku; connection methods may differ for other service hosts.

Screenshots

/rolerules

image

/newgame

image

Entering /startgame invokes the role assignment function, which then notifies players of their roles in private message.

image

Messages in main chat will show instructions to proceed.

image

Selecting players for a Round - journey

image

Voting for the success of a journey

image

About

Telegram bot for hosting The Resistance: Avalon games made with the python-telegram-bot.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages