Drawbridge

Drawbridge is a Python bot designed to assist ozfortress tournament admins with the operation of active cups and seasonal tournaments. It is compatible with any Citadel-powered league.

It's features include

• Automated creation of Division categories and roles
• Automated creation of Team channels and roles
• Automated creation of Match channels
• Assisted Demochecking (in which logs are checked to identify a player who played)
• Logging of all match communications
• A launchpad to find your way around
• Health Monitoring: Automated bot monitoring with Discord webhook alerts
• Web Interface: Log viewer with database search and filtering

Still to come

• Automated team captain assignment
  • Blocked by Citadel API not including captain information
• Automatic Database configuration
  • TODO
• Web Interface for fetching logs, configuring embeds, etc

Getting Started

This application is powered by Python 3.12.3. All dependencies are pinned in requirements.txt. To get started, install Python 3.12.3 and run the following commands:

Linux:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Windows:

python3.12.3 -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt

The application is configured using environment variables. Create a .env file in the root directory of the project by copying the .env.example file and filling in the required values.

Note: The database is not auto-configured. You will have to apply the template database.

To run the application, after activating the venv as seen above, execute the following command:

python app.py

Health Monitoring

Drawbridge includes automated health monitoring that sends Discord webhook alerts when issues are detected.

Quick Setup

1. Configure webhook:

   python configure_health_monitoring.py

2. Test configuration:

   python test_health_webhook.py

3. Deploy with monitoring: The bot will automatically start health monitoring when deployed.

For detailed configuration options, see HEALTH_MONITORING.md.

Web Interface

Access the web interface at http://localhost:8080 (or your configured port) for:

• Database log viewing with search and filtering
• Match and team information lookup
• Bot health status monitoring
• Real-time log streaming

Contributing

See CONTRIBUTING.md for guidelines on contributing to this project.

License

This project's licensing is still being determined. See LICENSE.md for more information.