Personal Telegram Bot

A Telegram chat entertainment and tabletop utilities bot written in Rust. Runs on teloxide with SQLite storage, and ships with Docker for easy deployment.

It supports:

• dice-rolling with standard RPG notation (e.g., d20, 2d6m+3)
• a Magic 8‑Ball,

More in CHANGELOG

---

⚠️ Warning: This is a new version of the bot rewritten in Rust. The old v1 JVM version is available at main-v1

Usage

Step 1: Installing from command line[1]:

curl https://raw.githubusercontent.com/zoobestik/borken_bot/master/docker-compose.yml > docker-compose.yml
echo "BOT_TELEGRAM_TOKEN=<...token...>" >> .env

[1]: Placeholder should be replaced by:

• <...token...> – token to access for HTTP API;

More information in Telegram Bot Api page.

Step 2: Start a bot server instance:

docker-compose up

Development

git config core.hooksPath scripts/githooks

echo "BOT_DB_FILE=data/bot.db" > .env
echo "BOT_TELEGRAM_TOKEN=<...token...>" >> .env

Acknowledgements