https://github.com/maxencebonamy/tournament-generator
This software allows you to generate a multiplayer and multigame tournament plannning with a customizable number of teams and games, and with 1V1 confrontations.
https://github.com/maxencebonamy/tournament-generator
excel openpyxl python tournament-generator
Last synced: 3 months ago
JSON representation
This software allows you to generate a multiplayer and multigame tournament plannning with a customizable number of teams and games, and with 1V1 confrontations.
- Host: GitHub
- URL: https://github.com/maxencebonamy/tournament-generator
- Owner: maxencebonamy
- License: mit
- Created: 2023-10-06T23:00:19.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-07T18:01:46.000Z (over 1 year ago)
- Last Synced: 2025-01-18T14:05:13.771Z (4 months ago)
- Topics: excel, openpyxl, python, tournament-generator
- Language: Python
- Homepage:
- Size: 55.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This software allows you to generate a multiplayer and multigame tournament plannning with a customizable number of teams and games, and with 1V1 confrontations.
To do this, simply enter the team and game names in the `config.json` file, then run the program, and an Excel file will be generated with the entire tournament schedule.
### Run the program:
> [!NOTE]
> *Prerequisites:*
> - [x] *Git must be installed on your computer. If not, click here.*
> - [x] *Python version 3.9 or greater must be installed on your computer, if not, click here.*
1. **Clone** the repository on your computer. To do this, open a terminal in the folder of your choice and run the following command:
```
git clone https://github.com/maxencebonamyTournament-Generator
```
2. **Navigate** inside the folder you've just cloned with the following command:
```
cd Tournament-Generator
```
3. **Install dependencies** by running this command:
```
python -m pip install -r requirements.txt
```
4. **Start the program** with the following command:
```
python src
```
### Input format:
To configure the tournament, simply edit the `config.json` file. In this file, there's a list containing the team names, as well as a list containing the game names. This automatically determines the number of teams and games.
### Output format:
The program ends by generating an Excel file containing 3 pages, each illustrating the overall tournament schedule, but from different points of view.
- **Global planning:** All games by team and time slot.
- **Teams planning:** All team games with the team they are playing for each game, according to time slot.
- **Games planning:** All teams playing against each other for each game, according to time slot.
### Constraints:
- The number of teams must be even, as this is a 1V1 tournament.
- The number of games multiplied by two must be greater than or equal to the number of teams, otherwise the tournament cannot be generated.