Z5Bot

A script to glue the Telegram Bot API and Frotz together.
Maybe an instance is running right now!

Why?

Playing games by using this bot has these advantages:

• portability: play at home, then continue your game on the bus (e.g. via phone)
• collaboration: you can add the bot to a Telegram group and play games together!
• ease of use: you don't need an interpreter or game files, just Telegram

Even a Raspberry Pi 2 is able to handle 30 different chats at the same time with ease!

Screenshot

playing alone

playing in a group

At the time of writing, full documentation doesn't exist and some stuff is still hardcoded.

Installation

Put bot.py, dfrotz.py in a directory. Rename config.json.example to config.json.
Additionally, place

• a z-machine game file in the stories/ folder
• dfrotz (Frotz compiled in dumb-mode / see Frotz Makefile) in the tools/ folder
  and edit config.json to fit your needs.

Install python-telegram-bot from pip and run bot.py, e.g. via screen.

Have fun. :D