Puroresu System Wiki
Advertisement

This wiki has a lot of different tournament bracket templates to create all kind of brackets.
This page explains which templates exist, how they work, and how they can be used.

General infos

There are two types of tournament brackets in use on the Puroresu System Wiki:

  1. Templates using the Lua module TeamBracket.
    This module allows for the creation of many different templates and offers various options.
    Bracket templates using this module are collected in the category Team bracket templates using the Lua module.
     
  2. Templates using static html tables.
    Some specific brackets that cannot be created by the module use a static html table design imitating the look of the module-produced brackets. They are less flexible and have fewer options.
    These type of bracket templates are collected in the category Team bracket templates using static html tables.

Both types use the same general syntax for the possible parameters. However, the static table templates are limited to the options implemented into the given template, while the module-created templates can use all additional module parameters if needed.

Which bracket should I use?

  • For regular team numbers (i.e. 2 / 4 / 8 / 16 / 32 / 64 teams) use the corresponding bracket template.
  • For irregular brackets (anything outside the above), there is either a specific template (3-team & 6-team-bracket), or else one of the n-round brackets can be used. The latter exist for 3, 4, and 5 rounds. These can be used for 5+7, 9-15, and 17-31 teams, respectively.
    For tournaments above 32 teams (which at the time of writing this help page do not exist on this wiki), the 64-team-bracket can be used, using additional module parameters to allow byes.
  • For even more specific cases, like tournaments including games with 3 or 4 teams, there are a few special templates. These are all static table templates and can therefore be found in that category.

How to find a bracket?

All available team brackets are collected in the category Tournament bracket templates.
There are further subcategories for number of teams, number of rounds, or template type.

Show/hide the list of bracket categories.


Bracket types

Module brackets

Most brackets on this wiki use the module mentioned above. It is very flexible and allows for many options, including:

  • Number of rounds
  • Number of teams
  • Custom round titles
  • Byes
  • Display of a 3rd place game
  • Set the alignment of the bracket
  • Set the width of the seed, team, and score fields
  • Line break handling
Show/hide the list of all currenty available templates using the module.

Static brackets

Very specific templates which the module cannot create use a static html table design. They look the same and use the same syntax, but have fewer options than the module-created brackets. However, all static brackets allow for:

  • Custom round titles
  • Alignment of the bracket
  • Width of the seed, team, and score fields (if applicable)
  • Line break handling
Show/hide the list of all currenty available templates using the static tables.


Usage & parameters

Note
For detailed infos about a template's parameters and its predefined settings, always look at that template's documentation.
This section only describes some general pattern in the parameters in use.

Bracket field parameters

Team field parameters

Brackets have generally 3 available fields per team: Seed, team name, and score.
The seed field is usually only drawn if its parameter is defined, while the other two are always shown.
General pattern for all fields is RDn-xxxxm
RD stands for "round".
n stands for the number of the round.
xxxx stands for "seed", "team", or "score", representing the 3 available fields mentioned above.
m stands for the position of the field in the round, always counted from top.
3rd place games:
3rd place game parameters use the designator of the last round, with a "b" attached, e.g. RD3b for a 3-round bracket.
Examples:
RD1-seed1 Seed field of the first team in round 1 (usually only drawn if defined)
RD1-team1 Team name of the first team in round 1
RD1-score1 Score of the first team in round 1
RD3-team8 Team name of the eighth team in round 3, counted from the top of that round
RD2b-team2 Team name of the second team in the 3rd place game in a 2 round bracket

Round titles

Round titles use RDn
Examples:
RD1
RD2
 ...
Custom title for the corresponding round
RD3b Custom title for the 3rd place game in a 3-round bracket
Note that all brackets have default titles that make most sense for the specific type of bracket.
See each template's documentation for details.

Groups

Group names use RDn-groupm
The number of available groups depends on the bracket and the number of rounds.
→ See the example on the 64-team bracket template for all possible groups on the largest bracket available.


Layout parameters

Layout parameters include the alignment of the bracket, line break behavior inside the fields, and width of the fields.
Some more parameters may be available for the brackets using the Lua module, see its full list of parameters below.

Alignment

Brackets are aligned left by default and act as a block element, meaning text outside the bracked does not wrap around it.
Available options are:
center - Centers the bracket on the page.
left/right - Turns the bracket into a floating object where text outside the bracket wraps around it.
The parameters to use these options are align or float. (either of them can be used for all options)
→ See the examples on the 2-team bracket template for a demonstration of the behavior of left / right / center.

Field widths

The 3 available team fields (seed, team name, score) have default widths defined.
These defaults are 25px, 160px and 40px, respectively.
Some larger brackets (4 rounds and up) have a smaller default for the team name field, see the individual template's documentation.
These widths can be changed with parameters if needed. (→ see also the "nowrap" option below, which most of the time makes more sense)
Parameters to use for this are:
seed-width
team-width
score-width
Values can be any valid css unit for module-generated templates.
For the static table template, pixel (px) is the only allowed value and must be entered without the unit (number only).

Line breaks (nowrap)

The parameter nowrap can be used to avoid text inside any field breaking into multiple lines.
This results in the fields taking the width they need for its content.
This makes often sense, especially for smaller brackets (3 rounds or less), however it can also be undesired for some very long team names like groups with many names.
By default, this option is activated on all bracket templates with 3 rounds or less, and not activated for brackets with more than 3 rounds.
The option can be activated by defining the nowrap parameter with y or yes, or deactivated with n or no.


Copy/paste lists

All bracket templates documentations include copy/paste-ready lists with all available field parameters for that template. See the tab "Parameter lists (copy/paste)" in the "Syntax & parameters" section of each template's doc. Most documentations provide more than one of such lists, like with or without seeds or a compact format.
Most commonly used additional parameters are listed in the first tab of that section.
Alternatively, the template {{TeamBracketParamCreate}} can be used to create any kind of parameter lists up to 64 team fields.


All module parameters

Brackets using the Lua module can use additional parameters to the ones documented if needed.
Click here to show/hide the full list of module parameters.
The full module documentation can be found here.
Parameter Description
rounds Number of rounds. Use 1 for a 2 team bracket, 2 for a 4 team bracket, 3 for an 8 team bracket, etc.
maxround Maximum round to display. This parameter should be omitted unless it is less than the default value set by rounds.
seed-width The width of the cells for seeds. Plain numbers are assumed to be in px units (e.g., 25 or 25px 2em for 2em or auto for automatic width sizing)
Default: 25px
team-width The width of the cells for team names. Plain numbers are assumed to be in px units (e.g., 200 for 200px or 15em for 15em or auto for automatic width sizing)
Default: 160px
score-width The width of the cells for scores. Plain numbers are assumed to be in px units (e.g., 25 or 25px 2em for 2em or auto for automatic width sizing)
Default: 40px
compact Set to yes for compact bracket and to disable groups.
seeds Set to no to omit seed cells, and yes to always show seed cells
sets or legs The number of sets/legs in each round of matches (delimit with / for different numbers of sets or legs per round)
nowrap Set to yes to prevent lines from wrapping
byes Set to 1, 2, ... to specify the maximum round number with byes
boldwinner Set to high to automatically bold the seed/team/scores for the team with the highest score, and low for the lowest score
hideomittedscores Set to 1 to hide all omitted score cells. To only omit score cells from the second set or leg onwards, use 2
sepwidth Set to 1 or 2 to override the default separator width
headings Set to no to omit the column headings
RDn The name of round n. Defaults are "Round of m", ..., "Quarterfinals", "Semifinals", and "Finals", where m is the number of teams in the round.
RDn-groupm The name of group m in round n. For each round, every set of four teams is classified as a group.
RDn-seedm The seed of team m in round n. For round 1, this value defaults to the conventional seed allocation for tournaments. If omitted, the cell is hidden. To hide seeds for round 1, the value must be explicitly set to be empty. m is the zero-padded position.
RDn-teamm The name of team m in round n.
RDn-scorem The score of team m in round n.
RDn-scorem-s The score of team m in round n and set s (or leg for multileg matches). Alternatively, the last score in the round can be specified using the -agg suffix.
RD1-omit Selectively omit teams from the first round. For example, use 1 / 2 / 5 / 6 to omit team1, team2, team5, and team6 from the first round.
RD-shade Background color for the RDn headings
RDn-shadem-s Background coloring for team m in round n and set s (or leg for multileg matches).
RDn-RDn+1-path Set to 0 to omit the path between round n and round n+1.
float or align Float the bracket to the left or right or center or centre of the page.
clear Set to no to prevent "clearing" the left/right side of the page before floating to the left/right. This parameter is only valid with |float|left or |float|right.
aggregate Set to sets or legs to sum the sets/legs won and append to the end of the scores. Set to score to sum the scores from each set/leg and append to the end of the scores. Set to y or yes to enable the -agg suffix, but without any auto computation. Only works when there are two or more legs/sets in the round. Any automatically computed value can be overridden by setting the value manually with the -agg suffix for the score.
Note
The following parameters are not present in the original WP-module. They have been added for this local version.
See the release notes of the module documentation for further details.
path-width This parameter can be used to define the width of the lines connecting the rounds.
There are two of these lines, so the width between rounds is twice that value.
Default is set to 8px (was 5px in the original module). Experimental. Be careful.
class This parameter can be used to add one or several css classes to the table produced by the module.
Note that all tables already have the class tbr added by default.
style This parameter can be used to add custom inline styles to the table.
nocat This parameter can be used to suppress the categorization of pages the module is used on.
By default, pages using this module are categorized into Pages using module TeamBracket.
Define with any value to activate.


Special cases not covered by any bracket

There are specific brackets for many cases, but not for all.
Sometimes, combining more than one bracket may be a solution.
Some examples for this are shown below.

Display 3rd and 5th place game

Module-generated brackets can display the 3rd place game with parameters, but not the 5th.
There are several solutions for this, depending on the size of the main bracket.

Version 1

If the main bracket is not too wide (3 rounds or less and with short team names), an additional 2-team (1-round) bracket could be placed beside it.
This can be done by using align = left on both bracket templates. Then, in the second bracket, the option for the 3rd game can be used for the 5th game.
This displays nicely and even works on smaller screens, where the 2nd bracket is just moved below the first one if there is not enough space (change your browser's window size to see this happen).
→ Don't forget to use {{Clear left}} or {{-}} after the 2nd template!
Quarterfinals Semifinals Final
         
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Third place
   
 
 
Fifth place
 
 
Code:
{{8TeamBracket
|align  = left
}}
{{2TeamBracket
| align = left
| RD1   = Third place
| RD1b  = Fifth place
}}
{{Clear left}}



Version 2

If the main bracket is too wide to place another one beside, other templates could also be placed below.
To make it fit perfectly with the bracket above, some extra css has to be applied to the first lower bracket.
This will of course only align that perfect if the field widths are default and nowrap is not set to "yes".
Quarterfinals Semifinals Final
         
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Third place
   
 
 
Fifth place
   
 
 
Code:
{{8TeamBracket
| nowrap = no
}}
{{2TeamBracket
| align  = left
| style  = margin-left: 1em; margin-right: 8px;
| RD1    = Third place
}}
{{2TeamBracket
| align  = left
| RD1    = Fifth place
}}
{{Clear left}}



Version 3

A third option is wrapping everything into a div with a defined max-width of the first bracket.
Then use the 3rd place option in the first template, and add a 2-team bracket below.
The second bracket needs to float right and have its margin corrected to align with the one above.
Quarterfinals Semifinals Final
         
 
 
 
 
 
 
 
 
 
 
  Third place
 
   
   
Fifth place
   
 
 
Code:
<div style="max-width: fit-content;">
{{8TeamBracket
| RD3b = Third place
}}
{{2TeamBracket
| align = right
| style = margin-right:2em;
| RD1   = Fifth place
}}
</div>{{-}}


See also

Advertisement