FootballBot — Your ultimate Discord companion for…

Pitch

Description

Comments

About this project

FootballBot delivers live league insights and engaging image-based trivia right in Discord. With features like match alerts, team profiles, and pixelated club crest challenges, it keeps football fans in the loop while testing their knowledge. Perfect for enhancing any football community's engagement.

FootballBot is a Discord bot designed for football enthusiasts, offering real-time league information and engaging image-based trivia. This bot provides users with live updates on matches, comprehensive standings, and detailed player and team profiles, all through interactive commands.

Key Features

Real-time Football Information
- Get information on today’s, live, and upcoming matches, sortable by league or team.
- Access league standings, top scorers, and assist leaders.
- Explore profiles of teams and players, including crests and photos.
- Receive alerts for goals and results by following specific teams.
- Generate dynamic image cards for standings, player comparisons, and recent forms.
Interactive Image Trivia
- Engage in the main trivia mode featuring a gradually revealed pixelated or blurred club crest.
- Challenge yourself with various trivia formats including silhouettes, zoomed-in sections, and stings of a stadium or kit.
- Test your knowledge through a career path quiz, where participants guess the player based on club crests connected by years.
- Enjoy additional modes like Higher or Lower, a 3x3 grid, and a daily player challenge styled similarly to Wordle.
- Earn points and track performance on per-server and global leaderboards.
Community and Social Features
- Users can view profile cards showcasing statistics, achievements, and participate in match prediction pools, with future plans for a sticker/card album.

Technology Stack

The bot is built with a robust technology stack:

Main Language: Python 3.12+
Discord Integration: discord.py (supports slash commands, buttons, and more)
HTTP Requests: httpx (asynchronous capabilities)
Image Processing: Pillow
Database Management: SQLite initially; potential for PostgreSQL later
Performance Optimization: Utilizes ruff for coding standards and pytest for testing.

Data Sources

FootballBot pulls data from various free sources, ensuring that users receive accurate and timely information. For a detailed list of the APIs used, refer to APIS.md.

Whether for the thrill of live updates or the excitement of trivia challenges, FootballBot enhances the Discord experience for football fans by merging useful information with fun gaming elements.