A Python-based football simulation program that lets you explore different outcomes for professional football leagues, cups, and European tournaments. Perfect for football enthusiasts who love to simulate, analyze, or create alternative football histories!
- Python 3.9 or higher
- Simulate games based on team skills, league standings, coefficients, and competition rules.
- Supports all European leagues, and for some countries, even second divisions.
- Simulate full league seasons for all supported leagues.
- Includes league-specific rules, standings, and points calculations.
- Simulate national football cups for each of the supported countries.
- National cups include more participants (e.g., top teams from multiple divisions).
- Simulate European tournaments in a more realistic structure:
- Expanded tournaments include League Phase, Knockouts, and 2 Qualification Rounds.
- UEFA Champions League (UCL).
- UEFA Europa League (UEL).
- UEFA Europa Conference League (UECL).
- Competition coefficients adjust dynamically based on results, affecting tournament seedings.
- Track European appearances, wins, and historical performances for each team.
- A robust coefficient system:
- Results from teams affect their league's standing in European competitions.
- Coefficients directly impact seeding for future simulations.
- Emulates real-life mechanics of European football competitions.
- Store and retrieve historical data in a relational database.
- Track stats such as:
- Team records and historical standings over all simulations.
- League, National Cup, and European tournament winners.
- Most skilled teams based on skills database.
- Simulate an entire season:
- Full domestic season (including secondary divisions, national cups).
- European Competitions:
- Qualification Rounds (2 rounds).
- League Phase.
- Knockout Rounds.
- Expanded database with more teams.
- Add automatic promotion and relegation system.
- Enhanced statistics tracking:
- In-depth analytics at team, league, and competition levels.
- Graphical charts and trend reports.
- Option to export results to various formats (CSV, JSON, etc.).
Run the main.py.
You will be presented with the following menu options:
| Option | Description |
|---|---|
| 1 | Simulate an entire season: League → National Cup → All European Cups. |
| 2 | Simulate a specific league season (choose a league via prompt). |
| 3 | Simulate a specific national cup (choose a country via prompt). |
| 4 | Play a European cup tournament (UCL, UEL, or UECL). |
| 5 | View the best-performing teams in a specific league (based on simulation records). |
| 6 | Check detailed stats for a specific team (enter team name). |
| 7 | View the most successful teams in a specific competition (e.g., most league/cup titles). |
| 8 | View European competition stats (appearances and wins by teams in UCL/UEL/UECL). |
| 9 | Display the most skilled teams (based on skill metrics defined in the database). |
| q | Quit the program. |
-
Choose Option 1: Simulate an entire season.
-
Specify the number of seasons to simulate.
-
Watch the simulation results as the program:
- Simulates each country's league and national cup.
- Plays European competitions (UCL, UEL, UECL).
-
Results will be updated in the database and displayed:
- League winners, Cup winners, European competition results.
The program utilizes a database to store and retrieve historical data. Some of the key data stored includes:
- League results and standings.
- Cup winners by season.
- Historical European appearances and performances (e.g., how often a team reached the UCL final).
Contributions are welcome! Feel free to submit pull requests or report issues:
- Fork the repo.
- Create a new branch for your feature/fix:
git checkout -b feature-name
- Submit your changes with a pull request.
Enjoy simulating your football fantasy with Football Simulator! 🚀⚽