Dominions Slack Bot

Dominions 6 Slack Bot

A Slack bot for managing and tracking Dominions 6 games, providing updates and allowing players to interact with game information directly through Slack.

Features

Track multiple Dominions 6 games
Automatically update game status and player turns
Respond to various Slack commands for game management and information retrieval
Fun responses to keywords like "grog" and "mad"
Periodic task to update game information

Commands

/dom: Main command for interacting with the bot
- game add <game_name>: Add a new game to track
- game remove <game_name>: Remove a game from tracking
- game nickname <game_name> <nickname>: Set a nickname for a game
- game list: List all active games
- game primary <game_name>: Set a game as the primary game
- game status <game_name> <active|inactive>: Set a game's active status
/check <game_name>: Fetch the current status of a game from the website
/turn: Display the current turn status for the primary game
/dom player <game_name> <nation> <player_name>: Associate a player name with a nation in a specific game

Project Structure

commands/: Command handlers for various bot functionalities
controllers/: Logic for parsing commands and formatting responses
models/: Data models for games, players, and lobby details
responders/: Fun response handlers for keywords
tasks/: Background tasks for updating game information
utils/: Utility functions and managers (database, logging, Slack)
main.py: Main entry point for the application

Setup

Clone the repository
Install dependencies:
```
uv sync
```
Set up environment variables:
- SLACK_BOT_TOKEN: Your Slack bot token
- SLACK_APP_TOKEN: Your Slack app token
- DB_URI: Database connection URI
- LOG_LEVEL: Logging level (default: INFO)
Run the bot:
```
uv run src.main
```

Testing

Unit tests are available in the *_test.py files. Run tests using pytest:

uv run pytest