Available in the Gaming / Industries Circle
quantum | v2 switch to V1  

API-TournamentPhase

Namespace: Gimmebreak.Backbone.Tournaments

Inheritance: Object → TournamentPhase

Tournament phase defines part of a tournament (number of users entering, number of rounds, format, etc.), tournament can combine many phases to create required flow. First phase in tournament always starts with Id=1. Tournament phase has always at least one round. It also holds logged users information such as played round count, total phase points, phase position, etc.

public class TournamentPhase

Contents

Constructors

TournamentPhase()

Creates a tournament phase.

public TournamentPhase()

Back To Top
 

Properties

GroupCount

Determine how many groups are in current phase.

public int GroupCount
{
    get;
    set;
}

Back To Top
 

GroupSize

Determine maximum number of teams/parties per single group.

public int GroupSize
{
    get;
}

Back To Top
 

HasGroups

Determine if there are groups in current phase.

public bool HasGroups
{
    get;
}

Back To Top
 

Id

Phase id (starts with 1).

public int Id
{
    get;
    set;
}

Back To Top
 

IsLoserBracketSeeded

Determine if loser bracket is seeded in double elimination bracket phase.

public bool IsLoserBracketSeeded
{
    get;
    set;
}

Back To Top
 

IsSkipAllowed

Determine if phase is allowed to be skipped in case there are less or equal teams in current phase then expected in next phase.

public bool IsSkipAllowed
{
    get;
    set;
}

Back To Top
 

MaxLoses

Max loses in this phase (E.g. arena can define that if you lose 3 times you are out).

public int MaxLoses
{
    get;
    set;
}

Back To Top
 

MaxPlayers

Max players entering this phase.

public int MaxPlayers
{
    get;
    set;
}

Back To Top
 

MaxTeams

Max teams/parties entering this phase.

public int MaxTeams
{
    get;
    set;
}

Back To Top
 

MaxTeamsPerMatch

Maximum allowed teams per match.

public int MaxTeamsPerMatch
{
    get;
    set;
}

Back To Top
 

MinCheckinsPerTeam

Determine how many players in team needs to checkin in order to be allowed to start a tournament match.

public int MinCheckinsPerTeam
{
    get;
    set;
}

Back To Top
 

MinTeamsPerMatch

Minimum required teams per match. This indicates if match should be played or not. Only fully checked in teams/parties counts.

public int MinTeamsPerMatch
{
    get;
    set;
}

Remarks

In certain phase formats if match does not contain MinTeamsPerMatch until start deadline then all checked in parties will get autowin and are moved to the next round.

Back To Top
 

Rounds

Phase rounds. Each round can have a different time and win conditions (E.g. each round is best of three, but final round is best of five).

public List<TournamentRound> Rounds
{
    get;
    set;
}

Back To Top
 

Scores

Determine all party scores in this phase. It holds summary of points, wins, loses, etc. each party gathered. List has to be loaded on demand. To populate scores use LoadTournamentPhaseScores() on backbone client.

public List<TournamentScore> Scores
{
    get;
    set;
}

Back To Top
 

Type

Phase type (E.g. Arena or Bracket).

public TournamentPhaseType Type
{
    get;
    set;
}

Back To Top
 

UserGroupId

Determine user group id in current phase.

public int UserGroupId
{
    get;
    set;
}

Back To Top
 

UserIsGroupAssigned

Determine if user group id has been assigned. In case there are groups in first phase of a tournament users has to check in first. For a team only party leader will trigger group id assigning process on checkin.

public bool UserIsGroupAssigned
{
    get;
}

Back To Top
 

UserIsParticipating

Determine if user is participating in phase. It can be false if user has been knocked out in previous phase.

public bool UserIsParticipating
{
    get;
    set;
}

Back To Top
 

UserLoses

Number of user loses in current phase.

public int UserLoses
{
    get;
    set;
}

Back To Top
 

UserPlayedRoundCount

Count of already finished rounds for user in given phase. This increases despite if user did or did not really play/participate in previous rounds.

public int UserPlayedRoundCount
{
    get;
    set;
}

Back To Top
 

UserPoints

Number of user points in current phase. This represents total points for match results (not total points scored in game sessions).

public int UserPoints
{
    get;
    set;
}

Back To Top
 

UserPositionBottom

Users current bottom position in this phase (E.g.(1-3/8) => 3).

public int UserPositionBottom
{
    get;
    set;
}

Back To Top
 

UserPositionTop

Users current top position is this phase (E.g. (1-3/8) => 1).

public int UserPositionTop
{
    get;
    set;
}

Back To Top
 

Methods

GetRoundById(int)

Gets phase round by specific id.

public Gimmebreak.Backbone.Tournaments.TournamentRound GetRoundById(int roundId)

Parameters

  • roundId: Round id (first round always starts with id=1).

Returns

Tournament round or null if round does not exists.

Back To Top
 

GetScoreByPartyId(long)

Get phase score record by party id. Note that scores has to be loaded prior using this method otherwise the return value will be NULL. Use LoadTournamentPhaseScores() on backbone client.

public Gimmebreak.Backbone.Tournaments.TournamentScore GetScoreByPartyId(long partyId)

Parameters

  • partyId: Party id for which we want score record

Returns

Score record or null if it does not exist (or not loaded)

Back To Top
 

GetScoreByUserId(long)

Get phase score record by user id. Note that scores has to be loaded prior using this method otherwise the return value will be NULL. Use LoadTournamentPhaseScores() on backbone client.

public Gimmebreak.Backbone.Tournaments.TournamentScore GetScoreByUserId(long userId)

Parameters

  • userId: User id for which we want score record

Returns

Score record or null if it does not exist (or not loaded)


To Document Top