Skip to content

Yet another Wahrheit-oder-Pflicht bot for Telegram, because all the others are time-based.

License

Notifications You must be signed in to change notification settings

BenWiederhake/der-wopper-bot

Repository files navigation

Der WoPperBot

Yet another Wahrheit-oder-Pflicht ("truth or dare") bot for Telegram, because all the others suck.

The existing bots are all defunct or incomplete. So I wrote my own.

Table of Contents

Install

$ # Install Python3 somehow
$ pip3 install --user -r requirements.txt

That should be it.

Usage

  • Copy secret_template.py to secret.py
  • Create your bot
    • This means you have to talk to the @BotFather: https://web.telegram.org/z/#93372553
    • Do /newbot, edit it as much as you like (i.e. description, photo)
    • For the commands, see bot.py, function cmd_start.
    • Invite him into the group chat(s) you like
    • Afterwards, set the bot to "Allow groups: No"
    • Copy the API token
  • Fill in your own username and the API token in secret.py
  • Run bot.py. I like to run it as ./bot.py 2>&1 | tee bot_$(date +%s).log, because that works inside screen and I still have arbitrary scrollback.
  • Write /permit into the chat to allow games. Use /admin to view all the commands you have.
  • You can Ctrl-C the bot at any time and restart it later. The state is made permanent in wopper_data.json

TODOs

Not much, maybe add more message variants?

NOTDOs

Here are some things this project will definitely (probably) not support:

  • Complex D&D-style roll syntax
  • Any advanced parsing
  • Any further control of the game

Contribute

Feel free to dive in! Open an issue or submit PRs.

About

Yet another Wahrheit-oder-Pflicht bot for Telegram, because all the others are time-based.

Resources

License

Stars

Watchers

Forks

Languages