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