/TI4Botten

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

TI4Botten

A Discord bot for Twilight Imperium 4th Edition, featuring faction randomization and more.

Features

  • Randomly select TI4 factions, optionally filtered by expansion/source
  • Discord command interface
  • Extensible bot architecture

Setup

  1. Clone the repository: 
    git clone https://github.com/fsharpasharp/TI4Botten.git
cd TI4Botten
  2. Install dependencies: 
    pip install -r requirements.txt
  3. Add your Discord bot token to a file named .token in the project root.

Usage

Run the bot:

python app.py

Database

This project uses SQLAlchemy ORM with SQLite (app.db). Tables are auto-created on first run. See src/game/model.py for models.

Testing

Run all tests:

pytest

Test coverage includes bot commands and faction logic. See tests/ and src/game/tests/.

Project Structure

  • app.py — Main entrypoint for the bot
  • src/bot.py — Bot and command definitions
  • src/game/commands.py — Game-related Discord commands (uses ORM)
  • src/game/factions.py — Faction logic and data loading
  • src/game/model.py — SQLAlchemy ORM models
  • src/game/tests/ — Faction logic tests
  • tests/ — Bot command tests

Contributing

Pull requests and issues are welcome!