The current documentation is for 3.x versions of Tournamatch, not 4.x. This is here only for users with 3.x and should not be used for 4.x.



Current Ladders

This table displays all ladders that currently exist. Each column in the table is described below:

The title of the ladder displayed to users.
Indicates whether the ladder Active is enabled or disabled.
The total number of players or teams that are participating on this ladder.
Permits you to Lock or Unlock the given ladder.
Click to edit the ladder and to delete the ladder.

Admin Current Ladder

Create Ladder

Use this section to create a new ladder. Each option is explained in more detail below:

General Ladder Info

Ladder Name
The name displayed to users for this ladder.
The game associated with this ladder. This drop down is populated using the list of games you create in Games. A thumbnail will appear on user pages for this ladder corresponding to the selected game.
Requires Approval
Set this field to No to allow any authenticated user to join this ladder. Set this field to Yes if you want to manually approve who may join. When set to Yes, petitions to join the ladder appear in View Petitions.

{tip} Set requires approval to Yes and use a payment collecting plugin to verify users pay an entree fee before you add them to your ladder.

Ladder Mode
Sets the ladder ranking algorithm that will be used for this ladder. The three ranking modes are described below:
  • Points: Competitors are ranked by points. A fixed set of points are rewarded for wins, losses and ties.
  • Rating: Competitors are ranked by ELO. More ELO is rewarded for defeating higher ranked opponents and more ELO is lost for losing to weaker opponents. Less ELO is rewarded for defeating weaker opponents and less ELO is lost for losing to higher ranked opponents.
  • Rung-Up: A proprietary ranking algorithm that boosts competitors for wins. Competitors are never penalized for losing matches.

{info} Our blog has more information about our ladder ranking modes.

Ladder Mode (extended)
If Points is selected for Ladder Mode, you may enter the points rewarded for a Win, a Loss, and a Tie here.

{tip} Reward points for losses to encourage participation.

Ladder General Information

Match Settings

Select Singles for a player vs player head-to-head ladder, or select Teams for a team vs team head-to-head ladder. If you select Teams, you must also enter a team size in the Team Size field.
Team Size
The number of competitors per team when Teams is selected for Competition.

{info} This value is for display and not strictly enforced by default. If you want to force teams to build their roster before joining this ladder, you should enable Enforce Team Minimum in Team Settings.

Score Reporting
Set to Yes to record the scores of matches when users report the results, and set to No to hide the score input fields when users report match results.

{info} To accommodate games where lower score is best (Golf) or higher score is best (Football), recording score has no effect on the actual result reported. Users will still have to select a win or loss in addition to entering a score.

{tip} Some gaming league hosts use Score Reporting to record best-of-x matches.

Ladder Match settings

Challenge Settings

Direct Challenges
Direct challenges permit users to directly challenge another competitor participating on this ladder. Set to Enabled to permit direct challenges, or Disabled to disable direct challenges.
Blind Challenges
Blind challenges permit users to create a challenge at a given time without directly challenging another opponent. Other competitors on the ladder will see a challenge exist for a specified time; however, the challenger (the person who created the challenge) will not be displayed until the challenge is accepted. Set to Enabled to enable blind challenges, or Disabled to disable blind challenges.

Ladder Challenge Settings


Rules are displayed on the ladder rules page and also to users before joining this ladder. HTML is allowed.
Set to visible for users to find the ladder, or set to hidden to hide the ladder.
Set to Yes to permit challenges (if enabled) and reporting results, or set to No to prevent any more ladder activity.

Ladder Match settings

Edit Ladder

You may edit a ladder at any time; however, certain fields are disabled depending on several factors.

  • If a ladder has no participants, you may edit any field in the ladder.
  • If a ladder has one or more participant, you may edit any field except Ladder Mode, Competition and Team Size.

Delete Ladder

You may delete a ladder that you no longer wish to have record of existing. Deleting a ladder also deletes corresponding match data. If you no longer want the ladder to appear on any pages, you should consider setting the visibility to hidden and active to no instead of deleting the ladder.

Clone Ladder

Use this link to clone the current ladder. A new ladder with an edited title and all other settings identical is created.

Ladder Matches

Report Results

To report a result for a ladder, you should first select the ladder from the drop down provided.

Admin Report Ladder

Confirm Results

Any result a user has reported and not yet confirmed appears in the Confirm Results table. To confirm a result, click the Confirm link. You may click the delete link to clear the reported match.

Admin Confirm Report Ladder

View Petitions

One of the options you may enable when creating a ladder is Requires Approval. Competitors who join a ladder with Requires Approval enabled must be approved by an administrator. This page is where those competitors appear. Click the icon to approve the competitor and add them to the ladder standings list, or click the icon to decline and remove the petition.

{info} If you have Unranked Standings enabled, newly added competitors will appear on the unranked standings, not the default standings.

Admin Ladder Petition

Match Disputes

Any ladder match result that has been disputed between competitors is listed here. You will see who reported the win, and given the option to select a winner.

Admin Ladder Dispute

Lock/Unlock Ladder

Locking a ladder allows you to freeze the current list of competitors for a locked ladder. New players or teams will not be permitted to join the ladder; and, for a teams ladder, a team captain will not be permitted to make roster changes.