core/io.github.lunalobos.chess4kt/SwissTournament

SwissTournament

class SwissTournament(val eloCalculator: EloCalculator = EloCalculator(), val idGenerator: () -> Any? = null, val id: Any? = null, val name: String? = null, val timeControl: String? = null, val type: String? = null) : Tournament

A swiss style tournament.

Since

1.0.0-beta.8

Author

lunalobos

Constructors

SwissTournament

constructor(eloCalculator: EloCalculator = EloCalculator(), idGenerator: () -> Any? = null, id: Any? = null, name: String? = null, timeControl: String? = null, type: String? = null)

Types

Companion

object Companion

Properties

activeMatches

open override val activeMatches: List<Match>

Current matches being played.

completed

open override var completed: Boolean

Whether the tournament has reached its conclusion.

eloCalculator

open override val eloCalculator: EloCalculator

The strategy used for rating adjustments.

finishedMatches

open override val finishedMatches: List<Match>

All concluded matches in the tournament history.

open override val id: Any?

The unique identifier for this tournament.

idGenerator

open override val idGenerator: () -> Any?

Unique ID generator for assigning identifiers to match objects.

leaderboard

open override val leaderboard: List<Player>

Standings sorted by score and tie-breakers.

name

open override val name: String?

The display name of the tournament.

numberOfRounds

var numberOfRounds: Int

Total rounds expected for this tournament.

playersComparator

open override var playersComparator: Comparator<Player>

The strategy used to break ties between players with the same score. Updating this field automatically updates the ranking logic.

timeControl

open override val timeControl: String?

The specific time settings for the matches (e.g., "3+2", "10|0"). Returns null if no specific time control has been defined.

type

open override val type: String?

The category of the tournament based on the time control (e.g., "blitz", "bullet", "rapid").

Functions

addMatch

open override fun addMatch(white: String, black: String?, outcome: String, id: Any?, round: Int?): Boolean

Adds a match to the tournament for the specified round. This method is ideal for cases where external logic is being used or an instance is being reconstructed.

addMatchOf

fun addMatchOf(white: Player, black: Player)

Manually defines a pairing for the first round.

addPlayer

open override fun addPlayer(player: Player)

Adds a player to the tournament registry.

nextRound

open override fun nextRound(): List<Match>

Generates the next round of the tournament. Pairs players with similar scores who haven't played each other yet.

removePlayer

open override fun removePlayer(player: Player)

Removes a player from the tournament.