Der WoPperBot

Yet another Wahrheit-oder-Pflicht 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
• Usage
• TODOs
• NOTDOs
• Contribute

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, paste the following as-is:

    join - an der Runde teilnehmen
    leave - Runde verlassen (keine Angst, du bleibst im Chat)
    random - nächste Person zufällig aus der Runde wählen
    choose - nächste Person wählen (braucht @username dahinter)
    wop - zufällig Wahrheit oder Pflicht wählen
    do_w - Wahrheit wählen
    do_p - Pflicht wählen
    who - wiederholt, wer zur Zeit dran ist
    kick - die zuletzt gewählte Person aus dem Spiel werfen (bleibt aber im Chat)
    players - schreibt in den Chat wer alles an der Runde teilnimmt
    

  • 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.