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!