This is a console program that allows you to easily manage a Swiss-style chess tournament through simple commands.
Add, remove, enable, and disqualify players. Start and manage tournament rounds. Record game outcomes and view standings. Use various tiebreakers and configure priority order. Add players between rounds (for flexible management). Track player Elo based on match outcomes.
add player: <name>: Adds a player to the tournament.
remove player: <name>: (Only before starting) Removes a player.
enable player: <name>: Enables a previously disabled player.
disqualify player: <name>: Disqualifies a player (not paired).
start: Starts the tournament.
current round: Displays current round pairings.
score: Shows current tournament standings.
game: <white> - <black> => <outcome>: Records game outcome (1-0, 0-1, 1/2-1/2, suspended).
redo: Redoes the last round (useful for changes or adding players).
help: Displays a help message.
tiebreakers: <tiebreaker1, tiebreaker2, ..., tiebreakerN> : Sets tiebreakers and order of priority.
config: <configPath>: Set path to config file for tiebreakers preferences (json format).
example: Runs an example tournament.
Enter commands one at a time and press Enter. See this for more on Swiss-style tournaments.
Uses a priority queue based on points and black piece games played. Higher priority players get white, then next best opponent gets black. Players without an opponent get a point (doesn't count as a game).
Player Elo changes based on match outcomes and is saved in a binary file. New players and completed tournaments create/save the database.
Multiple supported systems with configurable priority order. Options include Black Games, Buchholz, Elo, Linear Performance, Progressive, FIDE Performance, and Sonneborn-Berger. Specify priority with tiebreakers command or a JSON configuration file.
To use the app, you need Java 21 and Maven 3.9.6. If you don't have them installed, you can follow these steps:
Visit the official OpenJDK JDK 21.0.2 download page. Click the Download button for your operating system.
Once the download is complete unzip the file an put this jdk folder sowhere on your computer.
You have to add to the PATH variable the location of the /bin folder inside the jdk folder.
Also you have to create the JAVA_HOME variable with the path to the jdk folder in an analogous form to the PATH variable.
To checkout if your instalation was correct execut this command
java --versionYou would see something like this
openjdk 21.0.2 2024-01-16
OpenJDK Runtime Environment (build 21.0.2+13-58)
OpenJDK 64-Bit Server VM (build 21.0.2+13-58, mixed mode, sharing)Go to the Apache Maven Downloads page. Click the link for the Binary zip archive. Once the download is complete, extract the Maven folder.
Add the /bin directory inside the Maven folder to your PATH environment variable.
Create the MAVEN_HOME variable with the path to the Maven folder.
Clone this repository from a command window and run:
mvn clean packageWait for the project to compile. Then run:
java -jar target/swiss-tournament-core-1.0.0-ALPHA-jar-with-dependencies.jarYou will see a brief usage guide similar to this README.
This is an alpha version (v1.0.0-ALPHA) with potential bugs and incomplete features.
Want to help? Here's how:
Bug reports: Submit them in the Issues section.
Improvements: Suggest them in Issues or fork & send a pull request.
Other ways: Translate, write docs, answer questions in Issues.